query_role_list

通过 API 方式查询智能体角色列表。

接口信息

URL	https://api.xxx.com/agent/roles/query
请求方式	POST
权限说明	查询角色列表

请求参数

Header

字段名称	类型	必选	说明
Authorization	string	是	Bearer ${accessToken} 获取方式参考获取授权页面

Body

字段名称	类型	是否必选	说明
requestId	String	必选	每次请求唯一标识。建议使用 UUID
appId	String	必选	应用唯一标识
botId	String	必选	设备唯一标识

请求示例

{
  "requestId": "1",
  "appId": "1",
  "botId": "1"
}

响应结果

参数说明

字段名称	类型	是否必选	说明
requestId	String	必选	每次请求唯一标识。建议使用 UUID
state	string	是	返回状态。取值： SUCCESS 成功; FAILURE 失败
code	string	是	返回码
msg	String	必选	状态描述
data	List	必选	角色列表

Role

字段名称	类型	是否必选	说明
code	String	必选	角色编号
name	String	必选	角色名称

响应示例

{
  "requestId": "1",
  "botId": "1",
  "data": [
    {
      "name": "小犀",
      "code": "1"
    }
  ],
  "state": "SUCCESS",
  "code": "0000"
}