更新或归档智能体¶

接口用途¶

更新智能体元信息或状态，并用于归档清理。

请求方式¶

PATCH

接口地址¶

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

身份认证¶

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

路径参数¶

名称	说明
`agent_id`	目标智能体标识。

查询参数¶

无。

请求体¶

部分更新；字段均可选。归档时以 status=archived 为主。不要用此接口修改 prompt、工具、知识库等核心配置（应走 Agent Builder revise + commit）。

字段	类型	必填	说明
`name`	string	否	名称
`description`	string	否	描述
`status`	string	否	如 `archived` / `disabled` / `active`
`labels`	object	否	标签
`annotations`	object	否	注解
`metadata`	object	否	元数据
`avatar_ref`	string	否	头像引用
`display_tags`	array	否	展示标签
`category`	string	否	分类

请求示例¶

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

响应说明¶

除 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		更新时间

使用限制¶

不要用此接口修改 prompt、工具、知识库等核心配置；核心配置走智能体构建器的 revise 与 commit。
DELETE /agents/<agent_id> 实测返回 405，删除语义以归档为主。