跳转到主要内容
开始创作
开发文档

智能体列表

分页查询当前应用下的智能体与模板(通过 isTemplate 区分)。支持按 isTemplate、status、名称、userId 筛选。

分页查询当前应用下的智能体与模板(通过 isTemplate 区分)。支持按 isTemplate、status、名称、userId 筛选。

POST /openapi/v1/agents/list

不传 isTemplate 与 status 时,默认仅返回已启用的实例(isTemplate=false, status=1),与历史行为一致。传入 userId 时仅返回关联该用户的智能体实例。

请求参数

参数

类型

请求示例

{
  "page": 1,
  "pageSize": 20,
  "isTemplate": false,
  "status": 1,
  "userId": 10001
}

响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "list": [
      {
        "agentId": 10,
        "name": "默认助手模板",
        "description": "通用对话模板",
        "headImg": "https://...",
        "isTemplate": true,
        "templateId": 0,
        "status": 1,
        "ttsVoiceId": "voice_001",
        "skillIds": [1, 2],
        "quickReplyIds": [],
        "temperature": 0.3,
        "speed": 1.0,
        "vol": 1.0,
        "pitch": 0,
        "asrLanguage": "zh-CN",
        "outputFilterRegex": "\\*[^*]+\\*",
        "persistentSkillIds": [1],
        "createdAt": "2024-01-01 08:00:00+08",
        "updatedAt": "2024-01-01 08:00:00+08"
      }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 20
  }
}