配置响应超时承接语

当智能体需要较长时间检索资料、调用工具或生成回复时，你可以配置承接词，让 AI 在等待期间先播报一句简短提示，减少等待过程中的静默。承接词支持使用预定义文本，也支持根据当前用户消息和可选的近期对话历史动态生成。

前提条件

开始前，请确保你已参考使用 RESTful API 实现对话式 AI 引擎或使用 Agents SDK 实现对话式 AI 引擎实现基本对话。

选择承接词模式

通过 filler_words.content.mode 选择承接词来源：

static：（默认）从 static_config.phrases 中选择预定义承接词。省略 mode 时保持该行为。
generated：根据当前用户消息和可选的近期对话历史动态生成承接词。生成结果未及时就绪、生成失败或内容无效时，从 static_config.phrases 中选择静态承接词。

信息

generated 模式必须显式设置，且仍需配置 static_config 作为回退。承接词生成服务的模型服务和凭证均由声网托管，客户无需配置额外的模型、端点或凭证。

配置静态承接词

// --- 此处省略智能体的其他配置 ---

agent := agentkit.NewAgent(
	client,
	agentkit.WithFillerWords(&agentkit.FillerWordsConfig{
		Enable: Agora.Bool(true),
		Trigger: &agentkit.FillerWordsTrigger{
			FixedTimeConfig: &agentkit.FillerWordsTriggerFixedTimeConfig{
				ResponseWaitMs: Agora.Int(1500),
			},
		},
		Content: &agentkit.FillerWordsContent{
			Mode: agentkit.FillerWordsContentModeStatic.Ptr(),
			StaticConfig: &agentkit.FillerWordsContentStaticConfig{
				Phrases:       []string{"请稍等。", "我正在为你查询。", "好的。"},
				SelectionRule: agentkit.FillerWordsSelectionRuleShuffle.Ptr(),
			},
		},
	}),
)

Python

# --- 此处省略智能体的其他配置 ---

agent = Agent(client=client).with_filler_words(
    FillerWordsConfig(
        enable=True,
        trigger=FillerWordsTrigger(
            fixed_time_config=FillerWordsTriggerFixedTimeConfig(response_wait_ms=1500),
        ),
        content=FillerWordsContent(
            mode="static",
            static_config=FillerWordsContentStaticConfig(
                phrases=["请稍等。", "我正在为你查询。", "好的。"],
                selection_rule="shuffle",
            ),
        ),
    )
)

TypeScript

// --- 此处省略智能体的其他配置 ---

const agentWithFillerWords = agent.withFillerWords({
  enable: true,
    trigger: {
    fixed_time_config: { response_wait_ms: 1500 },
  },
  content: {
    mode: 'static',
    static_config: {
      phrases: ['请稍等。', '我正在为你查询。', '好的。'],
      selection_rule: 'shuffle',
    },
  },
});

以下配置会在主 LLM 等待时间达到 1500 ms 时，从预定义列表中选择一条承接词：

JSON

{
  "filler_words": {
    "enable": true,
      "trigger": {
      "fixed_time_config": {
        "response_wait_ms": 1500
      }
    },
    "content": {
      "mode": "static",
      "static_config": {
        "phrases": [
          "请稍等。",
          "我正在为你查询。",
          "好的。"
        ],
        "selection_rule": "shuffle"
      }
    }
  }
}

参数说明

参数	类型	必选	说明
`FillerWordsConfig.<wbr />Enable`	`*bool`	否	是否启用承接词。设置为 `true` 时必须配置 `Content.StaticConfig`。默认值：`false`。
`FillerWordsTriggerFixedTimeConfig.<wbr />ResponseWaitMs`	`*int`	否	LLM 响应等待阈值，单位为毫秒。取值范围为 `100` 到 `10000`。默认值：`1500`。
`FillerWordsContent.<wbr />Mode`	`*FillerWordsContent<wbr />Mode`	否	承接词内容模式。静态模式使用 `FillerWordsContentModeStatic`。
`FillerWordsContentStaticConfig.<wbr />Phrases`	`[]string`	是	静态承接词列表，支持 1 到 100 个非空字符串；每个短语最多 20 个单词（拉丁文字）或 20 个字符（中文及其他非拉丁文字）。
`FillerWordsContentStaticConfig.<wbr />SelectionRule`	`*FillerWordsContent<wbr />SelectionRule`	否	承接词选择规则。支持 `shuffle` 和 `round_robin`。默认值：`shuffle`。

参数	类型	必选	说明
`enable`	`bool`	否	是否启用承接词。设置为 `True` 时必须配置 `content.static_config`。默认值：`False`。
`trigger.fixed_time_config.response_wait_ms`	`int`	否	LLM 响应等待阈值，单位为毫秒。取值范围为 `100` 到 `10000`。默认值：`1500`。
`content.mode`	`str`	否	承接词内容模式。静态模式设置为 `static`，也可以省略。
`content.static_config.phrases`	`List[str]`	是	静态承接词列表，支持 1 到 100 个非空字符串；每个短语最多 20 个单词（拉丁文字）或 20 个字符（中文及其他非拉丁文字）。
`content.static_config.selection_rule`	`str`	否	承接词选择规则。支持 `shuffle` 和 `round_robin`。默认值：`shuffle`。

参数	类型	必选	说明
`enable`	`boolean`	否	是否启用承接词。设置为 `true` 时必须配置 `content.static_config`。默认值：`false`。
`trigger.fixed_time_config.response_wait_ms`	`number`	否	LLM 响应等待阈值，单位为毫秒。取值范围为 `100` 到 `10000`。默认值：`1500`。
`content.mode`	`string`	否	承接词内容模式。静态模式设置为 `static`，也可以省略。
`content.static_config.phrases`	`string[]`	是	静态承接词列表，支持 1 到 100 个非空字符串；每个短语最多 20 个单词（拉丁文字）或 20 个字符（中文及其他非拉丁文字）。
`content.static_config.selection_rule`	`string`	否	承接词选择规则。支持 `shuffle` 和 `round_robin`。默认值：`shuffle`。

参数	类型	必选	说明
`enable`	Boolean	否	是否启用承接词。设置为 `true` 时必须配置 `content.static_config`。默认值：`false`。
`trigger.fixed_time_config.response_wait_ms`	Integer	否	LLM 响应等待阈值，单位为毫秒。取值范围为 `100` 到 `10000`。默认值：`1500`。
`content.mode`	String	否	承接词内容模式。设置为 `static` 或省略时，使用静态承接词。默认值：`static`。
`content.static_config`	Object	是	静态承接词配置。启用承接词时必须配置。
`content.static_config.phrases`	Array of String	是	静态承接词列表，支持 1 到 100 个非空字符串；每个短语最多 20 个单词（拉丁文字）或 20 个字符（中文及其他非拉丁文字）。
`content.static_config.selection_rule`	String	否	承接词选择规则。支持 `shuffle` 和 `round_robin`。默认值：`shuffle`。

配置动态承接词

// --- 此处省略智能体的其他配置 ---

agent := agentkit.NewAgent(
	client,
	agentkit.WithFillerWords(&agentkit.FillerWordsConfig{
		Enable: Agora.Bool(true),
		Content: &agentkit.FillerWordsContent{
			Mode: agentkit.FillerWordsContentModeGenerated.Ptr(),
			StaticConfig: &agentkit.FillerWordsContentStaticConfig{
				Phrases: []string{"请稍等。", "我正在处理。"},
			},
			GeneratedConfig: &agentkit.FillerWordsContentGeneratedConfig{
				Prompt:                Agora.String("根据当前对话生成一句简短、自然的承接词，不要直接回答用户问题。"),
				ContextMessageLimit:   Agora.Int(4),
				HistoryCharacterLimit: Agora.Int(1000),
			},
		},
	}),
)

Go 示例未显式设置 Trigger，使用默认的 fixed_time/1500 ms。

Python

# --- 此处省略智能体的其他配置 ---

generated = FillerWordsConfig(
    enable=True,
    trigger=FillerWordsTrigger(
        fixed_time_config=FillerWordsTriggerFixedTimeConfig(response_wait_ms=1500),
    ),
    content=FillerWordsContent(
        mode="generated",
        static_config=FillerWordsContentStaticConfig(
            phrases=["请稍等。", "我正在处理。"],
        ),
        generated_config=FillerWordsContentGeneratedConfig(
            prompt="根据当前对话生成一句简短、自然的承接词，不要直接回答用户问题。",
            context_message_limit=4,
            history_character_limit=1000,
        ),
    ),
)
agent = Agent(client=client).with_filler_words(generated)

TypeScript

// --- 此处省略智能体的其他配置 ---

const agentWithGeneratedFillerWords = agent.withFillerWords({
  enable: true,
  trigger: {
    fixed_time_config: { response_wait_ms: 1500 },
  },
  content: {
    mode: 'generated',
    static_config: {
      phrases: ['请稍等。', '我正在处理。'],
      selection_rule: 'shuffle',
    },
    generated_config: {
      prompt: '根据当前对话生成一句简短、自然的承接词，不要直接回答用户问题。',
      context_message_limit: 4,
      history_character_limit: 1000,
    },
  },
});

将 content.mode 设为 generated，并保留静态回退内容：

JSON

{
  "filler_words": {
    "enable": true,
    "trigger": {
      "fixed_time_config": {
        "response_wait_ms": 1500
      }
    },
    "content": {
      "mode": "generated",
      "static_config": {
        "phrases": [
          "请稍等。",
          "我正在处理。"
        ],
        "selection_rule": "shuffle"
      },
      "generated_config": {
        "prompt": "根据当前对话生成一句简短、自然的承接词。不要直接回答问题或声称任务已经完成，只返回承接词文本。",
        "context_message_limit": 4,
        "history_character_limit": 1000
      }
    }
  }
}

参数说明

以下字段名使用相对于 FillerWordsConfig 的路径。

字段	类型	必选	说明
`Enable`	`*bool`	否	是否启用承接词。设置为 `true` 时必须配置静态回退短语。默认值：`false`。
`Trigger.FixedTimeConfig.ResponseWaitMs`	`*int`	否	LLM 响应等待阈值，单位为毫秒。取值范围为 `100` 到 `10000`。默认值：`1500`。
`Content.Mode`	`*FillerWordsContentMode`	是	承接词内容模式。动态模式使用 `generated`。
`Content.StaticConfig.Phrases`	`[]string`	是	动态承接词不可用时使用的静态回退短语列表。
`Content.GeneratedConfig.Prompt`	`string`	否	生成承接词的 Prompt。设置后将完整替换默认 Prompt，并对相同的对话上下文窗口生效。
`Content.GeneratedConfig.ContextMessageLimit`	`*int`	否	包含当前用户消息。取值范围：`1` 到 `6`。默认值：`1`；设置为 `2` 到 `6` 时启用近期历史。
`Content.GeneratedConfig.HistoryCharacterLimit`	`*int`	否	仅限制历史消息文本长度。取值范围：`0` 到 `10000`。默认值：`1000`；设置为 `0` 表示不限制历史文本长度。

参数	类型	必选	说明
`enable`	`bool`	否	是否启用承接词。设置为 `True` 时必须配置静态回退短语。默认值：`False`。
`trigger.fixed_time_config.response_wait_ms`	`int`	否	LLM 响应等待阈值，单位为毫秒。取值范围为 `100` 到 `10000`。默认值：`1500`。
`content.mode`	`str`	是	设置为 `generated`，启用动态承接词。
`content.static_config.phrases`	`List[str]`	是	动态承接词不可用时使用的静态回退短语列表。
`content.generated_config.prompt`	`str`	否	生成承接词的 Prompt。设置后将完整替换默认 Prompt，并对相同的对话上下文窗口生效。
`content.generated_config.context_message_limit`	`int`	否	包含当前用户消息。取值范围：`1` 到 `6`。默认值：`1`；设置为 `2` 到 `6` 时启用近期历史。
`content.generated_config.history_character_limit`	`int`	否	仅限制历史消息文本长度。取值范围：`0` 到 `10000`。默认值：`1000`；设置为 `0` 表示不限制历史文本长度。

参数	类型	必选	说明
`enable`	`boolean`	否	是否启用承接词。设置为 `true` 时必须配置静态回退短语。默认值：`false`。
`trigger.fixed_time_config.response_wait_ms`	`number`	否	LLM 响应等待阈值，单位为毫秒。取值范围为 `100` 到 `10000`。默认值：`1500`。
`content.mode`	`string`	是	设置为 `generated`，启用动态承接词。
`content.static_config.phrases`	`string[]`	是	动态承接词不可用时使用的静态回退短语列表。
`content.generated_config.prompt`	`string`	否	生成承接词的 Prompt。设置后将完整替换默认 Prompt，并对相同的对话上下文窗口生效。
`content.generated_config.context_message_limit`	`number`	否	包含当前用户消息。取值范围：`1` 到 `6`。默认值：`1`；设置为 `2` 到 `6` 时启用近期历史。
`content.generated_config.history_character_limit`	`number`	否	仅限制历史消息文本长度。取值范围：`0` 到 `10000`。默认值：`1000`；设置为 `0` 表示不限制历史文本长度。

参数	类型	必选	说明
`enable`	Boolean	否	是否启用承接词。设置为 `true` 时必须配置静态回退短语。默认值：`false`。
`trigger.fixed_time_config.response_wait_ms`	Integer	否	LLM 响应等待阈值，单位为毫秒。取值范围为 `100` 到 `10000`。默认值：`1500`。
`content.mode`	String	是	设置为 `generated`，启用动态承接词。
`content.static_config`	Object	是	静态回退配置。动态承接词不可用时，从该配置中选择静态承接词。
`content.static_config.phrases`	Array of String	是	静态回退短语列表，支持 1 到 100 个非空字符串。
`content.generated_config`	Object	否	动态承接词配置。省略时使用默认 Prompt。
`content.generated_config.prompt`	String	否	生成承接词的 Prompt。设置后将完整替换默认 Prompt，并对相同的对话上下文窗口生效。
`content.generated_config.context_message_limit`	Integer	否	包含当前用户消息。取值范围：`1` 到 `6`。默认值：`1`，仅使用当前用户消息；设置为 `2` 到 `6` 时启用近期对话历史。
`content.generated_config.history_character_limit`	Integer	否	仅限制历史消息文本长度。取值范围：`0` 到 `10000`。默认值：`1000`；设置为 `0` 表示不限制历史消息文本字符数，但仍受服务输入容量限制。

配置动态承接词的对话上下文

context_message_limit 和 history_character_limit 共同限定动态承接词可使用的对话历史：

context_message_limit 控制发送的对话消息数，包含当前用户消息。取值范围为 1 到 6，默认值为 1；设置为 2 到 6 后才会使用近期的用户和智能体消息。
history_character_limit 控制历史消息文本长度。取值范围为 0 到 10000，默认值为 1000；设置为 0 表示不限制历史文本长度。
超出限制时优先移除较早的历史消息，不会截断当前用户消息；动态承接词无法生成时，使用静态承接词回退。

信息

将 context_message_limit 设置为大于 1 的值后，动态承接词生成服务会使用近期对话历史，输入文本量也可能增加，生成内容也可能不准确或复述历史内容。省略该字段或将其设置为 1 时，不会发送历史消息。

前提条件

选择承接词模式

配置静态承接词

参数说明

配置动态承接词

参数说明

配置动态承接词的对话上下文

咨询电话

咨询电话

前提条件Copy Anchor Link

选择承接词模式Copy Anchor Link

配置静态承接词Copy Anchor Link

参数说明Copy Anchor Link

配置动态承接词Copy Anchor Link

参数说明Copy Anchor Link

配置动态承接词的对话上下文Copy Anchor Link

咨询电话

咨询电话

前提条件

选择承接词模式

配置静态承接词

参数说明

配置动态承接词

参数说明

配置动态承接词的对话上下文