发送访客消息并读取事件流

必须先创建会话;不支持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

参数

位置

类型

必填

说明

webapp

查询

string

是

链接对应的智能体ID。

t

查询

string

是

当前有效发布token;短码链接先resolve,再用短码作为t。

s

查询

string

是

同一发布下的访客session凭据。

jsonrpc

请求体

string

是

固定2.0。

method

请求体

string

是

仅message/stream。

id

请求体

JSON

否

JSON-RPC请求标识。

params.message

请求体

object

是

包含messageId、已创建会话contextId、role=user、非空parts,且含非空文本或附件。

params.idempotencyKey

请求体

string

否

同一逻辑请求重试复用;正文改变应使用新的消息ID/键。

params.model

请求体

string

否

模型选择,仍受智能体和运行配置约束。

params.llm_backend_id

请求体

integer

否

后端选择,实际兼容性待运行验证。

params.metadata

请求体

object

否

元数据与规范附件凭据;不是任意文件授权。

成功响应

响应为 text/event-stream;每个 data: 帧携带 JSON-RPC 结果或错误。按任务状态和终止帧判断结果;

本入口使用字节/事件流响应,按本页及流与文件边界处理。

错误响应

公开错误与身份处理区分链接不可用、停用、session失效、参数和系统故障。

最后更新于