查询智能体列表
更新时间: 2025/09/04 11:01:41
分页获取当前应用的智能体(Agent)列表。
请求信息
请求 URI
GET https://rtc-agent.yunxinapi.com/v1/agent
请求头参数
请求 Header 的参数说明请参考 请求结构。
请求查询参数
| 参数名称 | 类型 | 是否必选 | 示例 | 说明 |
|---|---|---|---|---|
| page | Integer | 是 | 1 | 第几页,从 1 开始 |
| pageSize | Integer | 是 | 10 | 页大小,取值范围为 1~100,默认为 10 |
响应信息
响应参数
| 参数名称 | 类型 | 说明 | 是否必返回 |
|---|---|---|---|
| code | Integer | 响应状态码 | 是 |
| message | String | 响应描述信息 | 是 |
| requestId | String | 请求 ID | 是 |
| - data | Object | 响应数据 | 是 |
| page | Integer | 当前页码 | 是 |
| pageSize | Integer | 页大小 | 是 |
| total | Integer | 总数据量 | 是 |
| - agents | Array | 智能体列表 | 是 |
| agentId | String | Agent 标识符 | 是 |
| agentName | String | Agent 名称 | 是 |
| llmPromptContent | String | LLM 提示词内容 | 是 |
| llmConfig | Object | LLM 配置信息,具体请参考创建智能体的说明 | 是 |
| ttsConfig | Object | TTS 音色相关配置,具体请参考创建智能体的说明 | 是 |
| asrConfig | Object | ASR 相关配置,具体请参考创建智能体的说明 | 是 |
| agentConfigProperties | Object | Pipeline 设置等配置,具体请参考创建智能体的说明 | 是 |
| createdAt | Long | 创建时间,单位为毫秒的时间戳 | 是 |
| updatedAt | Long | 修改时间,单位为毫秒的时间戳 | 是 |
| status | Integer | 状态,0 表示启用,1 表示禁用 | 是 |
响应体示例
JSON{
"code": 200,
"message": "操作成功",
"requestId": "ai81fd312777ed4c009bb6763016fc5e0c",
"data": {
"page": 1,
"pageSize": 10,
"total": 25,
"agents": [
{
"agentId": "e656489ffb474379b3bad65a4202abea",
"agentName": "沖沖测试",
"llmPromptContent": "你是一个活泼可爱的吉祥物,名字叫沖沖,代表着网易数智。你的形象灵动俏皮,有着圆滚滚的身体和大大的眼睛,身体主色调是网易数智标志性的色彩,象征着活力与创新。",
"llmConfig": {},
"ttsConfig": {},
"asrConfig": {},
"agentConfigProperties": {},
"createdAt": 1756361185000,
"updatedAt": 1756361185000,
"status": 0
},
{
"agentId": "3cb16a1a0f774b299eaa921007064891",
"agentName": "小精灵",
"llmPromptContent": "你是一只名叫小知的精灵,擅长各种知识,能解答儿童的问题。你会用通俗易懂的语言,耐心分步回答,每次不超过 100 字。",
"llmConfig": {},
"ttsConfig": {},
"asrConfig": {},
"agentConfigProperties": {},
"createdAt": 1756361185000,
"updatedAt": 1756361185000,
"status": 0
}
]
}
}
错误码
本文仅列举部分业务接口错误码,完整列表请参考 错误码。
| 错误码 | 说明 | 处理建议 |
|---|---|---|
| 400 | 请求参数错误 | 检查请求参数是否正确 |
| 401 | 身份认证失败 | 检查认证信息是否正确 |
| 403 | 权限不足 | 检查是否有相应的操作权限 |
| 404 | 资源不存在 | 检查请求的资源是否存在 |
| 500 | 服务器内部错误 | 稍后重试或欢迎 提交工单 联系网易云信技术支持工程师 |
此文档是否对你有帮助?





