メインコンテンツまでスキップ

A2A ゲートウェイ

Yabanin の A2A ゲートウェイ は、MCP ゲートウェイ に対する、エージェント間の対応物です。組織は、外部の A2A(Agent2Agent プロトコル)エージェントを、組織スコープのレジストリに登録します。組織のエージェントプリンシパル(yag_ キー)は、ゲートウェイ経由でそれらへメッセージを送ります。エージェント専用のアクセス制御、SSRF 防御、送信前のパラメータガード、送信ごとの監査証跡が付きます。デフォルトではオフ です。ルートグループがマウントされるのは、YABANIN_A2A_GATEWAY=1 のときだけです。

v1 の範囲 — 率直な記載​

プロキシが運ぶのは、A2A JSON-RPC の message/send メソッド(リクエスト/レスポンス)です。ストリーミング(message/stream)とプッシュ通知は、v1 ではプロキシされません。後の増分であり、隠された欠落ではありません。ゲートウェイは、クライアントの params(A2A の message オブジェクト)を自ら JSON-RPC エンベロープに包みます。そのため、呼び出し元は任意のメソッドを紛れ込ませられません。

動作​

agent (yag_ key) ──► POST /api/a2a/send {"agent":"helper","params":{...}}
│
├─ auth: agent-principal only (org keys → 403 agent_only)
├─ registry: (org, name) must exist and be enabled
├─ SSRF: per-send re-validation (rebind window)
├─ guard: pre-egress scan of the message params
└─ upstream: JSON-RPC message/send → the agent's URL
result (raw JSON-RPC result) ──► back to the caller

すべての送信は、モデルトラフィックと同じ request_logs の証跡へ監査されます。model_used は a2a:<agent> ラベルを運び、(ガードで伏字化された)params がペイロードに乗り、X-Yabanin-Task タグが送信をタスクへ帰属させます。

レジストリ​

a2a_agents(マイグレーション 0015)— 組織スコープ、https:// のみの URL、UNIQUE (org_id, name)、有効化されるまで不活性。管理 CRUD(root のみ、組織スコープ):

メソッドパス
POST/api/organizations/{id}/a2a/agents
GET/api/organizations/{id}/a2a/agents
GET/api/organizations/{id}/a2a/agents/{name}
PATCH/api/organizations/{id}/a2a/agents/{name}
DELETE/api/organizations/{id}/a2a/agents/{name}

登録時(および URL を更新するたび)に、SSRF ガードが実行されます。条件は、https のみ、URL に資格情報を含めないこと、導入環境のドメイン許可リスト(YABANIN_A2A_ALLOWED_UPSTREAMS、カンマ区切り。空 = 許可されるドメインなし — フェイルクローズ)、予約 IP の応答を拒否する DNS 解決(メタデータエンドポイント、RFC1918、ループバック、リンクローカル、CGNAT)です。ガードは 送信のたび に再実行されます。登録から使用までの DNS リバインドの時間窓は、悪用できません。

ゲートウェイ API​

curl -X POST "$BASE_URL/api/a2a/send" \
-H "Authorization: Bearer yag_..." \
-H "Content-Type: application/json" \
-d '{
"agent": "helper",
"params": {"message": {"messageId": "m-1", "role": "user",
"parts": [{"kind": "text", "text": "status?"}]}}
}'

エラー契約: agent_only(403)、not_found(404 — 存在しない、無効、または他組織のエージェントは区別できません)、ssrf_blocked(400)、denied(409、ガード)、upstream(502)、timeout(504)。

設定​

環境変数デフォルト意味
YABANIN_A2A_GATEWAYfalse/api/a2a/send ルートグループをマウントする
YABANIN_A2A_ALLOWED_UPSTREAMS(空)エージェント URL 向けの SSRF ドメイン許可リスト(空 = フェイルクローズ)

上流呼び出しには上限があります。接続 10 秒、読み取り 30 秒、レスポンス上限 8 MiB、リダイレクトは拒否されます。アイデンティティヘッダー(X-Yabanin-Agent-Id/-Name/-Team-Id)は、検証済みプリンシパルから上流へ乗ります。クライアント側のコピーは、入口で取り除かれます。

MCP ゲートウェイとの比較​

規律は同じです(SSRF、ガード、監査、エージェント専用)。対象が違います。MCP レジストリは ツール を指し、A2A レジストリは エージェント を指します。エージェントごとの付与テーブル(MCP のパターン)は、A2A では計画中の増分です。v1 は、組織レベルで送信を認可します。