API インベントリにプラグインを登録して検出する

この記事では、Azure API センターを使用して、API インベントリの一部としてプラグインを登録する方法について説明します。 プラグインは、AI エージェントが検出して使用して機能を拡張できる再利用可能な機能です。

API センターでは、API インベントリに既に登録されている 1 つ以上のスキルや MCP サーバーをバンドルしてプラグインを登録します。 プラグインを登録することで、開発者や AI システムによる関連スキルと MCP サーバーの検出と使用を簡略化する、より高度な抽象化を作成できます。

Prerequisites

• API センター。 API センターがまだない場合は、API センターの作成に関するクイックスタート を参照してください。
• プラグインにバンドルする 1 つ以上の 登録済みスキル または 登録済み MCP サーバー 。

API センターにプラグインを登録する

API センターにプラグインを登録するには:

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

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

3. [+ 資産の登録] を選択します>Plugin。

   

4. [ プラグインの登録 ] フォームで、次の表で説明する情報を入力します。

   フィールド	Description
   タイトル	プラグインのわかりやすい名前を入力します。
   識別子	API Center では、タイトルに基づいて識別子が自動的に生成されます。 必要に応じて、この識別子を編集できます。
   まとめ	必要に応じて、プラグインの機能の簡単な概要を入力します。
   説明	必要に応じて、プラグインの機能、ユース ケース、動作の詳細な説明を入力します。
   Version	必要に応じて、プラグインのバージョンを入力します。
   スキル	プラグインにスキルを追加するには、[ + スキルの追加] を選択し、API インベントリに登録されているスキルの一覧から選択します。
   MCP サーバー	プラグインに MCP サーバーを追加するには、[ + MCP サーバーの追加] を選択し、API インベントリに登録されている MCP サーバーの一覧から選択します。

5. [ 作成] を選択して、API センターにプラグインを登録します。

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

API センター ポータルでプラグインを検出する

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

• インベントリ内のプラグインを参照してフィルター処理します。
• 各プラグインに関する詳細情報を表示します。

AI 資産を評価する

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

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

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

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

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

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

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

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

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

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

   

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

7. 保存を選びます。

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

Marketplace エンドポイントを使用してプラグインの検出と使用を構成する

API Center プラグイン マーケットプレース エンドポイント は、API Center データ API を使用して登録済みプラグインのカタログを公開し、開発者による検出と使用を可能にします。 開発者は、GitHub Copilot CLI または Claude Code 開発環境にマーケットプレースを追加して、API センターからプラグインを参照してインストールできます。

関連するコンテンツ

• Git リポジトリから API 資産を同期する
• API インベントリに MCP サーバーを登録して検出する
• API センター ポータルを設定する
• Azure API Center の主要な概念