跳到主要内容

创建 Agent

创建一个新的 AI Agent，用于对话与任务执行。您最多可创建 100 个 AI Agent。

请求方法​

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

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

请求参数​

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

参数类型必传说明
agentIdString是Agent 唯一标识，长度 3–64 个字符。
nameString是Agent 名称，长度 2–128 个字符。
descriptionString否Agent 描述，长度 ≤ 256 个字符。
typeString否Agent 类型，当前仅支持 chat，默认 chat。
statusString否Agent 状态，可选：active、inactive、draft。
agentConfigObject是Agent 配置对象，详见下方说明。

模型配置​

参数类型必传说明
model.providerString否模型提供商。
model.nameString是模型名称。
model.optionsObject否模型选项配置。

模型选项​

参数类型必传说明
model.options.temperatureDouble否随机性控制，范围 0.0–2.0。
model.options.topPDouble否核采样，范围 0.0–1.0。
model.options.maxTokensInt否最大输出 tokens，范围 1–8192。
model.options.frequencyPenaltyDouble否频率惩罚，范围 -2.0–2.0。
model.options.presencePenaltyDouble否存在惩罚，范围 -2.0–2.0。
model.options.stopString[]否停止词列表，最多 10 个，每个 ≤ 50 字符。

提示词配置​

参数类型必传说明
prompt.idString否系统指令模版 ID，长度 0–64 字符。
prompt.variablesMap<String, String>否系统指令模版变量，用于替换模版中的占位符。
prompt.instructionsString否系统指令，长度 ≤ 10000 字符。当填写了系统指令模版 ID（prompt.id）时，该项可不填。

记忆配置​

参数类型必传说明
memory.strategyString否记忆策略，可选：
  • sliding_window：消息数量限制 - 维护对话历史，但确保总消息数不超过设定的最大值。
  • token_window：令牌限制 - 维护对话历史，但确保总令牌数不超过设定的最大值。
memory.maxMessagesInt否最大记忆消息数，范围 1–150。当 strategy=sliding_window 时建议填写。
memory.maxTokensInt否最大记忆令牌数，范围 > 0。当 strategy=token_window 时建议填写。

请求示例​

HTTP
POST /v3/agent/create.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": "智能客服助手",
  "description": "专业的客服 AI 助手，能够处理各种客户咨询",
  "type": "chat",
  "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
    }
  }
}

返回结果​

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

返回示例​

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

{"code":200}

错误码​

详见 错误码说明。

最后于 更新