mcpField
O
omni-agents-a2a

omni-agents-a2a

github.com/diegosouzapwエージェントワークフロー82.6k905 回インストール今日更新
リポジトリ

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プロバイダーのクォータと稼働状況の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/diegosouzapw/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 対応