变量管理

变量让智能体在多轮对话中记住关键信息，例如用户偏好、临时表单或插件所需参数。通过合理配置，可以在提示词、插件、工作流之间传递数据。

---

变量类型

• 系统变量：平台自动维护，常见如 user_id、platform、entry_point 等。开启后可直接在提示词或参数中引用。
• 用户变量：开发者自定义字段，用于记录个性化信息或业务上下文，例如 preferred_language、last_order_id 等。

---

创建用户变量

1. 在智能体编排页左侧点击 变量 → + 用户变量。
2. 设置变量名称（仅支持字母、数字、下划线，且以字母开头）、描述与数据类型（文本、数字、布尔等）。
3. 可选配置：
   • 默认值：用户首次对话时自动生效。
   • 持久化：选择保存周期（仅当前会话 / 永久保存）。
   • 多用户模式：在飞书等渠道时自动按用户隔离。

---

引用变量

• 提示词：在人设与回复逻辑中通过 或 {变量名} 注入变量值。
• 插件 / 工作流参数：在参数配置面板选择变量作为输入，避免用户重复输入。
• 消息卡片：绑定变量字段，使卡片展示自定义内容。

使用变量前请确保已经为其赋值；缺失值可能导致插件调用失败。

---

赋值方式

• 对话写入：在提示词中引导模型询问用户，并通过系统解析写入变量。
• 插件 / 工作流结果：在节点输出中选择「写入变量」。
• 外部事件：在触发器或 Webhook 中传入参数后映射到变量。

---

示例：记录用户语言偏好

1. 创建用户变量 preferred_language，默认值为空。
2. 在提示词中添加：

如果用户说明希望使用某种语言，请记录到 {preferred_language}。

3. 在插件参数中引用该变量决定调用哪个翻译模型。
4. 通过调试面板查看变量值，确认写入是否成功。

---

调试与查看

• 在编排页右上角点击 记忆 → 变量 查看当前会话与历史变量值。
• 若需要清除记录，可在同一界面重置或在渠道中发送“清除记忆”等命令。

---