Skip to main content
PUT
更新会话变量

授权

Authorization
string
header
必填

每个请求都通过 API Key 认证:Authorization: Bearer {API_KEY}。应用接口使用应用 API Key,知识库接口使用知识库 API Key(快速开始)。

API Key 应保存在服务端,切勿嵌入客户端代码。缺失或无效的 Key 会返回 HTTP 401(unauthorized)。

路径参数

conversation_id
string<uuid>
必填

该变量所属的会话 ID。会话 ID 可从 获取会话列表 获取。

variable_id
string<uuid>
必填

要更新的变量 ID。变量 ID 可从 获取会话变量 获取。

请求体

application/json
user
string
必填

终端用户标识,由你的应用定义,需在应用内唯一。必须与创建该会话时使用的 user 一致。参见 终端用户身份。

Required string length: 1 - 255
value
any
必填

新的值:null、字符串、数字、布尔值、对象或数组,需与变量声明的类型一致。

响应

更新后的变量。

id
string

会话变量 ID。

name
string

变量名称。

value_type
string

声明的类型:string、number、boolean、secret、object、file、none,或数组类型,例如 array[string]、array[number]、array[object]、array[file]、array[boolean]、array[any]。

value
string | null

String variables come back as-is; other types come back as a canonical JSON string; none comes back as null.

description
string | null

变量描述。

created_at
integer

创建时间,Unix 时间戳(秒)。

updated_at
integer

最后更新时间,Unix 时间戳(秒)。