跳到主要内容

更新 Agent

本接口用于更新指定 Agent 的信息和配置。采用增量更新方式，仅更新传入的字段，未提供的字段保持不变。

提示

更新时请注意：

  1. 建议先调用获取指定 Agent接口获取当前配置。
  2. 基于当前配置按需修改字段。
  3. 仅传入需要更新的字段，避免不必要的修改。

请求方法​

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

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

请求参数​

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

参数类型必传说明
agentIdString是Agent 唯一标识，长度 3–64 个字符。
nameString否Agent 名称，长度 2–128 个字符。
descriptionString否Agent 描述，长度 ≤ 256 个字符。
statusString否Agent 状态：
- active：活跃
- inactive：非活跃
- draft：草稿
agentConfigObject否Agent 配置对象，详见 Agent 数据模型。
支持增量更新以下配置：
- model.options.*：模型选项
- prompt.*：提示词配置
- memory.*：记忆配置

请求示例​

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

{
  "agentId": "customer_service_v1",
  "name": "智能客服助手 v2",
  "description": "升级版的客服 AI 助手",
  "agentConfig": {
    "model": {
      "options": {
        "temperature": 0.8
      }
    },
    "prompt": {
      "instructions": "你是一个专业的高级客服助手"
    }
  }
}

返回结果​

参数类型说明
codeInt返回码，200 表示处理成功。

返回结果示例​

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

{"code":200}

错误码​

详见 错误码说明。

最后于 更新