次の方法で共有

agentInstance リソースの種類

名前空間: microsoft.graph

重要

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

Microsoft Entra エージェント レジストリ内の AI エージェントの特定のデプロイされたインスタンスを表します。 エージェント インスタンスは、その機能、スキル、メタデータを定義する agentCardManifest に関連付けられます。 エージェント インスタンスはコレクションに編成でき、 agentRegistry を使用して管理できます。

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

メソッド

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