# 传递自定义信息 (/zh-CN/ai/build/shape-the-conversation/custom-information)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

与智能体对话时，你可能需要从端侧获取用户的说话状态、选中的文字、个性签名、得分等自定义上下文信息，并将这些信息传递给智能体，引导智能体输出更符合用户需求的内容。

本文介绍如何结合 RTM SDK 提供的能力，实现与智能体对话时携带自定义信息。

## 技术原理 [#技术原理]

[声网实时消息 RTM SDK](/zh-CN/realtime-media/rtm/reference/downloads) 支持为频道中的用户设置自定义的临时状态信息，并以事件通知的方式通知频道中其他的在线用户。如果你的 App 同时集成了声网实时互动 RTC 和实时消息 RTM 服务，就可以在创建智能体时开启 RTM 功能，让智能体在调用大模型前，从 RTM 频道中获取临时状态信息，并将其作为上下文信息传递给大模型，引导智能体输出更符合用户需求的内容。

## 前提条件 [#前提条件]

开始前，请确保你已经：

- 已参考[实现对话式智能体](/zh-CN/ai/get-started/quick-start)实现了与 AI 智能体对话互动的基本逻辑。
- 已参考[实现收发消息](/zh-CN/realtime-media/rtm/get-started/quick-start)为你的 App 集成 RTM SDK，并实现基本的收发消息功能。

## 实现方式 [#实现方式]

### 启用 RTM [#启用-rtm]

通过 Agents SDK 创建会话或调用 [POST 创建对话式智能体](/zh-CN/api-reference/api-ref/conversational-ai/join)时，将 `advanced_features.enable_rtm` 配置设置为 `true` 即可启用 RTM。启用后，智能体会在调用大模型前读取说话用户的临时状态，并将这些状态写入请求中的 `context.presence` 字段。

:::info[信息]
- 声网推荐启动 RTM 时开启 String UID（`enable_string_uid` 配置为 `true`），并参考 [FAQ](/zh-CN/reference/faq/integration/rtc_rtm_token) 生成同时具备 RTC 和 RTM 权限的 Token，之后传入 `agent_rtc_uid` 字段即可。
- 同一频道内，Int 型和 String 型的用户 ID 不可混用。更多使用 String UID 的相关信息请参考[如何使用 String 型用户 ID](/zh-CN/reference/faq/integration/string_uid)。
:::

```go tab="Go SDK" tabGroup="agent-sdk-language"
// ... 其他智能体配置 ...
.WithAdvancedFeatures(&agentkit.AdvancedFeatures{
    EnableRtm: Agora.Bool(true),
})
// ... 继续调用 .CreateSession() ...
```

```typescript tab="TypeScript SDK" tabGroup="agent-sdk-language"
// ... 其他智能体配置 ...
.withAdvancedFeatures({ enable_rtm: true })
// ... 继续调用 .createSession() ...
```

```python tab="Python SDK" tabGroup="agent-sdk-language"
# ... 其他智能体配置 ...
.with_advanced_features({'enable_rtm': True})
# ... 继续调用 .create_session() ...
```

```bash tab="REST API" tabGroup="agent-sdk-language"
curl --request POST \
  --url https://api.agora.io/cn/api/conversational-ai-agent/v2/projects/<your_app_id>/join \
  --header 'Authorization: agora token="007abcxxxxxxx123"' \
  --data '
{
  "name": "unique_name",
  "properties": {
    "channel": "channel_name",
    "token": "token",
    "agent_rtc_uid": "friday",
    "advanced_features": {
      "enable_rtm": true
    },
    "remote_rtc_uids": [
      "*"
    ],
    "enable_string_uid": true,
    "llm": {
      "url": "https://api.xxxx/v1/xxxx",
      "api_key": "xxx",
      "vendor": "custom",
      "params": {
        "model": "xxxx"
      }
    },
    "tts": {
      "vendor": "vendor_name",
      "params": {
        "key": "xxxx",
        "voice_id": "xxxx"
      }
    }
  }
}
'
```

### 设置自定义信息 [#设置自定义信息]

参考[临时用户状态](/zh-CN/realtime-media/rtm/build/state-and-attributes/temporary-user-state)文档，为频道中的用户设置临时状态信息。

### 传递自定义信息 [#传递自定义信息]

智能体在调用大模型前，会自动获取说话用户的临时状态信息，并将其作为上下文信息传递给大模型。该临时状态信息会被设置到 `context.presence` 字段中。

以下示例的场景为用户 UserA 在 App 中选中了文字“勾股定理”，并向智能体提问“这是什么意思？”。示例 JSON 展示了智能体在调用大模型时，从 RTM 获取了 UserA 的一个名为 `selection` 的临时状态信息，请求的数据结构如下：

```json
{
  "messages": [
    {
      "role": "user",
      "content": "这是什么意思"
    }
  ],
  "context": {
    "presence": {
      "userA": {
        "selection": "勾股定理"
      }
    }
  },
  "model": "deepseek-r1"
}
```

### 适配大模型 [#适配大模型]

启用 RTM 后，智能体只负责把临时状态传递给大模型；大模型是否使用这些信息，取决于你的自定义大模型服务如何处理 `context.presence` 字段。请参考[自定义大模型](/zh-CN/ai/build/custom-model-integration/custom-llm)适配请求解析逻辑，并在提示词或业务逻辑中明确使用所需的临时状态字段。