Azure API Center でのエージェントの登録と管理

この記事では、 A2A エージェントを含む AI エージェントを API Center に登録し、ユーザーが検出できるようにして、それらを更新および管理する方法について説明します。

[前提条件]

  • Azure API Center インスタンス
  • JSON 形式のエージェント カードまたは Markdown 形式のエージェント定義によって記述されたエージェント
  • API センターで API を編集するための適切なアクセス許可

エージェントの登録

  1. Azure ポータルにサインインし、API センターに移動します。

  2. サイドバーメニューの[ インベントリ]で[アセット]を選択 します。

  3. + 資産を登録>Agent を選択します。

    ポータルでのエージェントの登録のスクリーンショット。

  4. [ エージェントの登録 ] フォームで、次の表に示す情報を入力します。

    フィールド Description
    タイトル ヘルプ デスク エージェントなど、エージェントのわかりやすい名前を入力します。
    識別 API Center では、 ヘルプ デスク エージェントなどのタイトルに基づいて識別子が自動的に生成されます。 必要に応じて、この識別子を編集できます。
    簡単な概要 API センター ポータルやその他の場所に表示されるエージェントの動作の簡単な 1 行の説明を入力します。
    Description 必要に応じて、スキルの機能、ユース ケース、動作の詳細な説明を入力します。
    Version
    バージョン タイトル v1 など、任意のバージョン タイトルを入力します。
    バージョン ID API Center では、バージョン タイトルに基づいて識別子が自動的に生成されます。 必要に応じて、この識別子を編集できます。
    バージョンのライフサイクル ドロップダウン メニューから、エージェント バージョンのライフサイクルの現在のステージを選択します。 API Center のバージョンの詳細を確認します。
    エージェントの詳細
    エージェント定義 URL を入力するか 、 エージェント定義をアップロードするファイルを選択します。 エージェント定義は Markdown 形式で、エージェントの機能、スキル、およびその他の関連情報に関する詳細を含める必要があります。
    プロトコル 該当する場合は、エージェントがそれに準拠している場合は 、A2A プロトコルを選択します。
    エージェント カード 必要に応じて、URL を入力するか 、ファイルを選択 して JSON 形式で A2A エージェント カードをアップロードします。

    Azure portal の [エージェントの登録] ウィンドウのスクリーンショット。

  5. [ 作成] を選択してエージェントを追加します。

登録後、[インベントリ>] ページのインベントリにエージェントが表示されます。

登録済みエージェントを更新する

エージェント情報はいつでも更新できます。

  1. Azure portal で、API センターに移動します。
  2. サイドバーメニューの[ インベントリ]で[アセット]を選択 します。
  3. テーブルから、[ タイトル ] 列でエージェント名を選択します。
  4. [ 編集 ] ボタンを選択して、作業ウィンドウの [編集] ページを開きます。
  5. 変更を加え、[ 保存] を選択します。

API ソースからエージェントを同期する

エージェントの登録を自動化し、インベントリを最新の状態に保つために、次のアップストリーム ソースを API センターと統合できます。

  • Azure API Management: Azure API Managementで A2A エージェントを管理する場合は、API センターを最新の状態に保つために自動同期を有効にすることができます。 詳細については、「Azure API Management インスタンスから API を同期する」を参照してください。

  • Git リポジトリ: Git リポジトリに格納されている A2A エージェントとその他の AI 資産の場合、API センターを最新の状態に保つために自動同期を有効にすることができます。 詳細については、「 Git リポジトリから API 資産を同期する」を参照してください。

API センター ポータルでエージェントを検出する

API インベントリ内のエージェントを開発者や組織内の他の利害関係者が検出できるように、API センター ポータル を設定します。 ユーザーは、API センター ポータルから次のことができます。

  • インベントリ内のエージェントを閲覧して絞り込みます。
  • 各エージェントに関する詳細情報を表示します。

AI 資産を評価する

API センターでは、API センターに登録されているスキルやエージェントなどの AI 資産の品質を評価できます。 API Center には既定の評価基準が付属し、定義済みのディメンション全体で資産を評価します。 エンタープライズ プラットフォーム管理者は、組織の特定の標準、コンプライアンス要件、ガバナンス ポリシーに合わせて調整されたカスタム評価基準を定義することで、これらの既定値をさらに拡張できます。

インベントリ内の AI 資産の自動評価を有効にするには:

  1. Azure portal で、API センターに移動します。

  2. サイドバー メニューで。 ガバナンス>AI 評価に移動します。

  3. [スキル] タブを選択してスキルの評価を構成するか、[エージェント] タブを選択してエージェントの評価を構成します。

  4. 評価の状態で、[有効] を選択します。

  5. 評価の 説明 を入力します。

  6. [評価条件] で、次のいずれかの操作を行います。

    • API Center によって提供される 既定 の条件をそのまま使用します。 必要に応じて、組織に関連しない既定の条件を削除します。

    次のスクリーンショットは、スキルの既定の条件を示しています。

    ポータルでの AI スキル評価の構成のスクリーンショット。

    • 1 つ以上のカスタム条件を追加します。
      1. [ + 条件の追加] を選択します。
      2. 条件の 名前 とオプションの 評価命令 を入力します。
      3. スコアの [最小スコア] と [最大スコア] の値を入力します (例: 1 と 5)。
      4. その条件で許容される最小スコアを示す 合格しきい値 (例: 3) を入力します。
      5. 評価の合計に対する条件の貢献度を示す 重み 値を入力します (たとえば、重み 0.3 はスコアを 0.3 倍にし、評価全体に 30% を与えます)。
      6. 上記の手順を繰り返して、必要に応じて条件を追加します。

  7. 保存 を選択します。

その後、API センター ポータルで評価結果を表示できます。 たとえば、スキルの詳細ページで各スキルの評価結果を表示します。

API センター ポータルのスキル評価のスクリーンショット。

関連コンテンツ

  • 最終更新: