查询自定义角色列表

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

本文介绍查询自定义角色列表的 API。

接口描述

根据设备 ID，查询 AI 智能体自定义角色列表。

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	path	true	设备 ID
page_no	Integer	query	true	页码
page_size	Integer	query	true	每页返回的条数

返回参数

参数名	类型	说明
use_timbre_id	String	使用的音色 ID
role_introduce	String	角色介绍
last_text_answer	String	最后一次文本回答
use_llm_name	String	使用的 LLM 名称
role_name	String	角色名称
use_lang_code	String	使用的语言 Code
role_id	String	角色 ID
role_desc	String	角色描述
template_id	String	模板 ID
in_bind	Boolean	是否绑定
role_img_url	String	角色图片 URL
use_lang_name	String	使用的语言名称
use_timbre_name	String	使用的音色名称

请求示例

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

{
  "device_id": "6c3585ebfe301b40a8u***",
  "page_no": 1,
  "page_size": 10
}

返回示例

{
    "result": {
        "list": [
            {
                "use_timbre_id": "clone_45701***",
                "role_introduce": "一只活泼的***",
                "last_text_answer": "***",
                "use_llm_name": "1.5 Pro ***",
                "role_name": "测试1***",
                "use_lang_code": "zh",
                "role_id": "165600***",
                "role_desc": "备注",
                "template_id": "94300***",
                "in_bind": true,
                "role_img_url": "https://images.tuyacn.com/smart/***/1748412117d6db500f***.jpeg",
                "use_lang_name": "中文",
                "use_timbre_name": "我的音色"
            }
        ],
        "total": 2
    },
    "t": 1753693705434,
    "success": true
}

错误码

参考错误码。