更新状态

概述

更新状态工具可让智能体在对话进行期间设置一个或多个动态变量。与其他系统工具一样，它只会更改对话内部状态，绝不会调用外部 API 或客户端函数。

可在通话过程中记录信息，例如标记对话是否应升级、存储用户提供的值，或计算基于其他动态变量得出的值。

如果要在工作流的固定节点应用状态更新，而不是在 LLM 调用工具时更新，请使用更新状态节点。它支持相同的状态更新。

功能

• 每次调用可更新多个变量：单次工具调用最多可同时为 50 个动态变量赋值。
• 基于表达式的值：每个值都是表达式的结果，表达式可组合常量、现有动态变量、LLM 从对话中提取的值和运算符。
• 仅在需要时由 LLM 提取：工具只会让 LLM 为需要提取参数的更新提取参数。完全由常量和/或现有动态变量构成的更新不会向函数调用添加任何参数。
• 立即可用：工具运行后，更新后的动态变量可供对话其余部分使用，后续提示词、其他工具调用和覆盖设置都能像引用其他动态变量一样引用它们。

工作原理

每项状态更新都会将表达式结果赋给一个动态变量：

variable_name = expression

表达式可为以下类型之一，也可相互嵌套以构建更复杂的逻辑：

例如，如果 LLM 判断用户感到沮丧，或 retry_count 动态变量已大于 3，以下状态更新会将 should_escalate 设为 true：

should_escalate = (llm: "User sounds frustrated with the conversation") OR (retry_count > 3)

配置

使用场景

• 升级标记：设置供下游系统或业务规则检查的动态变量（例如 should_escalate），如 Genesys 集成指南所示。
• 记录提取的信息：将用户提供的值（订单号、偏好设置、选择的部门）存为动态变量，供后续对话使用。
• 派生值：根据其他动态变量计算值，例如递增计数器，或将两个变量合并为一个。

用途：让智能体根据对话更新一个或多个动态变量，无需调用外部 API。

触发条件：LLM 应在以下情况调用此工具：

• 对话提供了应记录的信息（例如升级标记、选定选项、用户提供的值）
• 已配置的状态更新依赖于 LLM 必须从对话中判断或提取的值

参数：

函数参数取决于工具的配置。每项使用 LLM 提取值的已配置状态更新，都会在架构中添加一个属性；该属性以此更新的动态变量命名，类型为 string、number 或 boolean。仅由常量或其他动态变量构建的状态更新不会添加任何参数。

函数调用格式：

{
  "type": "function",
  "function": {
    "name": "update_state",
    "arguments": "{\"should_escalate\": true}"
  }
}

实现方式：智能体会使用提取出的参数和当前对话动态变量评估每个已配置表达式，然后将结果赋值给对应的动态变量。不会发出外部请求。

常见问题