Microsoft Copilot Studio Agent 詳細目錄

Copilot Studio Agent 詳細目錄讓 IT 與資安管理員能集中檢視在租用戶中使用 Copilot Studio 或 Agent 建立器建立的所有 Agent。此詳細目錄涵蓋未發佈 (草稿) 及已發佈的 Agent。對於每個 Agent，詳細目錄會顯示其關鍵中繼資料，例如建立 Agent 者、上次發佈時間、部署到哪些管道、如何驗證使用者、其功能等。詳細目錄資料會自動重新整理，對 Agent 的變更通常會在 20 分鐘內反映出來。

管理員可以透過多種方式使用詳細目錄資料，包括 Power Platform 系統管理中心、Power Platform API 及 Azure Resource Graph。如需完整的存取方式清單及所需角色，請參閱 Power Platform 詳細目錄。

本文說明 Power Platform 詳細目錄中 Copilot Studio Agent (microsoft.copilotstudio/agents) 特有的欄位。如需所有資源類型的共用欄位，請參閱 Power Platform 詳細目錄結構描述參考。

注意

這個詳細目錄不包含使用 Copilot Studio V1 (也稱為傳統機器人或 Power Virtual Agents) 建立的 Agent。不過，您仍然可以移至 Power Platform 系統管理中心，並選擇管理>Copilot Studio>傳統聊天機器人 以查看這些 Agent。

重要

本文包含 Microsoft Copilot Studio 預覽版文件，內容可能有所變更。

預覽功能不供生產時使用，而且可能功能受限。這些功能是在正式發行前先行推出，讓您能夠搶先體驗並提供意見反應。

如果您要建置生產就緒 Agent，請參閱 Microsoft Copilot Studio 概觀。

Agent 屬性

詳細目錄會為每個 Agent 列出以下屬性。

注意

此詳細目錄會反映每個 Agent 的已發佈版本結構。如果 Agent 有未發佈的變更 (較新的草稿)，詳細目錄在發佈 Agent 之前都不會顯示這些變更。
Agent 的組態會影響哪些欄位會填入。根據 Agent 的設定方式，部分屬性可能會是 null。例如，對於由 Agent 建立器建立的 Agent，isManaged 是 null。

核心屬性

API 欄位路徑	資料類型	Description	範例	執行狀態
`properties.displayName`	字串	Agent 的顯示名稱。	`Customer support agent`	正式發行
`properties.name`	GUID	Agent 在特定 Dataverse 環境中的識別碼 (CDS 機器人識別碼)。	`aaaa0000-bb11-2222-33cc-444444dddddd`	正式發行
`properties.createdAt`	Datetime	Agent 的建立日期和時間。	`2024-12-13T04:00:00Z`	正式發行
`properties.createdBy`	GUID	建立 Agent 之使用者的 Entra ID。	`aaaa0000-bb11-2222-33cc-444444dddddd`	正式發行
`properties.ownerId`	字串	Agent 目前擁有者的物件識別碼 (Entra ID)。	`aaaa0000-bb11-2222-33cc-444444dddddd`	正式發行
`properties.environmentId`	字串	包含資源的 Power Platform 環境識別碼。	`aaaa0000-bb11-2222-33cc-444444dddddd`	正式發行
`properties.lastPublishedAt`	Datetime	上次發佈 Agent 的日期與時間。如果 Agent 處於草稿狀態，則為空白/null。	`2026-01-15T10:30:00Z`	正式發行
`properties.createdIn`	字串	建立 Agent 的製作工具：Copilot Studio 或 Microsoft 365 Copilot Agent 建立器。	`Copilot Studio`	正式發行
`properties.schemaName`	字串	Dataverse 結構描述名稱。適用於 Copilot Studio Agent、Microsoft 365 Copilot Agent 建立器 Agent。	`cr5e3_agentName`	正式發行
`properties.isQuarantined`	布林值	Agent 目前是否處於隔離狀態。	`false`	預覽版
`properties.quarantinedAt`	Datetime	上次隔離 Agent 的日期與時間。	`2026-02-01T08:00:00Z`	預覽版
`properties.isManaged`	布林值	Agent 是否為受控 Dataverse 解決方案的一部分。在 Agent Builder 中建立的 Agent 為 Null。	`false`	預覽版

Entra 識別屬性

API 欄位路徑	資料類型	Description	範例	執行狀態
`properties.botId`	字串	環境中的 CDS 機器人識別碼。	`aaaa0000-bb11-2222-33cc-444444dddddd`	正式發行
`properties.entraAppId`	字串	與 Agent 關聯的 Entra 應用程式註冊識別碼 (若存在)。	`aaaa0000-bb11-2222-33cc-444444dddddd`	正式發行
`properties.entraAgentId`	字串	Entra Agent 身分識別碼(若存在)。	`aaaa0000-bb11-2222-33cc-444444dddddd`	正式發行
`properties.entraAgentBlueprintId`	字串	Entra Agent 藍圖識別碼 (如有)。	`aaaa0000-bb11-2222-33cc-444444dddddd`	正式發行

注意

並非所有身分識別屬性都適用於所有 Agent 類型：entraAppId 是舊版識別碼，較新的 Agent 則使用 entraAgentId 和 entraAgentBlueprintId。這些欄位僅在適用於特定 Agent 時才會填入。這些身分識別屬性都不適用於 Microsoft 365 Copilot Agent 建立器 Agent。

如需深入了解 Entra 身分識別概念，請參閱 Copilot Studio 的應用程式註冊、Agent 身分識別與驗證。

設定屬性

API 欄位路徑	資料類型	Description	範例	執行狀態
`properties.orchestration`	字串	Agent 的流程協調模式 (如需詳細資訊，請參閱流程協調模式)。	`Generative`	預覽版
`properties.model`	字串	Agent 所使用的 AI 模型。	`gpt-4o`	預覽版
`properties.authentication`	字串	為 Agent 設定的驗證模式 (如需詳細資訊，請參閱驗證模式)。	`Microsoft Entra`	預覽版
`properties.channels`	陣列	將 Agent 發佈所至管道的顯示名稱。	`["Teams","SharePoint"]`	預覽版
`properties.sharedWithViewers`	object	Agent 已共用的個別檢視者使用者 (`userCount`) 與檢視者群組 (`groupCount`) 計數。若製作者將 Agent 與整個租用戶共用，`entireTenant`會設為 `true`，即使管理員未核准共用。	`"groupCount": 0, "userCount": 0, "entireTenant": false`	預覽版
`properties.sharedWithEditors`	object	Agent 已共用的個別編輯者使用者 (`userCount`) 及編輯者群組 (`groupCount`) 計數。	`"groupCount": 0, "userCount": 0`	預覽版
`properties.capabilitiesCounts`	object	各類型已設定功能的總相異計數	`"distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0`	預覽版

協調流程模式

properties.orchestration 欄位可接受下列值：

值	Description
傳統	Agent 使用透過自訂對話樹的傳統主題式流程協調。
生成式	Agent 使用生成式協調流程，AI 模型會動態選取主題與動作。

驗證模式

properties.authentication 欄位可接受下列值：

值	描述
否	不需要驗證。
Microsoft Entra	透過 Microsoft Entra ID 進行驗證。
Generic OAuth 2.0	透過通用 OAuth 2.0 提供者進行驗證。

Agent 功能

本區段為 Agent 的功能 (工具與知識) 清單。目前，它僅顯示 Agent 所使用之連接器的詳細資料，以及知識設定，具體內容請參閱以下區段。

詳細目錄對每個 Agent 的每種資源類型有最多 200 項的限制。如需詳細資訊，請參閱已知限制。

詳細目錄會自動移除重複的資源，例如您在同一 Agent 中以相同組態設定兩次的 Power Platform 連接器。

連接器屬性

詳細目錄包含一個名為 powerPlatformConnectors 的陣列，其中包含在 Agent 中設定的 Power Platform 連接器。每個連接器會依其 connectorId (一個包含連接器資源識別碼的字串，例如 shared_excelonlinebusiness) 來識別。每個已設定連接器都有一份已設定 operations 的清單。清單包含下列屬性：

屬性	資料類型	描述	執行狀態
`OperationId`	字串	連接器中的特定作業識別碼，例如，`AddRowV2`	預覽版
`createdBy`	GUID	設定作業的使用者	預覽版
`isEnabled`	布林值	連接器作業目前是否啟用	預覽版
`usedAs`	字串	作業的使用方式： `Tool` 若設定為一般工具 `Topic Tool` 若設定為特定主題中的工具 `Knowledge` 若連接器設定為知識來源	預覽版
`requiresEndUserConsent`	布林值	終端使用者是否必須同意，Agent 才能使用該作業	預覽版
`whenCanBeUsed`	字串	何時可以叫用該作業： `Anytime` 如果該工具對 Agent 的可用性無限制 `ViaDirectReferenceOnly` 如果 Agent 僅在製作者明確於特定主題中設定該工具時才使用該工具 `Conditional` 如果 Agent 能依照製作者預先定義的邏輯使用該工具	預覽版
`connectionProvider`	字串	誰提供該作業所需的連線： `User` 如果終端使用者在執行階段提供認證 `Maker` 如果製作者在製作時設定連線	預覽版
`connectionIdSharedByMaker`	GUID	連線識別碼，僅在 `connectionProvider = Maker` 時填入	預覽版

範例

{
  "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
    }
  }
}

知識屬性

該清單包含以下知識的屬性：

屬性	資料類型	描述	執行狀態
`IsWebSearchEnabledForKnowledge`	布林值	若 Agent 能以 Web 搜尋作為知識來源，則值為 true	預覽版

已知限制

未追蹤 V1 Agent - 詳細目錄不包括透過原始 Power Virtual Agents V1 執行階段建立的 Agent。它僅追蹤 V2 (Copilot Studio) Agent。
身分識別屬性可能無法在所有 Agent 中使用 - entraAgentId 和 entraAgentBlueprintId 欄位僅會針對使用較新 Entra Agent 身分識別模型佈建的 Agent 填入。舊版 Agent 可能只包含 entraAppId，而 Microsoft 365 Copilot Agent 建立器 Agent 則完全不具備這些身分識別屬性。
功能計數 - 詳細目錄對每個 Agent 每種資源類型有最多 200 個的限制。如果某個 Agent 有超過 200 個特定類型的已設定資源 (例如 Power Platform 連接器)，詳細目錄會隨機顯示其中的 200 個。管理員可以使用 capabilitiesCounts欄位來了解每種類型在 Agent 中已設定多少資源。

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-07-30