SharePoint 代理的洞察報告為 SharePoint 管理員提供組織內所有 SharePoint 站點及 OneDrive 站點中新建立的 SharePoint 代理的豐富資訊。 此報告讓管理員能夠了解建立最多代理的網站。 透過此報告，SharePoint 管理員能進一步治理並維護代理所使用內容作為基礎資料的完整性。
該洞察報告基於 Microsoft 透過 FileCreated 與 FileRenamed 事件記錄的 SharePoint 代理審計資料。
你可以在 SharePoint 管理員中心或使用 SharePoint Online 管理命令介面產生並管理 SharePoint 代理 Insights 報告。
您需要什麼才能存取 SharePoint 代理洞察報告
執照要求是什麼？
您的組織需要擁有正確的授權，並符合某些管理權限或角色，才能使用本文所述的功能。
首先，您的組織必須擁有以下其中一種基本授權：
- Office 365 E3、E5 或 A5
- Microsoft 365 E1、E3、E5 或 A5
此外，你需要有 Microsoft 365 Copilot 執照。
注意事項
你組織中至少必須有一位使用者被指派 Copilot 執照， (這個使用者不需要是 SharePoint 管理員) 。 如果您的組織擁有 Copilot 執照，且至少有一人被指派 Copilot 執照，SharePoint 管理員會自動取得 Copilot 部署所需的 SharePoint 進階管理功能。
管理員要求
你必須是 SharePoint 管理員 或擁有同等權限。
重要事項
如果你沒有 Microsoft SharePoint 進階管理授權，系統會要求你啟用資料收集，讓產品開始收集相關的稽核資料以建立此報告。 啟用後，報告可在24小時後產生，並包含收集點的資料。 資料儲存期限為28天。 若三個月內至少一次未產生報告，資料收集將暫停，並應重新啟用。 要啟用這些報告的資料收集，請參閱 本文中關於 SharePoint 代理的資料收集報告。
如何在 SharePoint 管理員中心存取 SharePoint 代理洞察報告
- 請以您組織的 SharePoint 管理員憑證登入 SharePoint 管理中心。
- 在左側窗格中，展開「報告」，然後選擇「代理人洞察」。
如何在 SharePoint 管理員中心建立報告
擁有 SharePoint 管理員的權限後，您可以選擇 「建立報告」來建立報告。
請提供報告名稱，並在報告期限中指定報告的時間範圍。
選擇 建立並執行。
注意事項
你可以針對過去1天、7天、14天或28天建立報告。
在 SharePoint 管理員中心查看報表狀態
要查詢報告是否準備好或最後更新時間，請參閱 狀態 欄位。
在 SharePoint 管理員中心查看報表
當報告準備好後，選擇它以查看資料。 你可以查看擁有最多經紀人的前100名紀錄。 你可以搜尋網站，或在網站範本和治理政策上篩選。
在 SharePoint 管理員中心套用內容治理政策
你可以從洞察報告中對網站套用內容治理政策。 可用的政策包括 限制網站存取政策 與 限制內容發現政策。
注意事項
從洞察報告套用政策到網站後，現有報告的政策狀態不會更新。 若要查看網站上政策的最新狀態，請選擇政策以查看最新狀態，或進入活動網站面板並檢視網站設定。
SharePoint Agent Insights 報告，位於 SharePoint Online 管理命令介面
你可以使用 SharePoint Online 管理命令介面產生並管理 SharePoint 代理的 Insights 報告。
- 如果還沒下載，請下載並安裝最新版本的 SharePoint Online 管理命令介面。
- 至少以 Microsoft 365 的 SharePoint 管理員 身份連接 SharePoint Online。 欲了解更多資訊，請參閱「開始使用 SharePoint Online 管理命令介面」。
- 要產生並查看這些報告，請確保組織擁有 SharePoint 進階管理外掛 SKU 或 Microsoft 365 Copilot 授權。
只要至少擁有 SharePoint 管理員的權限，你可以使用以下指令產生並查看洞察報告：
若要產生一天預設報告期間的報告，請執行以下指令：
Start-SPOCopilotAgentInsightsReport若要產生任何其他期間 (7、14 或 28 天) 的報告，請執行以下指令：
Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays例如，要產生過去 28 天的報告，請執行以下指令：
Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays <28>
要檢查所有活躍且可用的報告狀態，請執行以下指令：
Get-SPOCopilotAgentInsightsReport
要檢查特定報告的狀態，請執行以下指令：
Get-SPOCopilotAgentInsightsReport –ReportId要下載並查看報告，請執行以下指令：
Get-SPOCopilotAgentInsightsReport –ReportId -Action Download注意事項
PowerShell 最多可顯示 100 筆紀錄，但下載的報告可包含多達 100 萬筆紀錄。
Get-SPOCopilotAgentInsightsReport –ReportId -Action View欲查看更詳細的報告，以下選項可參考：
a. CopilotAgentsOnSites：提供目前所有站點可用的客服人員名稱。 本報告包含多達1,000,000筆紀錄。
注意事項
參數的
-Content預設值為CopilotAgentsOnSites。Get-SPOCopilotAgentInsightsReport –ReportId -Content CopilotAgentsOnSitesb. TopSites：提供100個網站及每個網站可用的代理人數量清單。
Get-SPOCopilotAgentInsightsReport –ReportId -Content TopSitesc. SiteDistribution：提供各類站點（如通訊站點、Microsoft 365 群組連接站點、OneDrive 站點等）代理的摘要視圖。
Get-SPOCopilotAgentInsightsReport –ReportId -Content SiteDistribution
SharePoint 代理的洞察資料收集報告
如果您沒有 Microsoft SharePoint 進階管理授權，系統會要求您啟用資料收集。 本節說明如何啟用及檢查 SharePoint 代理 Insights 報告的資料收集狀態。
啟用資料收集
這個 PowerShell 指令會開始收集過去 28 天活動報告的稽核資料。
Start-SPOAuditDataCollectionForActivityInsights
停用資料收集
這個 PowerShell 指令會停止收集過去 28 天活動報告的稽核資料。
Stop-SPOAuditDataCollectionForActivityInsights
檢查資料收集狀態
一旦啟用資料收集，報告可在24小時後產生。 要檢查是否能產生報告，請使用 PowerShell 指令 Get-SPOAuditDataCollectionStatusForActivityInsights。 指令會回傳目前的資料收集狀態，可以是「NotInitiated」、「InProgress」、「Paused」。 當狀態為「進行中」時，可以產生報告。
Get-SPOAuditDataCollectionStatusForActivityInsights
已知使用 SharePoint 代理洞察報告的經驗
以下是一些已知使用 SharePoint 管理員中心產生的 SharePoint Agent Insights 報告，或使用 SharePoint Online 管理命令介面產生的經驗：
報告只能在上次產生報告後 24 小時後重新執行。
在大型租戶中，資料可能需要長達48小時才能取得。
每個報告範圍值 (1、7、14或28天) 只能有一個報告。 這表示你在同一點最多只能看到四個報告。
新產生的報告會替換先前建立的報告，使用相同的日期範圍。 為了保留先前建立的報告，請先下載報告，再建立同一日期範圍的新報告。
這些報告是使用 Microsoft 365 統一稽核資料產生的，可能無法涵蓋所有稽核事件。