A2A Protocol Architecture Guide 是 LiteLLM-RS 中关于 A2A(Agent-to-Agent)协议的架构说明。其用途是让自主智能体通过标准化接口相互通信与协作,并支持多种智能体提供商(LangGraph、Vertex AI Agent Builder、Azure AI Agent Service、Amazon Bedrock Agents、Pydantic AI)。
主要能力包括:
- JSON-RPC 2.0 消息格式,请求结构含 jsonrpc、id、method、params,方法有 TaskSend、TaskGet、TaskCancel、TaskSendSubscribe(SSE 订阅)、AgentCapabilities、Ping;响应含 result 或 error,并定义标准错误码(-32700、-32600、-32601、-32602、-32603)与 A2A 专有错误码(如 TASK_NOT_FOUND、AGENT_NOT_FOUND、AGENT_BUSY、TASK_CANCELLED、CAPABILITY_MISMATCH、RATE_LIMITED)。
- 任务状态机,状态有 Pending、Running、Completed、Failed、Cancelled、InputRequired,规定合法状态转换与终态判定;Task 含 input(instruction、context、artifacts)、output、error、metadata、时间戳。
- 智能体注册表(AgentRegistry),支持注册、注销、查询、按能力查找、在线列表、状态更新与后台健康监控,AgentCard 含 id、name、provider、capabilities、endpoint、status、metadata,并提供端点鉴权方式(Bearer、ApiKey、OAuth2)。
- 提供商适配层,定义 A2AProvider trait(provider_type、send_task、get_task 等)。
使用方式与限制:资料未提供安装命令、配置示例或部署步骤;本文档为架构与类型定义说明,需结合 LiteLLM-RS 项目使用,具体运行方式暂未提供。