Coze 自定义参数教程完整提取

标题

扣子-AI 智能体开发平台 | 变量（自定义参数）

功能概述

该教程介绍"在对话流中添加自定义参数，并在对话中为自定义参数赋值"的方法。

应用场景：在智能体对话中灵活存储关键信息，用于提供个性化服务。常见用途包括设置用户偏好、用户信息、地理位置、订单信息等，智能体据此提供更精准的服务。

核心操作步骤

第一步：在对话流编排页面的"开始节点"输入参数中创建自定义参数，并在输出节点中引用。自定义参数支持 String、Array 等多种数据类型。

第二步：通过多种方式给自定义参数赋值。

赋值方式（6种）

1. WebSocket 语音通话

发送 chat.update 事件，在 chat_config.parameters 中指定参数名称和值（Map[String, Any] 格式）。

示例："user_name":"John"

2. RTC 音视频通话

进入房间后发送"更新房间配置"上行事件，在 data.chat_config.parameters 中指定参数。

3. 发起对话 OpenAPI

调用接口时在 parameters 参数中指定自定义参数的名称和值。

4. 执行对话流 OpenAPI

调用工作流接口时在 parameters 中指定参数。

5. ChatSDK（扣子应用）

在 CozeWebSDK.WebChatClient 配置中的 appInfo.parameters 指定参数。

6. ChatSDK（扣子智能体）

在 botInfo.parameters 中指定参数。

关键限制

所有赋值方式仅支持"发布为 API 的单 Agent（对话流模式）"的智能体。

---

文档URL: https://www.coze.cn/open/docs/tutorial/variable

---

Status: Raw extraction - Needs cleaning and formatting