名前空間: 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 の収束について詳しく説明します。
agentRegistry 内のエージェント インスタンスのコレクションを表します。 エージェント コレクションは、管理および組織の目的で関連するエージェント インスタンスを整理およびグループ化する方法を提供します。
エージェント コレクションを使用すると、組織およびアクセス制御の目的でエージェント インスタンスをグループ化できます。 特別コレクションは Global と Quarantined です。
予約コレクション
テナントごとに 2 つのシステム予約コレクションを常に使用できます。
| コレクション | ID | 用途 |
|---|---|---|
| グローバル | 00000000-0000-0000-0000-000000000001 |
一般的に利用可能なエージェントのテナント全体のプール |
| 検疫済み | 00000000-0000-0000-0000-000000000002 |
ブロックされたエージェント/レビュー保留中のエージェントの保留領域 |
主な動作:
- 常時存在: 予約 ID による GET は 404 を返しません (永続化されていない場合は合成が返されます)。
- 不変性: 予約されたコレクションを更新または削除することはできません。そうしないと、"collectionImmutable" というメッセージを含む
403 Forbiddenエラー コードが返されます。 - 作成保護: displayName が予約済みのコレクションと一致する新しいコレクションを作成しようとすると、エラー コード
409 Conflict返されます。
エンティティ から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | agentCollection コレクション | agentCollection オブジェクトとそのプロパティのリストを取得します。 |
| Create | agentCollection | 新しい agentCollection オブジェクトを作成します。 |
| Get | agentCollection | agentCollection オブジェクトのプロパティと関係を読み取ります。 |
| Update | なし | agentCollection オブジェクトのプロパティを更新します。 |
| agentCollection のメンバーを一覧表示する | agentInstance コレクション | コレクション内の agentInstance オブジェクトのリスト。 |
| コレクションに追加 | agentInstance | agentInstance を agentCollection に追加します。 |
| コレクションから削除 | なし | agentCollection から agentInstance オブジェクトを削除します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| createdBy | String | エージェント インスタンスを作成したユーザーまたはアプリのオブジェクト ID。 |
| createdDateTime | DateTimeOffset | エージェント コレクションが作成されたときのタイムスタンプ。 |
| 説明 | String | コレクションの説明/目的。 |
| displayName | 文字列 | コレクションのフレンドリ名。 |
| id | 文字列 | コレクションの一意の識別子。 キー。 エンティティから継承 されます。 |
| lastModifiedDateTime | DateTimeOffset | 最終更新のタイムスタンプ。 |
| managedBy | 文字列 | このエージェントを管理するサービス プリンシパルの appId (Microsoft Entra 管理センターではアプリケーション (クライアント) ID と呼ばれます)。 |
| originatingStore | 文字列 | コレクションが作成されたソース システム/ストア。 たとえば、Copilot Studio となります。 |
| ownerIds | String collection | エージェント インスタンスの所有者のオブジェクト ID のリスト。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| members | agentInstance コレクション | このコレクションのメンバーであるエージェント インスタンスの一覧。
$expand をサポートします。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.agentCollection",
"id": "String (identifier)",
"ownerIds": [
"String"
],
"managedBy": "String",
"originatingStore": "String",
"createdBy": "String",
"displayName": "String",
"description": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)"
}