次の方法で共有

agentCollection リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

agentRegistry 内のエージェント インスタンスのコレクションを表します。 エージェント コレクションは、管理と組織の目的で関連するエージェント インスタンスを整理およびグループ化する方法を提供します。

エージェント コレクションを使用すると、組織とアクセス制御の目的でエージェント インスタンスをグループ化できます。 特別なコレクションは Global され、 Quarantinedされます。

予約コレクション

テナントごとに常に 2 つのシステム予約コレクションを使用できます。

コレクション ID 用途
グローバル 00000000-0000-0000-0000-000000000001 一般公開エージェントのテナント全体のプール
検疫 00000000-0000-0000-0000-000000000002 ブロックされたエージェント/レビュー保留中のエージェントの保持領域

キーの動作:

  1. Always-present: 予約済み ID による GET では、404 は返されません (永続化されていない場合は合成が返されます)。
  2. 不変性: 予約コレクションを更新または削除することはできません。それ以外の場合は、"collectionImmutable" というメッセージを含む 403 Forbidden エラー コードが返されます。
  3. 作成保護: displayName が予約済みのコレクションと一致する新しいコレクションを作成しようとすると、エラー コード 409 Conflict 返されます。

エンティティ から継承します。

メソッド

メソッド 戻り値の種類 説明
List agentCollection コレクション agentCollection オブジェクトとそのプロパティの一覧を取得します。
Create agentCollection 新しい agentCollection オブジェクトを作成します。
Get agentCollection agentCollection オブジェクトのプロパティとリレーションシップを読み取ります。
Update なし agentCollection オブジェクトのプロパティを更新します。
agentCollection のメンバーを一覧表示する agentInstance コレクション コレクション内の agentInstance オブジェクトの一覧。
コレクションに追加する agentInstance agentCollection に agentInstance を追加します。
コレクションから削除する なし 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)"
}
  • Last updated on