> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 渠道行为

## 概述

**智能体行为**面板控制智能体的默认个性，以及它在各文本渠道中的回复方式：回复长度、是否使用 Markdown 格式，以及每轮可花费的时间。适合实时小组件聊天的回复，对于 Zendesk 工单通常过于简短；而 Slack 回复可使用 Markdown 格式，SMS 则不适合。

每个渠道都有合理的默认设置，也可以按渠道覆盖单项设置。语音对话不受影响：它们始终使用针对实时通话优化的行为（简洁、纯文本回复和实时轮次预算）。

## 默认个性

默认情况下，智能体的系统提示词会加入几行回复风格说明，使其开箱即用：提供有帮助、信息丰富且礼貌的回复；需要更多信息时提出澄清问题；保持回答清晰简洁；除非被询问，否则避免重复说明智能体身份。

当系统提示词已完整定义智能体语气时，可禁用 **默认个性** 以移除这些说明。在 CLI 和 API 中，将 `conversation_config.agent.prompt.ignore_default_personality` 设为 `true`。

## 文本渠道设置

### 详细程度

控制智能体回复的长度。

* **自动**：让模型选择回复长度。
* **简洁**：用一两句话回复。
* **详细**：用多个段落提供详细回复。

### 输出格式

控制回复是否可以使用 Markdown 格式。

* **纯文本**：发送无格式回复。
* **Markdown**：发送 Markdown 格式回复。仅在支持渲染 Markdown 的渠道中使用，例如 Slack。

### 响应时间

限制智能体单轮可花费的实际时间，包括推理、工具调用和重试。更长的预算让智能体能够完成较长的工具链，但会增加响应延迟。在 CLI 和 API 中，此设置名为 `interaction_budget`。

* **实时**：快速结束轮次，保持实时对话的低延迟。
* **5 分钟**：允许在异步文本渠道中花几分钟进行推理和使用工具。
* **10 分钟**：为较长工具链提供更长的轮次时间。
* **1 小时**：为运行时间最长的任务提供扩展后台处理时间。

## 渠道默认设置

每个渠道都提供针对其特点优化的内置默认设置。例如，Slack 默认使用详细的 Markdown 格式回复和更长的轮次预算，而网页小组件默认使用纯文本回复和实时预算。控制台会显示每个渠道的实际默认设置；未设置的项目将使用该渠道的默认值。

> **Note**
>
> WhatsApp 渠道行为仅适用于文本消息。WhatsApp 通话属于语音对话，使用语音行为。WhatsApp 文本对话默认使用 **实时** 轮次预算——如果智能体在 WhatsApp 上运行较长的工具链或较慢的推理模型，请提高该渠道的 `interaction_budget`。

## 配置

使用 `conversation_config.agent.text_behavior_overrides` 字段配置渠道行为。该字段是从渠道到要覆盖设置的映射。

#### 通过控制台更新

在控制台中打开智能体，选择 **智能体** 选项卡，然后打开 **智能体行为**。展开 **文本渠道** 下的渠道，并调整详细程度、输出格式或响应时间。保存更改。

![包含各渠道文本设置的智能体行为面板](/docs/_fern-img/372e6260e210a832be68a693b003abd63f2ae9b0f9f297d7b7049d1d0c978fec.webp)

#### 通过 CLI 更新

#### 拉取智能体配置

```bash
elevenlabs agents pull --agent agent_7101k5zvyjhmfg983brhmhkd98n6
```

#### 编辑 \`agent_configs/\` 下的智能体配置文件

设置 `conversation_config.agent.text_behavior_overrides`：

```json
{
  "conversation_config": {
    "agent": {
      "text_behavior_overrides": {
        "slack_integration": {
          "verbosity": "concise"
        },
        "widget": {
          "interaction_budget": "5_minutes"
        }
      }
    }
  }
}
```

#### 推送更改

```bash
elevenlabs agents push --agent agent_7101k5zvyjhmfg983brhmhkd98n6
```

#### 通过 API 更新

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "agent": {
            "text_behavior_overrides": {
                "slack_integration": {"verbosity": "concise"},
                "widget": {"interaction_budget": "5_minutes"},
            },
        },
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    agent: {
      textBehaviorOverrides: {
        slack_integration: { verbosity: "concise" },
        widget: { interactionBudget: "5_minutes" },
      },
    },
  },
});
```