输入关键词搜索

查询智能体列表

更新时间: 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 服务器内部错误 稍后重试或欢迎 提交工单 联系网易云信技术支持工程师
此文档是否对你有帮助?
有帮助
去反馈
  • 请求信息
  • 请求 URI
  • 请求头参数
  • 请求查询参数
  • 响应信息
  • 响应参数
  • 响应体示例
  • 错误码