mcpField
O
omni-agents-a2a

omni-agents-a2a

github.com/cheaper-inferenceAgent 工作流82.3k1.0k 次安装今天更新
代码仓库

关于 omni-agents-a2a

omni-agents-a2a 是通过 JSON-RPC 2.0 Agent-to-Agent 协议与 OmniRoute 交互的技能，涵盖路由建议、额度查询、成本估算和健康报告。

主要功能

  1. 01智能选择提供商和模型
  2. 02按能力发现提供商
  3. 03查询额度余额
  4. 04估算请求成本
  5. 05查看系统健康报告

适用场景

  1. 01为提示词选择提供商和模型
  2. 02查找符合能力要求的提供商
  3. 03检查账户额度和请求成本
  4. 04查看系统健康状态与错误

MCP 相关

此技能通过 JSON-RPC 2.0 使用 OmniRoute 的 A2A 接口；输入未说明其提供 MCP 接口。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cheaper-inference/omniroute --skill omni-agents-a2a

安装后在 Claude Code 中输入/omni-agents-a2a确认已加载。

详细介绍

概述

通过 JSON-RPC 2.0 Agent 间协议与 OmniRoute 交互。内置 6 种 A2A 技能：智能路由、配额管理、提供商发现、成本分析、健康报告、列出功能。

身份验证

所有请求都需要有效的 Bearer 令牌或会话 Cookie。通过 POST /api/auth/login 获取令牌，或在本地开发时配置 REQUIRE_API_KEY=false。

端点

此区域尚未映射任何端点。

负载

如需了解详细的请求／响应架构，请参阅完整的 OpenAPI 规范：GET /api/openapi/spec 或 docs/openapi.yaml。

OmniRoute — A2A 协议

需要 OMNIROUTE_URL 和 OMNIROUTE_KEY。设置方法请参阅 入口 SKILL。

OmniRoute 在 /.well-known/agent.json 发布 Agent Card，并在 /a2a 接受 JSON-RPC 2.0 调用。

发现

curl $OMNIROUTE_URL/.well-known/agent.json

返回包含技能、端点和身份验证方案的 Agent Card。

可用技能

技能用途
smart-routing根据提示词推荐最佳提供商／模型组合
quota-management报告指定提供商／账户的配额余额
provider-discovery列出符合能力筛选条件的提供商（视觉、JSON 模式、工具、最大上下文长度）
cost-analysis估算指定请求形式的成本
health-report返回系统健康状况（断路器状态、延迟、错误）

调用示例（JSON-RPC 2.0）

curl -X POST $OMNIROUTE_URL/a2a \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tasks/send",
    "params": {
      "skillId": "smart-routing",
      "input": { "prompt_length": 4000, "tools": true, "vision": false }
    },
    "id": 1
  }'

响应格式

{
  "jsonrpc": "2.0",
  "result": {
    "taskId": "...",
    "status": "completed",
    "output": { "recommended_combo": "...", "reasoning": "..." }
  },
  "id": 1
}

错误

  • -32600 → 请求无效（JSON-RPC 信封格式错误）
  • -32601 → 未找到方法（检查 method 字段）
  • -32602 → 参数无效（根据 Agent Card 检查 skillId）
  • 401 → 缺少或无效的 OMNIROUTE_KEY

参考

完整文档：https://github.com/diegosouzapw/OmniRoute/blob/main/docs/frameworks/A2A-SERVER.md

评论

支持 Markdown