Microsoft Copilot Studio 代理程式清單

Copilot Studio 代理程式清單為 IT 與資安管理員提供集中檢視所有在租戶中使用 Copilot Studio 或 Agent Builder 建立的代理程式。清單涵蓋未發佈（草稿）和已發佈的代理程式。每個代理的清單會顯示關鍵的元資料，例如誰創建代理、最後發布時間、部署到哪些通路、如何驗證使用者、功能等等。庫存資料會自動重新整理，且對代理程式所做的變更通常會在 20 分鐘內顯示。

管理員可透過多種方式使用庫存資料，包括 Power Platform 管理中心、Power Platform API 及 Azure Resource Graph。欲了解完整的存取方式及所需角色，請參閱 Power Platform 清單。

本文描述 Power Platform 清單中 Copilot Studio 特有的代理欄位microsoft.copilotstudio/agents。關於所有資源類型的共享欄位，請參閱 Power Platform 庫存結構參考。

Note

庫存中不包含使用 Copilot Studio 第一版（也稱為經典機器人或 Power Virtual Agents）所建立的代理人。不過，你仍然可以到 Power Platform 管理中心選擇 Manage>Copilot Studio>Classic chatbots 來查看這些代理。

Important

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

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

如果你正在打造一個準備好上線的代理程式，請參考 Microsoft Copilot Studio 概述。

代理人性質

清單為每位代理人提供以下屬性。

Note

清單反映各代理程式 已發佈版本 的結構。如果代理程式有未發布的變更（較新的草稿），清單在代理程式發布之前不會顯示這些變更。
代理人的配置會影響哪些欄位被填充。有些房產可能會根據經紀人的設定而有所不同 null 。例如，對於在 Agent Builder 中建立的代理程式，isManaged 是 null。

核心屬性

API 欄位路徑	資料類型	Description	Example	狀態
`properties.displayName`	字串	客服專員的顯示名稱。	`Customer support agent`	普遍可用
`properties.name`	GUID	該代理在特定 Dataverse 環境中的 ID（CDS 機器人 ID）。	`aaaa0000-bb11-2222-33cc-444444dddddd`	普遍可用
`properties.createdAt`	日期時間	代理人被創建的日期和時間。	`2024-12-13T04:00:00Z`	普遍可用
`properties.createdBy`	GUID	創建代理的使用者的 Entra ID。	`aaaa0000-bb11-2222-33cc-444444dddddd`	普遍可用
`properties.ownerId`	字串	代理程式目前擁有者的物件 ID（Entra ID）。	`aaaa0000-bb11-2222-33cc-444444dddddd`	普遍可用
`properties.environmentId`	字串	包含該資源的 Power Platform 環境識別碼。	`aaaa0000-bb11-2222-33cc-444444dddddd`	普遍可用
`properties.lastPublishedAt`	日期時間	代理人最後發表的日期和時間。如果代理人仍處於草稿狀態，則為空值／null。	`2026-01-15T10:30:00Z`	普遍可用
`properties.createdIn`	字串	創建代理的創作工具：Microsoft 365 Copilot Studio 或 Microsoft 365 Copilot Agent Builder。	`Copilot Studio`	普遍可用
`properties.schemaName`	字串	Dataverse 架構名稱。適用於 Copilot Studio 代理程式和 Microsoft 365 Copilot Agent Builder 代理程式。	`cr5e3_agentName`	普遍可用
`properties.isQuarantined`	boolean	該代理人目前是否正在隔離。	`false`	Preview
`properties.quarantinedAt`	日期時間	該探員最後一次隔離的日期和時間。	`2026-02-01T08:00:00Z`	Preview
`properties.isManaged`	boolean	代理是否屬於受管型 Dataverse 解決方案。在 Agent Builder 中建立的代理則為 Null。	`false`	Preview

Entra 身分屬性

API 欄位路徑	資料類型	Description	Example	狀態
`properties.botId`	字串	環境中的 CDS 機器人 ID。	`aaaa0000-bb11-2222-33cc-444444dddddd`	普遍可用
`properties.entraAppId`	字串	與代理人關聯的 Entra App 註冊 ID（若存在）。	`aaaa0000-bb11-2222-33cc-444444dddddd`	普遍可用
`properties.entraAgentId`	字串	Entra Agent 識別碼 (若存在)。	`aaaa0000-bb11-2222-33cc-444444dddddd`	普遍可用
`properties.entraAgentBlueprintId`	字串	Entra 代理程式藍圖 ID（若有的話）。	`aaaa0000-bb11-2222-33cc-444444dddddd`	普遍可用

Note

並非所有代理類型都有身份屬性： entraAppId 是舊有識別碼，較新的代理使用 entraAgentId 且 entraAgentBlueprintId。這些欄位僅在適用於特定代理人時才會被填入。這些身份屬性都不適用於 Microsoft 365 Copilot Agent Builder 代理。

在 Copilot Studio 中了解更多關於代理身份與認證的資訊。

設定屬性

API 欄位路徑	資料類型	Description	Example	狀態
`properties.orchestration`	字串	代理的編排模式（詳情請參見編排模式）。	`Generative`	Preview
`properties.model`	字串	代理人使用的 AI 模型。	`gpt-4o`	Preview
`properties.authentication`	字串	為代理程式設定的認證模式（詳情請參見認證模式）。	`Microsoft Entra`	Preview
`properties.channels`	陣列	代理被發佈到的頻道名稱。	`["Teams","SharePoint"]`	Preview
`properties.sharedWithViewers`	物件	與該代理人共享的個別檢視者使用者（`userCount`）與檢視者群組（`groupCount`）數量。如果建立者將代理程式分享給整個租戶，`entireTenant` 會設為 `true`，即使管理員未核准此分享。	`"groupCount": 0, "userCount": 0, "entireTenant": false`	Preview
`properties.sharedWithEditors`	物件	代理共享的個別編輯器使用者數（`userCount`）與編輯器群組（`groupCount`）。	`"groupCount": 0, "userCount": 0`	Preview
`properties.capabilitiesCounts`	物件	各類已設定能力的去重總數	`"distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0`	Preview

編排模式

欄位 properties.orchestration 接受下列值：

價值	Description
Classic	代理程式採用經典的主題導向協調，並搭配自寫對話樹。
生成式	代理程式使用生成式編排，由 AI 模型動態選擇主題和工具。

認證模式

欄位 properties.authentication 接受下列值：

價值	Description
None	無需身份驗證。
Microsoft Entra	透過 Microsoft Entra ID 進行認證。
泛型 OAuth 2.0	透過通用的 OAuth 2.0 提供者進行認證。

代理程式功能

本節列出代理的能力（工具與知識）。目前，它僅顯示代理所使用的連接器及知識配置的詳細資訊，詳見以下章節。

每個代理程式的庫存中，每種類型的資源最多只能有 200 個。在已知限制中了解更多。

庫存會自動移除重複的資源，例如你在同一設定的代理中設定兩次的 Power Platform 連接器。

連接器屬性

該清單包含一個稱為 powerPlatformConnectors的陣列，內含在代理中設定的 Power Platform 連接器。每個連接器以其connectorId（包含連接器資源 ID 的字串;例如）來識別。 shared_excelonlinebusiness 每個已設定的連接器都有一份已設定的 operations 清單。該清單包含以下物業：

Property	資料類型	Description	狀態
`OperationId`	字串	連接器內特定操作的識別碼;例如， `AddRowV2`	Preview
`createdBy`	GUID	設定操作的使用者	Preview
`isEnabled`	boolean	連接器操作目前是否啟用	Preview
`usedAs`	字串	操作的使用方式： `Tool` 若設定為通用工具 `Topic Tool` 若在特定主題中設定為工具 `Knowledge` 如果連接器被設定為知識來源	Preview
`requiresEndUserConsent`	boolean	最終使用者是否必須先取得同意，代理人才能使用該操作	Preview
`whenCanBeUsed`	字串	當可啟動該操作時： `Anytime` 如果該工具對代理人無限制地可使用， `ViaDirectReferenceOnly` 如果代理只在 Maker 明確設定特定主題時才使用該工具 `Conditional` 如果代理人能依照製作者預設的邏輯使用該工具	Preview
`connectionProvider`	字串	誰為該作業提供連線： `User` 如果最終使用者在執行時提供憑證 `Maker` 如果製作者在編寫時設定連線	Preview
`connectionIdSharedByMaker`	GUID	連線 ID，僅在 `connectionProvider = Maker` 時填入值	Preview

Example

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

知識屬性

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

Property	資料類型	Description	狀態
`IsWebSearchEnabledForKnowledge`	boolean	如果客服能把網路搜尋當作知識來源，那就沒錯	Preview

已知的限制

V1 代理不會被追蹤 ——庫存中不包含用原始 Power Virtual Agents V1 執行環境建立的代理。它只追蹤 V2（Copilot Studio）的代理人。
身分識別屬性可能無法在所有 Agent 中使用 - entraAgentId 和 entraAgentBlueprintId 欄位僅會針對使用較新 Entra Agent 識別碼模型佈建的 Agent 填入。較舊的代理程式可能只有 entraAppId，而 Microsoft 365 Copilot Agent Builder 代理程式則不具有任何這些身分識別屬性。
功能數量 - 清單中每個代理的每種資源類型上限為 200 個資源。如果一個代理有超過 200 個特定類型的資源（例如 Power Platform 連接器），庫存會隨機顯示 200 個。管理員可以利用此 capabilitiesCounts 欄位了解每個代理類型中配置了多少資源。

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-08-27

Microsoft Copilot Studio 代理程式清單

代理人性質

核心屬性

Entra 身分屬性

設定屬性

編排模式

認證模式

代理程式功能

連接器屬性

Example

知識屬性

已知的限制

相關內容

意見反應

其他資源