名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
重要
エージェント レジストリ API の今後の変更
2026 年 5 月より、Microsoft Graph のエージェント レジストリ API は、Microsoft Agent 365 を搭載したエージェント レジストリ API に置き換えられます。 この変更により、エージェント管理エクスペリエンスが統合され、テナント内のすべてのエージェントの監視、管理、セキュリティ保護が容易になります。 新しい Agent 365 ベースの API がリリースされたら、それらに移行することを計画することをお勧めします。 エージェント レジストリと Microsoft Agent 365 の収束について詳しく説明します。
Microsoft Entra エージェント レジストリにデプロイされた AI エージェントの特定のインスタンスを表します。 エージェント インスタンスは、その機能、スキル、およびメタデータを定義する agentCardManifest に関連付けられます。 エージェント インスタンスはコレクションに編成でき、 agentRegistry を通じて管理されます。
エンティティ から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | agentInstance コレクション | agentInstance オブジェクトとそのプロパティのリストを取得します。 |
| Create | agentInstance | 新しい agentInstance オブジェクトを作成します。 |
| Get | agentInstance | agentInstance オブジェクトのプロパティと関係を読み取ります。 |
| Update | agentInstance | agentInstance オブジェクトのプロパティを更新します。 |
| Delete | なし | agentInstance オブジェクトを削除します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| additionalInterfaces | agentInterface コレクション | エージェントでサポートされる追加のインターフェイス/トランスポート。 |
| agentIdentityBlueprintId | 文字列 | agentIdentityBlueprint オブジェクトのオブジェクト ID。 |
| agentIdentityId | 文字列 | agentIdentity オブジェクトのオブジェクト ID。 |
| agentUserId | 文字列 | エージェントに関連付けられている agentUser のオブジェクト ID。 読み取り専用です。 |
| createdBy | String | エージェント インスタンスを作成したユーザーまたはアプリケーションのオブジェクト ID。 読み取り専用です。 |
| createdDateTime | DateTimeOffset | エージェント インスタンスが作成されたときのタイムスタンプ。 読み取り専用です。 |
| displayName | 文字列 | エージェント インスタンスの表示名。 |
| id | 文字列 | エージェント インスタンスの一意識別子。 キー。 エンティティから継承 されます。 |
| lastModifiedDateTime | DateTimeOffset | 最終変更のタイムスタンプ。 |
| managedBy | 文字列 | このエージェントを管理するアプリケーションの appId (Microsoft Entra 管理センターではアプリケーション (クライアント) ID と呼ばれます)。 |
| originatingStore | 文字列 | エージェントが作成されたストア/システムの名前。 たとえば、Copilot Studio となります。 |
| ownerIds | String collection | エージェント インスタンスの所有者のオブジェクト ID のリスト。 |
| preferredTransport | 文字列 | 優先トランスポート プロトコル。 使用可能な値は JSONRPC、GRPC、および HTTP+JSON。 |
| 署名 | agentCardSignature コレクション | エージェント インスタンスのデジタル署名。 |
| sourceAgentId | 文字列 | 元のソース システム内のエージェントの識別子。 |
| url | String | エージェント インスタンスのエンドポイント URL。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| agentCardManifest | agentCardManifest | エージェント インスタンスのエージェント カード マニフェスト。 |
| コレクション | agentCollection コレクション | エージェント インスタンスがメンバーであるエージェント コレクション。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.agentInstance",
"id": "String (identifier)",
"ownerIds": [
"String"
],
"managedBy": "String",
"originatingStore": "String",
"createdBy": "String",
"displayName": "String",
"sourceAgentId": "String",
"agentIdentityBlueprintId": "String",
"agentIdentityId": "String",
"agentUserId": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"url": "String",
"preferredTransport": "String",
"additionalInterfaces": [
{
"@odata.type": "microsoft.graph.agentInterface"
}
],
"signatures": [
{
"@odata.type": "microsoft.graph.agentCardSignature"
}
]
}