エージェント メタデータは、Microsoft Entra Agent Registry 内のエージェント検出の基礎として機能します。 提供するメタデータによって、他のエージェント、アプリケーション、およびユーザーがエージェントを検索して操作する方法が決まります。 メタデータ スキーマとそのコレクション モデルとの関係を理解することで、適切なセキュリティ境界を維持しながら、目的の対象ユーザーがエージェントを確実に検出できます。
エージェント メタデータ スキーマ
エージェント メタデータ スキーマは、エージェントの検出可能性と相互作用に必要な情報構造を定義します。 このスキーマを使用すると、セキュリティを強化するために Microsoft Entra 固有の機能を使用して拡張しながら、標準プロトコルを使用してエージェントをコラボレーションできます。
エージェントの基本情報
基本メタデータには、エージェントの重要な識別情報と連絡先情報が含まれます。
| フィールド | Description |
|---|---|
id |
エージェント マニフェストの一意の識別子です。 すべてのエージェント登録に必要です。 |
displayName |
検出結果に表示される人間が判読できる識別子。 "カスタマー サポート アシスタント" や "請求書処理エージェント" など、エージェントの目的を明確に示す必要があります。 |
description |
エージェントの目的と機能に関する包括的な詳細。 対象ユーザーがこの種類のエージェントを検索するときに自然に使用する関連キーワードを含めると、検出可能性に直接影響します。 |
iconUrl |
検出結果とユーザー インターフェイスで視覚的な識別を提供する、エージェントのアイコン画像への URL。 |
version |
エージェントの実装のバージョン。統合シナリオでのエージェントの更新と互換性に関する考慮事項の追跡を可能にします。 |
documentationUrl |
エージェントのドキュメントの URL。 エージェントの導入を成功させるために、詳細な API ドキュメント、使用例、トラブルシューティング ガイドへのリンクを含めます。 |
protocolVersion |
エージェントでサポートされているプロトコル バージョン。通信中にクライアントやその他のエージェントとの互換性を確保します。 |
provider |
組織名や連絡先 URL など、エージェントを提供する組織に関する情報。 検出中にエージェントのソースを特定し、エージェントの信頼性の検証ポイントを提供するのに役立ちます。 |
managedBy |
このマニフェストを管理し、エージェントのライフサイクルと構成に対する明確な所有権と責任を確立するアプリケーション識別子。 |
originatingStore |
エージェントが発生したストアまたはシステムの名前。レジストリ内のエージェントソースと系列を追跡するのに役立ちます。 |
スキルと機能のメタデータ
エージェントが提供するコア機能と対話機能。
| フィールド | Description |
|---|---|
skills |
エージェントが提供するコア機能。 各スキルには、一意の識別子、わかりやすい名前、スキルが実行する内容を説明する詳細な説明が必要です。 機能ベースの検索での検出可能性を直接決定します。 |
defaultInputModes |
エージェントでサポートされている既定の入力モード。 "text/plain"、"application/json"、"image/png" などの一貫性のある MIME の種類の仕様を使用して、クライアント アプリケーションと適切に一致するようにします。 |
defaultOutputModes |
エージェントでサポートされている既定の出力モード。 エージェントが生成するデータ形式を指定して、エージェントの検出中に自動互換性チェックを有効にします。 |
capabilities |
エージェントが統合プロトコルに対してサポートする技術的な機能。 |
capabilities.extensions |
URI、説明、必要な状態、パラメーターなどのプロパティを含む拡張機能。 フェデレーション シナリオ中に他のエージェントやアプリケーションがエージェントとやり取りする方法に影響します。 |
セキュリティとプロバイダーの情報
検出可能性、信頼、アクセス ポリシーに影響するセキュリティと認証の要件。 セキュリティとプロバイダーの情報は、Microsoft Entra Agent Registry がコレクションの割り当てと検出ポリシーをエージェントに適用する方法に直接影響を与え、これらのフィールドは適切な管理とコンプライアンスのために重要になります。
| フィールド | Description |
|---|---|
securitySchemes |
エージェントがサポートする認証方法を指定する、スキーム名でキー付けされたセキュリティ スキーム定義のディクショナリ。 認証要件を満たすことができるクライアントに対してのみ、エージェントが検出結果に表示されるようにします。 |
security |
さまざまな操作に適用されるセキュリティ スキーム参照の配列。 検出中に互換性のない一致をフィルター処理することで、統合試行の失敗を防ぎ、ユーザー エクスペリエンスを向上させるセキュリティ要件を定義します。 |
signatures |
マニフェストのデジタル署名 (保護されたコンテンツ、署名値、マニフェストの整合性と信頼性を検証するためのヘッダー情報など)。 |
supportsAuthenticatedExtendedCard |
認証された呼び出し元のメタデータをエージェントが提供するかどうかを示します。 基本的な機能が公開されている一方で、詳細な運用情報には認証が必要な情報の段階的な開示を可能にします。 |
ownerIds |
エージェント マニフェストに対する権限を持つ所有者識別子の一覧。 |
コレクションと検出可能性
コレクションは、どのエージェントが互いを検出し、通信チャネルを確立できるかを決定します。 エージェントは、管理者または定義済みの組織ポリシーによってコレクションに明示的に割り当てる必要があります。 メタデータ タグまたはエージェントの特性に基づく自動割り当てはありません。 この明示的な割り当てモデルにより、エージェントの検出可能性と相互作用パターンに対する適切なガバナンスとセキュリティ制御が保証されます。
コレクションの種類、割り当て規則、および検出ポリシーに関する包括的な情報については、「 エージェント レジストリ コレクション」を参照してください。