API インベントリにスキルを登録して検出する

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

API センターにスキルを登録することで、組織に役立つ一元化されたレジストリを作成できます。

• 利用可能なスキルとその機能を発見する
• スキルのソース コードとドキュメントにアクセスする

前提条件

• API センター。 API センターがまだない場合は、API センターの作成に関するクイックスタート を参照してください。
• 登録する 1 つ以上のスキル 。通常は GitHub などのソース コード リポジトリでホストされます。

スキルを登録する

API センターにスキルを登録するには:

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

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

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

   

4. [ スキルの登録 ] フォームで、次の表に情報を入力します。

   フィールド	説明
   タイトル	スキルのわかりやすい名前 (コード レビュー スキルなど) を入力します。
   識別	API Center では、タイトル ( コード レビュー スキルなど) に基づいて識別子が自動的に生成されます。 必要に応じて編集できます。
   まとめ	スキルの機能について簡単な 1 行の説明を入力します (たとえば、 静的分析を使用して自動コード レビューを実行します)。
   説明	スキルの機能、ユース ケース、動作の詳細な説明を入力します。
   ライフサイクル ステージ	ドロップダウン メニューからスキルのライフサイクルの現在のステージを選択します。
   ソース
   ソース URL	スキルのソース コードの Git リポジトリ URL (たとえば、 https://github.com/<org>/<repo>/tree/main/skills/<skill-name>) を入力します。
   互換性	スキルを使用するための要件、依存関係、前提条件について説明する (たとえば、git、docker、プログラミング言語、システム要件、ネットワーク アクセス要件などの必要なソフトウェアまたはツール)。API キーまたは認証要件)。
   許可されているツール	[ + ツールの追加] を選択して、このスキルがアクセスできる API インベントリから API または MCP サーバーを指定します。 このアプローチは、スキルが使用できるリソースを明示的に定義することで、適切なガバナンスとセキュリティを確保するのに役立ちます。
   ライセンス	[+ 追加] を選択して、ライセンス情報を指定します。 ライセンス名 ( MIT、 Apache 2.0、 専用など) を入力し、必要に応じてライセンス URL を指定し、必要に応じて説明を追加してライセンス条項または制限を明確にします。
   連絡先情報	[ + 追加] を選択して、サポートまたは問い合わせの連絡先ポイントを追加します。 連絡先の名前またはロール ( API チーム や John Smith など) を入力し、メール アドレスなどの連絡先の詳細を指定し、必要に応じて説明を追加して、このユーザーまたはチームに連絡するタイミングと理由を明確にします。

5. [ 作成] を選択して、API センターにスキルを登録します。

登録後、インベントリ> ページにスキルがインベントリに表示されます。

登録されているスキルを更新する

スキル情報はいつでも更新できます。

1. API センターで、 Inventory>Assets に移動します。
2. 更新するスキルを見つけて選択します。
3. [ 編集] を 選択してスキルのプロパティを変更します。
4. 変更を加え、[ 保存] を選択します。

Git リポジトリからスキルを同期する

スキルの登録を自動化し、インベントリを最新の状態に保つために、Git リポジトリを 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 によって提供される 既定 の条件をそのまま使用します。 必要に応じて、組織に関連しない既定の条件を削除します。

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

   

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

7. 保存を選びます。

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

関連するコンテンツ

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