mcpField
O
omni-agents-a2a

omni-agents-a2a

github.com/cheaper-inferenceエージェントワークフロー82.3k1.0k 回インストール今日更新
リポジトリ

omni-agents-a2a について

omni-agents-a2aは、JSON-RPC 2.0のエージェント間プロトコルで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 エージェント間プロトコルを介して OmniRoute とやり取りします。組み込みの A2A スキルが 6 つあります：smart-routing、quota-management、provider-discovery、cost-analysis、health-report、list-capabilities。

認証

すべてのリクエストには、有効な Bearer トークンまたはセッション Cookie が必要です。POST /api/auth/login でトークンを取得するか、ローカル開発用に REQUIRE_API_KEY=false を設定してください。

エンドポイント

このエリアにはまだエンドポイントがマッピングされていません。

ペイロード

リクエスト／レスポンスのスキーマの詳細については、GET /api/openapi/spec または docs/openapi.yaml の OpenAPI 仕様全文を参照してください。

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機能フィルター（vision、JSON mode、tools、max-context）に一致するプロバイダーを一覧表示します
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 → 無効なパラメーター（skillId が Agent Card と一致するか確認してください）
  • 401 → OMNIROUTE_KEY がないか、無効です

リファレンス

ドキュメント全文：https://github.com/diegosouzapw/OmniRoute/blob/main/docs/frameworks/A2A-SERVER.md

コメント

Markdown 対応