使用Dropbox Microsoft 365 Copilot連接器，M365中的組織可以使用 Microsoft Copilot和搜尋，為Dropbox中任何人都可存取的檔案編制索引。
本文適用於Microsoft 365 位系統管理員或設定、執行及監視Dropbox Copilot連接器的任何人。
功能
- 使用語意搜尋的功能存取Dropbox檔案
- 保留您組織定義 (ACL) 存取控制清單
- 自訂您的編目頻率
- 使用此連線和外掛程式從 Microsoft Copilot Studio 建立工作流程
限制
- 資料夾、回復 & 批注無法編製索引
必要條件
建立 Dropbox Copilot 連接器之前，您必須：
1.設定小組系統管理員使用者
建立商務用Dropbox帳戶，並設定小組系統管理員使用者。
2.設定Dropbox應用程式
設定具有唯一應用程式名稱、已啟用限域存取和完整Dropbox許可權的Dropbox應用程式。 請參閱 有關建立應用程式的Dropbox檔。
![[建立] 按鈕的螢幕快照。](media/dropbpx-create-app.png)
3.新增直接 URL
在Dropbox應用程式控制台中設定索引標籤的 OAuth 2 區段中，將下列連結新增至已歸檔的「重新導向 URL」：
針對 M365 企業版，複製並貼上： https://gcs.office.com/v1.0/admin/oauth/callback
針對 M365 Government，複製並貼上： https://gcsgcc.office.com/v1.0/admin/oauth/callback
4.新增 API 範圍
瀏覽至Dropbox應用程式控制臺上的 [許可權] 索引標籤，並新增下列許可權：
個別範圍：
files.metadata.read
files.content.read
sharing.read
file_requests.read
小組範圍：
team_info.read
team_data.member
team_data.governance.write
team_data.governance.read
team_data.content.read
files.team_metadata.read
members.read
groups.read
events.read
5.取得應用程式金鑰和應用程式秘密
從左側瀏覽窗格流覽至 [設定] 索引標籤，從此頁面取得應用程式密鑰和應用程式秘密。
設定
1.顯示名稱
選擇可協助用戶輕鬆辨識 Copilot 回應中相關聯檔案或項目的顯示名稱。
2.驗證類型
輸入您從Dropbox應用程式控制台取得的應用程式金鑰和應用程式秘密。
3.向有限的物件推出
如果您想要先在 Copilot 和其他搜尋介面中驗證此連線，再將此連線擴充至更廣泛的物件，請將此連線部署至有限的使用者基底。
對於其他設定，例如訪問許可權、數據包含規則、架構、編目頻率等，我們會根據Dropbox中最適合的數據來設定預設值。 預設值設定如下所示。
| Page | 設定 | 預設值 |
|---|---|---|
| 使用者 | 訪問許可權 | 您租使用者中所有Microsoft 365位使用者都能看見Dropbox中任何人可存取的所有檔案，Microsoft搜尋或 Copilot。 |
| 內容 | 索引內容 | 默認會選取所有已發佈的文章和頁面。 |
| 內容 | 管理屬性 | 檢查預設屬性及其架構。 |
| 同步處理 | 累加編目 | 頻率：每 4 小時 |
| 同步處理 | 完整編目 | 頻率：每天 |
如果您想要編輯其中任何一個值，您必須選擇 [自訂安裝 ] 選項。
自訂安裝程式
自訂設定適用於想要編輯設定預設值的系統管理員。 按兩下 [自定義安裝] 選項之後，您應該會看到其他三個索引標籤 ： [使用者]、[內容] 和 [同步]。
使用者
訪問許可權
Dropbox Copilot 連接器支援只有具有此數據源存取權的人員才能看見數據， (建議) 或所有人。 如果您選擇 [所有人]，已編製索引的數據會出現在所有使用者的搜尋結果中。
如果您選擇 [僅限可存取此數據源的人員]，則必須進一步選擇您是否 Microsoft Entra ID 布建的使用者或非 AAD 使用者。
若要識別哪個選項適合您的組織：
如果 Dropbox 使用者的電子郵件識別碼與 Microsoft Entra ID 中使用者的 UP) N (UPN (相同，請選擇 [Microsoft Entra ID] 選項。
如果 Dropbox 使用者的電子郵件識別碼與 Microsoft Entra ID 中使用者的 USERPrincipalName (UPN) 不同，請選擇非 AAD 選項。
重要事項
- 如果您選擇 Microsoft Entra ID 做為身分識別來源的類型，連接器會將從Dropbox取得的使用者電子郵件標識碼直接對應至 Microsoft Entra ID的UPN屬性。
- 如果您針對身分識別類型選擇 「非 AAD」，請參閱對應您的非 Azure AD 身分識別以取得對應身分識別的指示。 您可以使用此選項來提供從電子郵件識別碼到 UPN 的正規表示式對應。
- 對管理訪問許可權的使用者或群組 匯報 只會以完整編目進行同步處理。 累加編目目前不支援處理許可權的更新。
內容
管理屬性
在這裡，您可以從Dropbox資料源新增或移除可用的屬性。 將架構指派給屬性 (定義屬性是否 可搜尋、可查詢、可擷取或可精簡) 、變更語意卷標，以及將別名新增至 屬性。 預設選擇的屬性為：
| Source 屬性 | Label | 描述 | 圖式 |
|---|---|---|---|
| CreatedBy | 建立者 | 建立者的電子郵件位址 | 查詢、擷取、搜尋 |
| FileExtension | 副檔名 | 副檔名。 | 查詢、精簡、擷取 |
| IconUrl | IconUrl | 圖示的 URL。 | 取回 |
| LastModifiedBy | 上次修改日期時間 | 上次修改此檔案之使用者的電子郵件位址。 | 查詢、擷取、搜尋 |
| LastModifiedTime | lastModifiedDateTime | 要修改檔案的最後一個使用者。 執行上次修改的用戶必須是登入使用者。 | 查詢、精簡、擷取 |
| 名稱 | 檔案名稱 | 檔案名稱 | 查詢、擷取、搜尋 |
| PreviewUrl | URL | 顯示共用檔案 Web 預覽的 URL。 | 取回 |
| 大小 | 檔案大小 (位元組)。 |
同步處理
您可以根據此處的排程選項來設定完整和累加編目。 根據預設，累加式搜耙會設定為每 4 小時一次，並設定每天的完整編目。 如有需要，您可以調整這些排程，以符合您的數據重新整理需求。
疑難排解
1.遺漏必要的許可權範圍。 請確定已在Dropbox應用程式中選取必要的範圍。
缺少必要的許可權範圍，請確定您已選取Dropbox應用程式控制台中的所有範圍：
個別範圍：
files.metadata.read
files.content.read
sharing.read
file_requests.read
小組範圍：
team_info.read
team_data.member
team_data.governance.write
team_data.governance.read
team_data.content.read
files.team_metadata.read
members.read
groups.read
events.read
2.OAuth 2.0 流程失敗。 確認認證資訊，並確定Dropbox應用程式已設定正確的設定。
常見的驗證錯誤。 返回 至Dropbox應用程式控制台，並檢查設定索引標籤的 OAuth2 是否已正確設定。
3.OAuth 2.0 流程失敗。 確認與此小組存取令牌相關聯的Dropbox使用者具有小組系統管理員角色，且為作用中的使用者。
常見的驗證錯誤。 返回 至Dropbox應用程式控制台，並檢查建立者是否具有系統管理員角色，且帳戶狀態為作用中。
4.此會話的安全性認證已過期。 返回 並使用您的應用程式金鑰和應用程式秘密再次登入。
認證資訊已過期。 重新整理Dropbox應用程式控制台，並從 [設定] 索引標籤複製最新的應用程式金鑰和應用程式秘密以進行驗證。
5.偵測到無效的認證。 檢查認證資訊，並檢查Dropbox應用程式的許可權範圍。
常見的認證錯誤。 返回 至Dropbox App控制台，並檢查是否已正確設定許可權索引卷標的範圍。