透過使用 Copilot Agent Kit 中的 Agent Inventory 監控特工

代理程式清單功能可讓管理員在整個租戶範圍內，全面掌握組織中所有 Copilot Studio 自訂代理程式與宣告式代理程式的資訊，涵蓋各個環境。 代理庫存資料包括生命週期與擁有權元資料、配置與能力採用訊號、治理指標及使用指標。

Dashboard

代理庫存儀表板提供全租戶的摘要及深入導覽。 選擇圖塊、圖表或清單項目，在客服格子中開啟篩選檢視。

庫存背景

儀表板頂端的狀態列顯示庫存的當前狀態：

• 無論是庫存是目前、空的，還是正在同步中。
• 已補充詳細組態資訊的記錄百分比。
• 詳細資料有限的 Agent 數目。
• 同步環境的數量。
• 最後一次成功同步時間（若有的話）。

投資組合指標

公制方塊幫助你直接跳入庫存中的重要區塊：

• 代理人人數
• 動力來源
• 自主代理
• 草稿代理程式
• 具備知識的代理人

選取圖塊以開啟已篩選為該區段的代理人網格。 Powered by Tile 將代理人員分為標準、GitHub Copilot 和 Copilot Chat 等類別。

分析與治理

儀表板還包含圖表與清單，幫助您發現模式與風險：

• 投資組合成長 範圍為六個月及十二個月。
• 驗證 分發。
• 治理優先事項需由管理者審查。
• 投資組合狀態 分布。
• 增強型代理中的能力採用。
• 依代理數量排名的頂尖環境。
• 需注意的 Agent：需要注意的記錄。

百分比取決於所設定的連線身份可取得代理資料及詳細設定的環境。 在 資料收集模式中了解更多。

瀏覽所有代理人

從儀表板選擇 「查看完整庫存 」以開啟代理人的網格。 利用網格來尋找、分組並匯出庫存資料。

你可以依任何欄位篩選、排序和分組，新增或移除欄位以依需求調整格網，並將當前檢視匯出到 Excel。

代理人資料

從網格中選擇代理人名稱以開啟 代理人詳細資料。 標頭顯示代理身份、環境上下文、生命週期狀態、擁有權及可用動作。 資訊橫幅會告訴你該紀錄是否包含完整的 Dataverse 豐富化，或僅有有限的設定細節。

概觀頁籤

Overview 標籤顯示代理摘要與環境資訊、治理態勢與訊號，以及使用歷史時的使用快照。 若啟用 AI 生成描述且代理人符合資格的 GitHub Copilot Agent，則也會顯示 AI 生成的描述。

元件分頁

元件 分頁 僅在代理有元件資料時才會出現。 使用此分頁在 元件地圖 檢視中探索代理架構，在 元件群組 檢視中瀏覽分類內容，一次展開一個已填寫的元件群組，開啟 Raw 模式檢查 JSON，或複製元件 JSON 以便調查或支援。

使用量索引標籤

使用分頁僅在代理存在使用紀錄時才會顯示。 其中包含：

• 本月至今、前兩個曆月、過去三個月及過去六個月區間。 預設選擇最後六個月 。
• Copilot 總點數與每個活躍週的平均點數。
• 報告用戶與主要使用功能。
• 每週信用趨勢。
• 使用情況重點、依功能和頻道劃分的點數，以及近期使用紀錄。
• 一個代理專屬的 Excel 匯出。

中繼資料索引標籤

元資料標籤隨時可用。 利用它檢查技術值，如代理 ID 與結構名稱、環境 ID 與 URL、位置與來源識別碼，以及用於診斷與整合的原始庫存欄位。

同步或更新庫存資料

代理庫存將同步與儀表板刷新分開。

同步代理程式

當你需要再次收取租戶庫存時，請選擇 同步代理人 。 同步依照篩選器、環境群組、資料收集模式、使用設定及排程，這些設定已儲存在 配置代理清單中。

同步作業執行期間：

• 庫存狀態會變成 同步進行中。
• 為了防止重複操作，Sync agents 被停用。
• 無法更改主動同步設定的設定。
• 同步結束後，儀表板會重新載入代理資訊、使用歷史、同步狀態及最後同步資訊。

重新整理儀表板資料

選擇 「重新整理儀表板資料 」以重新載入已儲存在 代理詳情 與 代理使用歷史 資料表中的資料。 刷新不會啟動代理同步，也不會重新發現環境或代理。 在同步完成後，或儀表板顯示快取資料過時時使用。

治理行動

代理人庫存支援 重新分配、 隔離及 解除隔離 等操作。 只有當所有被選定的代理人都符合資格時，行動才會出現。

動作可用性

格子中的 狀態 欄位會在最後一次庫存同步時填寫，反映來自 Power Platform 管理中心（One Inventory 資料）的數值。 顯示哪些動作取決於你選擇的紀錄數量及其狀態。

如果任何選擇的紀錄與某個操作不相容，該操作會從指令列中隱藏。 若記錄的 Power Platform 系統管理中心內容與詳細目錄環境不相符，就不會提供不支援的治理動作。

在 客服人員詳情 頁面，隔離與解除隔離的可用性是根據客服人員 的線上狀態，而非網格中顯示的同步狀態。

重新指派

有些組織要求代理人必須有業主以符合法規。 擁有者可以依照自己的權限編輯代理、發布更新、刪除或與隊友分享。

選擇重新指派，並選擇擁有 Microsoft 365 Copilot 授權的使用者。 對於批量重新指派，對話框會顯示所選環境、代理程式、目前擁有者及營運狀態。 重新指派完成後，每個成功處理的代理人的重新指派狀態會顯示為完成。

隔離與解除隔離

隔離 會封鎖符合資格的代理人。 解除隔離 會還原符合資格且遭封鎖的代理程式。 確認對話框會在提交操作前識別受影響的代理、環境及狀態。

批量動作支援每次操作最多 50 名代理，且僅在所有選擇紀錄符合資格時才可用。

設定代理程式清單

從儀表板標頭選擇 設定 以開啟 代理同步設定。 你可以用它來控制收集哪些環境和代理類型、調整庫存選項，以及設定同步排程和收集模式。

環境類型

選擇掃描的環境類型：

• 開發人員
• Default
• 沙箱
• 生產
• 試用版
• Teams

如果你沒有選擇環境類型，系統會包含所有環境類型。

代理人類型

選擇清單是否包含：

• 海關代理
• 陳述式代理

如果你沒有選擇代理人類型，庫存會包含所有代理人類型。

環境群組

環境群組提供可重複使用的同步範圍。 作為管理員，你可以：

• 建立並編輯一個群組。
• 透過使用環境類型與區域篩選器選擇成員環境。
• 啟用或停用群組。
• 刪除一個你不再需要的群組。

如果你沒有啟用群組，其他設定允許的所有環境都會被包含在內。

庫存選項

請設定以下選項來控制系統在同步時收集的資訊：

• 排除系統代理：在同步時跳過 Microsoft 提供的系統代理程式。
• 啟用 GitHub Copilot 代理的 AI 生成描述：當造訪符合資格的代理詳情頁面時，允許產生描述。
• 包含使用指標：在同步期間收集保留的 180 天使用時段。

同步排程與收集模式

選擇同步的執行方式及使用哪種資料收集模式：

• 單一庫存（Power Platform 管理中心）：結合管理中心庫存與環境資料，提供更廣泛的發現與更豐富的元資料。
• 標準（僅限環境）：直接從可存取的環境擷取清查資料。
• 啟用每日自動同步：依照設定的每日排程執行 Agent Inventory。

選取 [儲存] 以套用變更。 當設定未改變、存檔進行中，或在同步時設定不可用時，存檔會被停用。

資料收集模式

資料收集模式設定決定系統如何發現並收集代理人紀錄。

單一庫存模式（建議）

當你將收集模式設為 單一庫存時，代理人庫存會使用單一庫存資料：

1. 它透過 Power Platform 管理中心從 One Inventory 取得代理資料。
2. 它依據 Copilot Agent Kit - Power Platform for Admins V2 連線參考來列出環境。
3. 它結合 One Inventory 代理資料與環境清單來建構環境細節。
4. 針對每個環境，它會將從環境中擷取的代理與對應的 One Inventory 資料合併，將代理資料載入代理庫存。

當你需要更廣泛的租戶發現和更豐富的 Power Platform 管理中心元資料時，請使用此模式。 透過系統管理中心探索到、但在其環境中無法存取的 Agent，仍會以有限的詳細資料新增。

標準模式

當你將收集模式設為 標準時，代理庫存會採用標準的資料收集方法：

1. 它使用 Copilot Agent Kit - Power Platform for Admins 連線參考（V1）列出所有環境。
2. 它會為每個環境擷取代理。
3. 它會將代理人資料載入代理人庫存。

當你想讓收藏只依賴可及的環境時，請使用此模式。

在兩種模式下，Agent Inventory 都會使用 Copilot Agent Kit - Dataverse 連線參考，連接每個環境並收集詳細的代理資訊，包括元資料、功能使用及設定。 系統僅在設定帳號擁有系統管理員權限的環境中，擷取詳細資訊。

想了解更多套件中所用連接器的完整清單，請參閱 連接器需求。

使用量指標

客服人員庫存可保留並顯示最多 180 天的客服使用資料。 啟用使用分析：

1. 確保所需的解決方案連線已由資料政策設定並允許。
2. 開啟 Agent 同步設定。
3. 開啟 「包含使用指標」。
4. 選取 [儲存]。
5. 選擇 同步代理，或等待每日自動同步。

使用資料會儲存在 代理詳細資料 表和 代理使用歷史 資料表中。 客服人員的 使用 分頁僅在有匹配的使用歷史紀錄時出現。

設定 HTTP 與 Microsoft Entra ID 連線

使用量指標依賴 HTTP 與 Microsoft Entra ID（預先授權）連接器。 連線數值取決於你的租戶所使用的雲端。 建立連線時，請使用與雲端相符的基礎資源 URL 和 Microsoft Entra ID 資源 URI。

權限與連接器要求

解決方案中的連線參照會 限制 和 控制 代理人能見度。 若要取得完整的租用戶範圍可視性，請使用具有 Power Platform 系統管理員角色的帳戶來設定連線參考。 要取得所有功能層級的詳細資訊，該帳號也需要系統 管理員 存取相關環境。 您可以使用其他帳戶，但客服專員庫存的可見性僅限於使用者具有系統管理員存取權的環境。

代理庫存依賴以下連接器，這些連接器必須符合應用於環境的資料政策：

• Microsoft Dataverse
• 管理員專用的 Power Platform
• 適用於管理員的 Power Platform v2
• 使用 Microsoft Entra ID 的 HTTP（預先授權）

想了解更多套件中所用連接器的完整清單，請參閱 連接器需求。

以下 Dataverse 表格儲存代理庫存資料：

後續步驟

相關資訊

• 代理程式庫存資料來源
• 配置代理庫存連線參考
• 連接器需求