不推荐直接使用 POST /agents 创建可运行智能体¶

接口用途¶

说明为什么不建议用 POST /agents 创建可运行智能体。

请求方式¶

POST

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agents

身份认证¶

使用工作区 API Key，在请求头中携带 X-API-Key: <WORKSPACE_API_KEY>，并设置 Content-Type: application/json。

路径参数¶

无。

查询参数¶

无。

请求体¶

不建议用此接口创建可运行智能体。若仍调用，最小字段如下；创建结果常为缺少默认 package version 的空壳。

字段	类型	必填	说明
`name`	string	是	名称
`description`	string	否	描述
`status`	string	否	状态

可运行智能体请走 Agent Builder candidate + commit。

请求示例¶

curl -X POST 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agents' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{}'

响应说明¶

除 A2A JSON-RPC 外，多数工作区接口成功响应形如 {"code":0,"data":...}；下列字段描述 data（或 HTTP 202 时的 data）。

可能返回空壳智能体对象：

字段	类型	必填	说明
`id`	string		智能体 ID
`workspace_id`	string		工作区 ID
`name`	string		名称
`description`	string		描述
`status`	string		`active` / `archived` / `disabled` / `draft` 等
`instruction`	object		指令相关；核心配置变更应走 Agent Builder
`runtime`	object		`provider` / `profile` / `config`
`model`	object	string
`binding`	object		工具/技能/知识库绑定摘要
`labels`	object		标签
`metadata`	object		元数据
`version`	integer		版本
`created_at`	string		创建时间
`updated_at`	string		更新时间

缺少可运行 package version，不能当作创建成功。

使用限制¶

可运行智能体应走智能体构建器：查询资源 → 创建候选版本 → 提交。