查询变量列表

更新时间：2026-02-27 10:05:22LLM 副本以 Markdown 格式查看下载 PDF

本文介绍查询变量列表的 API。

接口描述

根据设备 ID，查询智能体变量列表。

接口地址

GET: /v1.0/cloud/agent/ai/b/devices/{device_id}/agent-variables

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	path	true	设备 ID
bind_role_type	Integer	query	false	绑定角色类型 `0`：自定义角色 `1`：模板角色 `2`：单角色（即无角色，数据在智能体维度上) 当 `role_id` 传递时，此值必须传递
role_id	String	query	false	角色 ID

返回参数

参数名	类型	说明
variable_key	String	变量键
variable_value	String	变量值

请求示例

GET: /v1.0/cloud/agent/ai/b/devices/{device_id}/agent-variables

{
  "device_id": "123***"
}

返回示例

{
    "result": [
        {
            "variable_value": "痴迷宇宙星空、研究各类天文知识",
            "variable_key": "sys.memoryInterests"
        },
        {
            "variable_value": "",
            "variable_key": "sys.roleSupplementDesc"
        },
        {
            "variable_value": "你是一名天文学家",
            "variable_key": "sys.roleIntroduce"
        },
        {
            "variable_value": "九十九岁",
            "variable_key": "sys.memoryAge"
        },
        {
            "variable_value": "七月七号",
            "variable_key": "sys.memoryBirthday"
        },
        {
            "variable_value": "用户询问了***",
            "variable_key": "sys.memoryHistoryChatSummary"
        },
        {
            "variable_value": "测试***",
            "variable_key": "sys.roleName"
        },
        {
            "variable_value": "",
            "variable_key": "sys.memoryUserFullName"
        },
        {
            "variable_value": "天文学家",
            "variable_key": "sys.roleRemark"
        },
        {
            "variable_value": "天文学家",
            "variable_key": "custom.roleName"
        },
        {
            "variable_value": "测试**",
            "variable_key": "custom.familyName"
        },
        {
            "variable_value": "张三",
            "variable_key": "custom.userName"
        },
        {
            "variable_value": "12345***",
            "variable_key": "custom.userId"
        }
    ],
    "t": 1753790540058,
    "success": true
}

错误码

参考错误码。