跳到主要内容

创建 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 配置对象，详见下方说明。

基础设置​

参数类型必传说明
conversationStatsEnabledBoolean否是否开启对话统计，默认 false。开启后统计对话轮数和天数，用于 Hooks 条件判断。

模型配置​

参数类型必传说明
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.providerString否记忆存储来源，用于指定对话上下文的获取方式。可选值：
- default：使用系统默认存储获取上下文信息。
- history：从 IM 历史消息中获取上下文信息，用于复用已有对话记录。
memory.strategyString否记忆策略，当前仅支持：
  • sliding_window：消息数量限制 - 维护对话历史，但确保总消息数不超过设定的最大值。
memory.maxMessagesInt否最大记忆消息数，范围 1–150。当 strategy=sliding_window 时建议填写。

Hooks 配置​

参数类型必传说明
hooksArray<Object>否对话前拦截钩子配置，支持意图检测、条件触发等功能。详见 配置 Hooks。

请求示例​

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": {
    "conversationStatsEnabled": true,
    "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
    },
    "hooks": [
      {
        "name": "detectPaymentIntent",
        "phase": "beforeChat",
        "priority": 1,
        "condition": {
          "type": "intentDetection",
          "intents": [
            { "intent": "付费意愿", "confidenceThreshold": 0.8 },
            { "intent": "升级会员", "confidenceThreshold": 0.8 },
            { "intent": "充值", "confidenceThreshold": 0.8 }
          ]
        },
        "actions": [
          {
            "type": "webhook",
            "url": "https://api.customer.com/payment-intent"
          },
          {
            "type": "stopReply"
          }
        ]
      }
    ]
  }
}

返回结果​

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

返回示例​

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

{"code":200}

错误码​

详见 错误码说明。

最后于 更新