A2A エージェント API をインポートする

適用対象: Developer | Basic | Basic v2 | Standard | Standard v2 | Premium | Premium v2

API Management では、 Agent2Agent (A2A) プロトコル仕様と互換性のある AI エージェント API の管理がサポートされています。 A2A プロトコルは、さまざまな AI エージェント システムが共有相互作用モデルを使用して通信および連携できるようにする、オープンなクライアント/サーバー標準です。 API Management での A2A エージェント API のサポートにより、AI モデル API、モデル コンテキスト プロトコル (MCP) ツール、REST、SOAP、GraphQL などの従来の API など、他の API の種類と共にエージェント API を管理および管理できます。

API Management での AI API の管理の詳細については、以下を参照してください。

主な機能

A2A エージェント API をインポートすると、API Management には次の機能があります。

  • JSON-RPC ランタイム操作を A2A バックエンドに仲介します。
    • ポリシーを使用してガバナンスとトラフィック制御を有効にします。
    • Application Insights による可観測性が有効になっている場合は、 OpenTelemetry GenAI セマンティック規則に準拠するために、次の A2A 固有の属性を追加します。
      • genai.agent.id - API 設定で構成されたエージェント ID に設定する
      • genai.agent.name- API 設定で API 名に設定する
  • 次の変換を使用して エージェント カード を公開します。
    • ホスト名を API Management インスタンスのホスト名に置き換えます。
    • 優先トランスポート プロトコルを JSON-RPC に設定します。
    • additionalInterfaces内の他のすべてのインターフェイスを削除します。
    • API Management サブスクリプション キーの要件を含むようにセキュリティ要件を書き換えます。

[前提条件]

ポータルを使用して A2A エージェント API をインポートする

A2A エージェント API を API Management にインポートするには、次の手順に従います。

  1. Azure portal で、API Management インスタンスに移動します。

  2. 左側のメニューの [API] で、[API]>[+ API の追加] を選択します。

  3. [A2A エージェント] タイルを選択します。

    ポータルで [A2A エージェント API] タイルを選択しているスクリーンショット。

  4. [ エージェント カード] に、エージェント カードの JSON ドキュメントを指す URL を 入力します。 [次へ] を選択します。

  5. [ A2A エージェント API の作成 ] ページで、API 設定を構成します。

    1. ランタイム URL とエージェント ID がエージェント カードに基づいて自動的に構成されていない場合は、エージェントに JSON-RPC 操作のランタイム URL と、エージェントによって出力される OpenTelemetry トレースで使用されるエージェント ID (gen_ai.agent.id属性) を指定します。
    2. [ 全般 API 設定] で、API Management インスタンスに任意の 表示名 を入力し、必要に応じて [説明] を入力します。
    3. [ URL] に、API Management インスタンスが A2A エージェント API へのアクセスに使用する ベース パス を入力します。 API Management には、クライアントが JSON-RPC API へのアクセスに使用できる ベース URL と、API Management を介してエージェント カードにアクセスするためのエージェント カード URL が 表示されます。

  6. [ 作成] を選択して API を作成します。

ポータルで A2A エージェント互換 API を作成するスクリーンショット。

A2A エージェント API のポリシーを構成する

A2A エージェント API の管理に役立つ 1 つ以上の API Management ポリシー を構成します。

A2A エージェント API のポリシーを構成するには:

  1. Azure portal で、API Management インスタンスに移動します。
  2. 左側のメニューの [API] で、A2A エージェント API を選択します。
  3. 左側のメニューの A2A で、[ポリシー] を選択 します。
  4. ポリシー エディターで、A2A エージェント API に適用するポリシーを追加または編集します。 ポリシーは XML 形式で定義されます。

注

API Management は、A2A エージェント API スコープのポリシーの前にグローバル (すべての API) スコープで構成されたポリシーを評価します。

サブスクリプション キー認証を構成する

A2A API 設定では、必要に応じて API Management を使用してサブスクリプション キー認証を構成できます。 サブスクリプション キー認証の詳細を確認します。

  1. 前の手順で作成した API を選びます。
  2. [ 設定] ページの [ サブスクリプション] で、 必要なサブスクリプションを選択 (有効) します。

サブスクリプション キー認証を有効にする場合、クライアントは、A2A エージェント API を呼び出すか、エージェント カードにアクセスするときに、 Ocp-Apim-Subscription-Key ヘッダーまたは subscription-key クエリ パラメーターに有効なサブスクリプション キーを含める必要があります。

A2A エージェント API をテストする

A2A エージェント API が期待どおりに動作することを確認するには、API Management を使用してバックエンドを呼び出します。

  1. 前の手順で作成した API を選びます。
  2. [ 概要 ] ページで、 ランタイムのベース URL をコピーします。 API Management を使用して A2A エージェント API を呼び出すには、この URL を使用します。
  3. テスト クライアントを構成するか、 curl などのツールを使用してエージェントに POST 要求を行います。 サブスクリプション キー認証が有効な場合は、有効なサブスクリプション キー ヘッダーまたはクエリ パラメーターを要求に含めます。

ヒント

同様に、A2A エージェント API の GET] ページに表示されるエージェント カード URL に要求を行って、API Management を使用してエージェント カードにアクセスします。

制限事項

  • サポートされているのは、JSON RPC ベースの A2A エージェント API のみです。
  • 送信応答本文の逆シリアル化はサポートされていません。

関連コンテンツ

  • Last updated on