查询角色模板列表

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

本文介绍查询角色模板列表的 API。

接口描述

根据设备 ID，查询 AI 智能体的角色模板列表。

接口地址

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

请求参数

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

返回参数

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

result 说明

参数名	类型	说明
use_llm_id	String	使用的 LLM ID
use_timbre_id	String	使用的音色 ID
role_introduce	String	角色介绍
role_desc	String	角色描述
last_text_answer	String	最新的文本回答
use_llm_name	String	使用的 LLM 名称
role_name	String	角色名称
use_lang_code	String	使用的语言代码
template_id	String	模版 ID
role_img_url	String	角色图片 URL
use_lang_name	String	使用的语言名称
use_timbre_name	String	使用的音色名称
bind_status	Boolean	绑定状态 `true`：已绑定 `false`：未绑定

请求示例

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

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

返回示例

{
    "result": [
        {
            "use_llm_id": "8*",
            "use_timbre_id": "5*",
            "role_introduce": "我是一名***",
            "last_text_answer": "我是***",
            "use_llm_name": "1.5 Pro ***",
            "role_name": "模板***",
            "bind_status": false,
            "use_lang_code": "zh",
            "template_id": "63700***",
            "role_desc": "我是***",
            "role_img_url": "https://images.tuyacn.com/smart/***/17459093538f665740***.png",
            "use_lang_name": "中文",
            "use_timbre_name": "测试***"
        }
    ],
    "t": 1753252060794,
    "success": true
}

错误码

参考错误码。