变量

变量用于存储和检索运行时对话数据。 这样一来，代理就能记住对话轮次中的信息，从而实现更具上下文关联性的互动。

变量数据

变量具有以下数据：

  • 名称：使用蛇形命名法的变量名称
  • 类型：变量类型：
    • 文本：字符串值
    • 数字：数值
    • 是/否：布尔值
    • 自定义对象：您需要为对象提供架构
    • 列表：变量列表。以英文逗号分隔列表的形式提供值。
  • 默认值：变量的默认值
  • 说明：变量的可选说明

指令中的变量引用

如需在指令中按名称引用变量，请使用大括号：{variable_name}。

解析变量

在为模型生成提示时，CX Agent Studio 会将变量引用替换为实际的运行时值。

更新变量值

代理本身无法更新变量的值，但工具和回调可以更新变量值。

代理变量使用 ADK 上下文状态，该状态可用于更新变量。 您可以在 Python 工具代码中使用名为 context 的全局变量。例如，您可以在 Python 工具中使用以下语句，通过 ADK 功能更新变量：

context.state["variable_name"] = value