获取智能体列表

编辑文档更新于 2025-09-21 11:59:40

描述

本接口用于查询智能体列表

接口请求地址

请求方式：GET
传输协议：HTTPS
调用频次限制：50 次/秒
请求 URL：

https://brtc-api.baijiayun.com/vcs/aiagent/v1/list

请求参数

名称	位置	类型	必选	说明
app_id	query	string	是	none
room_id	query	string	否	none
status	query	STRING	是	查询的状态，多个状态用英文逗号分隔，如:RUNNING,STOPPED
limit	query	integer	是	返回结果数量
page	query	string	是	none

请求参数

app_id=string&room_id=string&page=1&limit=10&status=RUNNING,STOPPED

返回参数

返回数据结构

名称	类型	必选	约束	说明
» code	integer	true	none	none
» data	object	true	none	none
»» total	integer	true	none	none
»» list	[object]	true	none	none
»»» id	string	true	none	none
»»» room_id	string	true	none	none
»»» agent_user_id	string	true	none	none
»»» status	string	true	none	none
»»» created_at	string	true	none	none
»»» stopped_at	string	true	none	none
» msg	string	true	none	none

返回示例

200 Response

{
  "code": 200,
  "data": {
    "total": 3,
    "list": [
      {
        "id": "6b828136-287f-48a3-a510-70894dda7b03",
        "room_id": "9981",
        "agent_user_id": "record#123",
        "status": "RUNNING",
        "created_at": "2025-08-13 10:21:38",
        "stopped_at": ""
      },
      {
        "id": "b3b7d7b5-3e02-4279-bc09-d8acf2e3d660",
        "room_id": "9981",
        "agent_user_id": "record#123",
        "status": "STOPPED",
        "created_at": "2025-08-13 10:17:06",
        "stopped_at": ""
      },
      {
        "id": "83fbac4e-f129-404b-8e9c-1bc5dd27b6f8",
        "room_id": "9981",
        "agent_user_id": "record#123",
        "status": "STOPPED",
        "created_at": "2025-08-12 17:55:27",
        "stopped_at": ""
      }
    ]
  },
  "msg": "success"
}