分页查询 Agent

分页查询 Agent 列表。

请求方法

POST： https://数据中心域名/v3/agent/query.json

签名规则： 所有服务端 API 请求均需要进行规则校验，详见 API 请求签名。

正文参数

HTTP 请求正文数据格式为 application/json，支持以下 HTTP 请求参数：

参数	类型	必传	说明
page	Int	否	页码，从 1 开始，默认 1，范围 ≥ 1。
size	Int	否	每页大小，默认 20，范围 1–100。
status	String	否	状态过滤，可选：active、inactive、draft。
type	String	是	类型过滤，当前仅支持 chat。

请求示例

HTTP

POST  /v3/agent/query.json HTTP/1.1
Host: api.rong-api.com
App-Key: e0x9wycfx7flq
Nonce: 1068826355
Timestamp: 1741248603
Signature: 5c6b3f0deb891623b2e8bcef577bc4782a067ea8
Content-Type: application/json

{
  "page": 1,
  "size": 10,
  "status": "active",
  "type": "chat"
}

返回结果

HTTP 响应正文包含具有以下结构的 JSON 对象：

返回值	返回类型	说明
code	Int	返回码，200 表示处理成功。
total	Int	数据总条数。
agents[]	Array<Object>	Agent 列表。 Agent结构详见 :Agent 数据模型

返回结果示例

HTTP

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXX

{
  "code": 200,
  "agents": [
    {
      "agentId": "customer_service_v1",
      "name": "智能客服助手",
      "description": "专业的客服AI助手",
      "type": "chat",
      "status": "active",
      "createdAt": 1677652288000,
      "updatedAt": 1677652288000,
      "agentConfig": {
        "model": {
          "name": "qwen-turbo",
          "options": {
            "temperature": 0.7,
            "topP": 0.9,
            "maxTokens": 2048,
            "frequencyPenalty": 0.1,
            "presencePenalty": 0.1
          }
        },
        "prompt": {
          "instructions": "你是一个专业的客服助手，请耐心、准确地回答用户的问题。"
        },
        "memory": {
          "strategy": "sliding_window",
          "maxMessages": 20
        }
      }
    }
  ],
  "total": 1
}

错误码

详见错误码说明