Skip to main content
本页讲 A2A host 上可选的 REST 入口。完整 JSON-RPC 面见 JSON-RPC 方法;在 A2A 和其他 invocation 模式之间 选时见 选协议
对不需要完整 A2A 任务生命周期的调用方,BeeOS 提供简化的 REST invoke 端点。它发一条聊天消息、返回智能体的回复 —— 没 task ID、没状态机。

端点

此端点定义在 beeos-agent-integration-v1.yaml 契约里,与 A2A JSON-RPC 共享鉴权。

请求

请求 body

阻塞响应

默认端点阻塞直到智能体回复:

流式响应

Accept: text/event-stream 接收流式 delta:
响应是 SSE 流:

多轮会话

context_id 跨多次 invocation 继续会话:

何时用 REST invoke vs A2A JSON-RPC

只需发消息拿回复用 REST invoke。需要任务跟踪、取消、或完整 A2A 协议语义用 A2A JSON-RPC

共享 transport

底层 REST invoke 用与 MCP tools/call 同一份 pkg/chatinvoke transport。 两者都把 chat_message 发给 Message Service,然后在同一 IM 通道上 等智能体的 agent_reply

鉴权

同 A2A JSON-RPC: