Microsoft Copilot Studio エージェント インベントリ

Copilot Studio エージェント インベントリにより、IT 管理者とセキュリティ管理者は、テナントで Copilot Studio またはエージェント ビルダーを使用して作成されたすべてのエージェントを一元的に表示できます。 インベントリには、未発行 (ドラフト) エージェントと発行済みエージェントの両方が含まれます。 エージェントごとに、インベントリには、エージェントの作成者、最後に公開された日時、デプロイ先のチャネル、ユーザーの認証方法、その機能など、主要なメタデータが表示されます。 インベントリ データは自動的に更新され、エージェントへの変更は通常 20 分以内に表示されます。

管理者は、Power Platform 管理センター、Power Platform API、Azure Resource Graphなど、複数の方法でインベントリ データを使用できます。 アクセス方法と必要なロールの完全な一覧については、 Power Platform のインベントリを参照してください。

この記事では、Power Platform インベントリの Copilot Studio エージェント (microsoft.copilotstudio/agents) に固有のフィールドについて説明します。 すべてのリソースの種類で使用できる共有フィールドについては、「 Power Platform インベントリ スキーマ リファレンス」を参照してください。

エージェントのプロパティ

インベントリには、エージェントごとに次のプロパティが用意されています。

コア プロパティ

Entra identity のプロパティ

Entra ID の概念の詳細については、「App の登録、エージェント ID、および Copilot Studioを参照してください。

設定プロパティ

オーケストレーション モード

properties.orchestration フィールドには、次の値を指定できます。

認証モード

properties.authentication フィールドには、次の値を指定できます。

エージェント機能

このセクションでは、エージェントの機能 (ツールと知識) の一覧を示します。 現時点では、次のセクションで詳しく説明するように、エージェントによって使用されるコネクタとナレッジ構成に関する詳細なデータのみが表示されます。

インベントリには、エージェントごとに各種類の最大 200 個のリソースの制限があります。 詳細については、「 既知の制限事項」を参照してください。

インベントリは、同じ構成のエージェントで 2 回構成した Power Platform コネクタなど、重複するリソースを自動的に削除します。

コネクタのプロパティ

インベントリには、エージェントで構成された Power Platform コネクタを含む powerPlatformConnectors と呼ばれる配列が含まれています。 各コネクタは、その connectorId (コネクタのリソース ID を含む文字列、たとえば、 shared_excelonlinebusiness) によって識別されます。 構成されたコネクタごとに、構成された operationsの一覧が表示されます。 この一覧には、次のプロパティが含まれています。

例

{
  "type": "microsoft.copilotstudio/agents",
  "properties": {
    "displayName": "Customer Support Agent",
    "createdIn": "Copilot Studio",
    "powerPlatformConnectors": [
      {
        "connectorId": "shared_excelonlinebusiness",
        "operations": [
          {
            "operationId": "RunScriptProd",
            "usedAs": "Tool",
            "isEnabled": true,
            "requiresEndUserConsent": false,
            "whenCanBeUsed": "ViaDirectReferenceOnly",
            "connectionProvider": "Maker",
            "connectionIdSharedByMaker": "11112222-3333-4444-5555-666677778888",
            "createdBy": "52bff06b-5db5-42cd-9919-28f95e3c07af"
          }
        ]
      }
    ],
    "capabilitiesCounts": {
      "distinctPowerPlatformConnectors": 2,
      "distinctPowerPlatformConnectorsOperations": 3
    }
  }
}

知識の属性

このインベントリには、以下のナレッジに関する項目が含まれています:

既知の制限

• V1 エージェントは追跡されません - インベントリには、元の Power Virtual Agents V1 ランタイムで作成されたエージェントは含まれません。 V2 (Copilot Studio) エージェントのみを追跡します。
• ID プロパティは、すべてのエージェントで使用できるわけではありません 。 entraAgentId フィールドと entraAgentBlueprintId フィールドは、新しい Entra エージェント ID モデルでプロビジョニングされたエージェントに対してのみ設定されます。 古いエージェントには entraAppIdのみが含まれる場合があり、Microsoft 365 Copilot エージェント ビルダー エージェントにはこれらの ID プロパティがありません。
• 機能の数 - インベントリには、エージェントごとに各種類の最大 200 個のリソースの制限があります。 エージェントに特定の種類 (Power Platform コネクタなど) から構成されたリソースが 200 を超える場合、インベントリにはランダムな 200 が表示されます。 管理者は、 capabilitiesCounts フィールドを使用して、種類ごとにエージェントで構成されているリソースの数を把握できます。

関連するコンテンツ

• Power Platform インベントリ
• Power Platform インベントリ スキーマ リファレンス
• Power Platform インベントリ API