OmniRoute 的 A2A（Agent-to-Agent）协议入口，用于让其他智能体或客户端通过标准 JSON-RPC 2.0 调用 OmniRoute 提供的路由与运维能力。
用途 该服务对外发布 Agent Card 于 /.well-known/agent.json，并在 /a2a 端点接受 JSON-RPC 2.0 调用，使调用方可以先发现能力、再按技能发起请求。使用前需要配置环境变量 OMNIROUTE_URL 与 OMNIROUTE_KEY，具体设置参见入口 SKILL 说明。
主要能力 服务端提供 5 项技能：
- smart-routing：给定提示，推荐最佳的服务商/模型组合；
- quota-management：报告指定服务商/账户的配额余额；
- provider-discovery：按能力过滤条件列出匹配的服务商，过滤项包括 vision、JSON mode、tools、max-context；
- cost-analysis：按给定请求形态估算成本；
- health-report：返回系统健康状态，包括熔断状态、延迟与错误。
使用方式 先通过 curl $OMNIROUTE_URL/.well-known/agent.json 获取 Agent Card，其中包含技能、端点与鉴权方案。随后以 POST 请求 $OMNIROUTE_URL/a2a，携带 Authorization: Bearer $OMNIROUTE_KEY 与 Content-Type: application/json，在请求体中指定 jsonrpc 为 2.0、method 为 tasks/send、params 中包含 skillId 与 input，并给出请求 id。示例中 smart-routing 的输入为 prompt_length、tools、vision 等字段。响应包含 taskId、status 与 output（如 recommended_combo、reasoning）。
错误码 -32600 表示无效请求（JSON-RPC 封装错误）；-32601 表示方法不存在；-32602 表示参数无效（需对照 Agent Card 检查 skillId）；401 表示 OMNIROUTE_KEY 缺失或无效。
适用场景 适合需要以智能体互联方式统一调度多家模型服务商的系统，例如在调用前做模型选择推荐、成本与配额评估、能力筛选，以及基于健康报告做路由降级判断。
限制 资料仅说明协议与技能定义，未提供部署步骤、配额数值、成本价格或性能指标；实际可用性取决于 OMNIROUTE_URL 与 OMNIROUTE_KEY 的配置及服务端实现。完整文档参见 https://github.com/diegosouzapw/OmniRoute/blob/main/docs/frameworks/A2A-SERVER.md。