发送访客消息并读取事件流¶
必须先创建会话;不支持message/send、任务控制、provider交互答复或反馈data分支。预准入失败可返回普通公开JSON或JSON-RPC错误;打开SSE后错误在帧中,HTTP200不代表任务完成。持久任务被准入后断流不等于取消,按消息和事件回读。
POST https://api.moi.matrixorigin.cn/v5/public/webapp/a2a
调用前准备¶
BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。
准备同环境链接和访客身份。不填产品PAT或工作区请求头。
请求¶
curl --no-buffer --request POST \
"$BASE_URL/public/webapp/a2a?webapp=$AGENT_ID&t=$WEBAPP_TOKEN&s=$WEBAPP_SESSION" \
--header "Content-Type: application/json" \
--data @- <<JSON
{"jsonrpc": "2.0", "id": "request-example", "method": "message/stream", "params": {"message": {"messageId": "message-example", "contextId": "${CONVERSATION_ID}", "role": "user", "parts": [{"kind": "text", "text": "你好"}]}, "idempotencyKey": "example-turn-key"}}
JSON
参数 |
位置 |
类型 |
必填 |
说明 |
|---|---|---|---|---|
|
查询 |
string |
是 |
链接对应的智能体ID。 |
|
查询 |
string |
是 |
当前有效发布token;短码链接先resolve,再用短码作为t。 |
|
查询 |
string |
是 |
同一发布下的访客session凭据。 |
|
请求体 |
string |
是 |
固定2.0。 |
|
请求体 |
string |
是 |
仅message/stream。 |
|
请求体 |
JSON |
否 |
JSON-RPC请求标识。 |
|
请求体 |
object |
是 |
包含messageId、已创建会话contextId、role=user、非空parts,且含非空文本或附件。 |
|
请求体 |
string |
否 |
同一逻辑请求重试复用;正文改变应使用新的消息ID/键。 |
|
请求体 |
string |
否 |
模型选择,仍受智能体和运行配置约束。 |
|
请求体 |
integer |
否 |
后端选择,实际兼容性待运行验证。 |
|
请求体 |
object |
否 |
元数据与规范附件凭据;不是任意文件授权。 |
成功响应¶
响应为 text/event-stream;每个 data: 帧携带 JSON-RPC 结果或错误。按任务状态和终止帧判断结果;
本入口使用字节/事件流响应,按本页及流与文件边界处理。
错误响应¶
公开错误与身份处理区分链接不可用、停用、session失效、参数和系统故障。