Skip to main content
Agent 管理

复制 Agent

复制已有 Agent，生成新的草稿。

前提

已获取阿里云百炼 API Key 与业务空间 ID，鉴权方式见API 认证。复制 Agent 需要知识库-创建权限，由业务空间成员管理中的角色决定，详见权限要求。

接口

POST /api/v1/indices/rag/app/copy 复制指定 Agent，创建一个新的草稿 Agent。新 Agent 名称自动添加 copy_ 前缀，版本号为 beta，状态为 draft，配置继承自源 Agent。

请求体

字段必填类型说明
agent_id是string源 Agent ID。

请求示例 

curl -X POST "$BASE_URL/api/v1/indices/rag/app/copy" \
  -H "Authorization: Bearer $BAILIAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "aid-8f3a1b2c4d5e6f70"
}'
其中 BASE_URL 为 https://{workspace_id}.cn-beijing.maas.aliyuncs.com（{workspace_id} 为业务空间 ID），BAILIAN_API_KEY 为阿里云百炼 API Key。

响应示例

操作成功返回 200。 
{
  "request_id": "a7b8c9d0-e1f2-3456-abcd-567890123456",
  "status_code": 200,
  "code": "Success",
  "message": "",
  "status": "SUCCESS",
  "success": true,
  "data": {
    "agent_id": "aid-9a0b1c2d3e4f5678",
    "agent_name": "copy_客服知识问答助手 v2",
    "agent_version": "beta",
    "agent_status": "draft"
  }
}

响应字段

字段类型说明
request_idstring请求唯一标识，排查问题时请提供此 ID。
status_codeintegerHTTP 状态码。
codestring响应码，成功时为 Success。
messagestring提示信息。
statusstring请求状态：SUCCESS 或 FAILED。
successboolean请求是否成功。
data.agent_idstring新创建的 Agent ID。
data.agent_namestring新 Agent 名称，自动添加 copy_ 前缀。
data.agent_versionstringAgent 版本号，复制后为 beta。
data.agent_statusstringAgent 状态，复制后为 draft。

错误码

HTTP 状态码错误码说明
400Index.InvalidParameter请求参数不合法，请检查参数是否完整且类型正确。
失败响应示例： 
{
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status_code": 400,
  "code": "Index.InvalidParameter",
  "message": "请求参数不合法，请检查参数是否完整且类型正确。",
  "status": "FAILED",
  "success": false
}
Managed Agents
Sandbox
Security
RAG
应用调用
应用组件
长期记忆
ParseX
框架
Assistant API（下线中）
更多