向智能体发送消息

接口用途

向已有或新建智能体发送消息。该接口使用智能体通信协议（A2A）传递消息和查询任务结果。

请求方式

POST

接口地址

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

身份认证

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

路径参数

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

查询参数

无。

请求体

JSON-RPC 2.0 请求体（非 code/data 包装）。method 使用 message/send（或 message/stream）。

字段	类型	必填	说明
jsonrpc	string	是	固定为 2.0
id	string	number	否
method	string	是	message/send 或 message/stream
params.message	object	是	含 role（通常 user）与 parts[]
params.message.parts[].kind	string	是	如 text / file / data
params.message.parts[].text	string	条件	kind=text 时的文本
params.message.parts[].file	object	条件	kind=file 时可含 uri / mimeType / name
params.message.messageId	string	否	消息 ID
params.message.taskId	string	否	续跑已有任务
params.message.contextId	string	否	会话上下文 ID
params.model	string	否	模型名称，可直接传聊天模型名
params.llm_backend_id	integer	否	指定 LLM backend
params.idempotencyKey	string	否	幂等键
params.configuration	object	否	运行配置
params.metadata	object	否	元数据

部件字段使用 kind，不要使用旧示例中的 type。

请求示例

curl -X POST 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agents/<agent_id>/a2a' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":"1","method":"message/send","params":{"message":{"role":"user","parts":[{"kind":"text","text":"hello"}]},"model":"deepseek-v4-pro"}}'

响应说明

返回 JSON-RPC 响应（非 code/data 包装）：

字段	类型	必填	说明
jsonrpc	string		2.0
id	any		与请求对应
result	object		通常为 Task：含 id、status.state（如 submitted/working/completed/failed）、artifacts 等
error	object		失败时含 code / message / data

调用后可用同一接口的 tasks/get 查询任务结果。

使用限制

• 可在请求中指定模型名称；可用模型见查询可用聊天模型。

• 不要使用泛化入口 POST /newmoi/agents/a2a 搭配工作区 API Key。

相关接口

• 查询智能体任务结果

• 查询可用聊天模型

• 不推荐的泛化智能体通信入口