查询已绑定角色

更新时间：2026-02-26 09:16:10LLM 副本以 Markdown 格式查看下载 PDF

本文介绍查询已绑定角色的 API。

接口描述

根据设备 ID，查询智能体已绑定的角色。

接口地址

GET: /v1.0/cloud/agent/ai/chat/b/devices/{device_id}/role-bindings

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	path	true	设备 ID

返回参数

参数名	类型	说明
result	Object	操作是否成功

result 说明

参数名	类型	说明
use_llm_id	String	使用的 LLM ID
use_timbre_id	String	使用的音色 ID
role_introduce	String	角色介绍
last_text_answer	String	最新的文本回答
speed	String	语速
llm_support_func_tag_list	List	支持的功能标签列表
use_llm_name	String	使用的 LLM 名称
role_name	String	角色名称
use_lang_code	String	使用的语言代码
role_id	String	角色 ID
bind_role_type	Integer	绑定角色类型 `0`：自定义角色 `1`：模板角色 `2`：单角色（即无角色，数据在智能体维度上)
role_desc	String	角色备注
template_id	String	角色关联的模板 ID，只有通过模板创建的自定义角色才可能有此值
role_img_url	String	角色图片 URL
use_lang_name	String	使用的语言名称
use_timbre_name	String	使用的音色名称
workflow	String	使用的工作流类型

请求示例

GET: /v1.0/cloud/agent/ai/chat/b/devices/{device_id}/role-bindings

{
  "device_id": "6c3585ebfe301b40a8u***"
}

返回示例

{
    "result": {
        "use_llm_id": "8*",
        "workflow": "asr-llm-tts",
        "use_timbre_id": "clone_45701***",
        "role_introduce": "一名教师***",
        "last_text_answer": "刚刚介绍*** ",
        "speed": "30.0",
        "llm_support_func_tag_list": [
            "functionCall",
            "text",
            "audio"
        ],
        "use_llm_name": "1.5 Pro ***",
        "role_name": "测试***",
        "use_lang_code": "zh",
        "role_id": "165600***",
        "bind_role_type": 0,
        "role_desc": "备注***",
        "template_id": "94300***",
        "role_img_url": "https://images.tuyacn.com/smart/***/1748412117d6db500f***.jpeg",
        "use_lang_name": "中文",
        "use_timbre_name": "我的音色"
    },
    "t": 1753696939321,
    "success": true
}

错误码

参考错误码。