Confluence Cloud Microsoft 365 Copilot 連接器將 Confluence 內容整合進 Microsoft 365,使 Copilot、Copilot Search 和 Microsoft Search 能直接在 Teams、Outlook 和 SharePoint 等應用程式中顯示相關的維基頁面與部落格。
本文說明部署、客製化及排除 Confluence Cloud Copilot 連接器的步驟。 關於 Copilot 連接器部署的一般資訊,請參閱 Microsoft 365 系統管理中心的「設定 Copilot 連接器」。
欲了解進階的 Confluence Cloud 設定資訊,請參閱 設定 Confluence Cloud 服務以擷取連接器。
必要條件
在部署 Confluence Cloud 連接器之前,請確保 Confluence 環境已在你的組織中設定妥當。 下表總結了配置 Confluence 環境及部署連接器的步驟。
| 工作 | 角色 |
|---|---|
| 設定環境 | Confluence 管理員 |
| 設置先決條件 | Confluence 管理員/網路管理員 |
| 在 Microsoft 365 系統管理中心部署連接器 | Microsoft 365 系統管理員 |
| 自訂連接器設定 (可選) | Microsoft 365 系統管理員 |
要部署連接器,您必須符合以下先決條件:
- 您必須是貴組織 Microsoft 365 租戶及 Confluence 網站的管理員。
- 你必須擁有正確的認證憑證和存取權限。
展開連接器
要為您的組織新增 Confluence Cloud 連接器:
- 在 Microsoft 365 系統管理中心左側窗格,選擇 Copilot>連接器。
- 到「 連接器 」分頁,在左側窗格選擇 「圖庫」。
- 從可用連接器列表中,選擇 Confluence Cloud。
集合顯示名稱
顯示名稱用於識別 Copilot 回應中的參考,幫助使用者辨識相關檔案或項目。 顯示名稱同時代表受信任的內容,並用作內容來源過濾器。
你可以接受預設的 Confluence Cloud 顯示名稱,或自訂該值,使用使用者熟悉的顯示名稱。
欲了解更多關於連接器顯示名稱與描述的資訊,請參閱「以 Microsoft 365 Copilot 連接器內容強化 Copilot 發現」。
設定實例網址
要連接你的 Confluence 網站,請使用你的網站網址,通常如下: https://<organization_name>.atlassian.net。
這個 <organization_name> 數值是你 Confluence Cloud 網站的唯一識別碼。
選擇認證類型
要驗證並同步 Confluence 的內容,請選擇以下認證類型之一:
基本認證 - 使用基本認證時,請輸入使用者名稱 (通常是電子郵件地址) 和 API 令牌。 要產生 API 代幣,請參閱 「管理您的 Atlassian 帳戶的 API 代幣」。
OAuth 2.0 (推薦) - 在 Confluence Cloud 註冊應用程式,讓 Microsoft Search and Microsoft 365 Copilot 能存取該實例。 更多資訊請參閱 啟用 OAuth 2.0 (3LO) 。
註冊應用程式:
請用你的 Atlassian Confluence 管理員帳號登入 Atlassian 開發者主控台 。
選擇 建立 並選擇 OAuth 2.0 整合。
提供應用程式名稱並建立新的應用程式。
在左側窗格選擇 權限,然後在 Confluence API 旁邊選擇 新增。
選擇 配置>編輯範圍,並選擇下表中列出的範圍。
範圍名稱 代碼 描述 查看內容細節 閱讀:內容-詳細:匯流 爬取符合條件的內容。 查看群組 閱讀:群組:匯流 存取群組內容權限。 查看使用者資料 閱讀:使用者:Confluence 存取個別使用者資料以支援權限。 查看審計紀錄 閱讀:audit-log:Confluence 存取 Confluence 事件的稽核紀錄以支援權限。 瀏覽頁面 閱讀:頁面:Confluence 存取頁面內容細節以支援權限。 檢視空間 閱讀:空間:匯流 存取空間細節以支援權限。 查看內容限制與空間權限 閱讀:權限:Confluence 查看內容限制與空間許可。 查看內容摘要 read:content.metadata:confluence 存取內容資訊以支持權限。 查看留言 閱讀:留言:Confluence 查看頁面或部落格文章的留言。 查看與下載內容附件 閱讀:附件:匯流 查看並下載您能存取的頁面或部落格文章附件。 選擇 [儲存]。
在左側選區,進入 授權。 請為 Microsoft 365 新增回調網址,如下:
- Microsoft 365 企業版 -
https://gcs.office.com/v1.0/admin/oauth/callback - Microsoft 365 政府版 -
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- Microsoft 365 企業版 -
選擇 [儲存]。
在左側窗格,進入 設定。 複製 客戶 ID 和 秘密。 透過使用 Client ID 和 Secret 完成連線設定步驟。
提示
確保服務帳號有檢視權限存取你想索引的 Confluence 內容。
推出
先將連線部署給有限的使用者群,以便在 Copilot 及其他搜尋表層驗證,然後再推向更廣泛的受眾。 欲了解更多資訊,請參閱 Microsoft 365 Copilot 連接器的分階段部署。
若要推送至有限受眾,請選擇「 推展」 旁的「有限受眾」切換,並指定要推送連接器的使用者與群組。
要部署連接器,請在 Microsoft 365 系統管理中心選擇「建立」。 Confluence Cloud Copilot 連接器會立即開始索引你 Confluence 帳號的頁面。
下表列出預設值。 這些數值最適合搭配 Confluence 的資料。
| 類別 | 設定 | 預設值 |
|---|---|---|
| 使用者 | 存取權限 | 只有有權限存取資料來源內容的人。 |
| 使用者 | 對應身分識別 | 資料來源身份是使用 Microsoft Entra ID 映射的。 |
| 內容 | 包含/排除空間 | 全部 |
| 內容 | 管理物業 | 關於預設屬性與結構,請參見 管理屬性。 |
| 同步處理 | 增量爬行 | 頻率:每15分鐘一次 |
| 同步處理 | 全程爬行 | 頻率:每天 |
要自訂這些數值,請參閱 「自訂設定」。
建立連線後,您可以在 Microsoft 365 系統管理中心的連接器區查看狀態。
自訂設定 (可選)
你可以自訂 Confluence Cloud 連接器設定的預設值。 要自訂設定,在管理中心的連接器頁面選擇 自訂設定。
自訂使用者設定
Confluence Cloud 連接器支援以下使用者搜尋權限:
- 所有人
- 只有有權限存取此資料來源的人 (預設)
如果你選擇 「所有人」,索引資料會出現在所有使用者的搜尋結果中。 如果你選擇 「僅限有權限存取此資料來源的人」,索引資料會出現在有權限存取該資料的使用者搜尋結果中。 在 Confluence Cloud 中,使用者與群組的安全權限是透過空間權限和頁面限制來定義的。 若有頁面層級限制,則優先於空間權限。
若未指定頁面限制,連接器會檢查空間層級權限,並套用以下事項:
- 如果該空間啟用匿名 使用者 存取,內容會對租戶中的所有使用者都可見。
- 如果該空間沒有啟用 匿名存取 ,則會尊重空間層級的權限。
- 如果沒有定義空間層級的權限,內容對租戶中的任何使用者都看不到。
重要事項
權限僅在空間與頁面層級管理。 父頁面權限不會被套用。
如果你選擇「只有有權限的人」存取此資料來源,你還需要選擇你的 Confluence 網站是否有 Microsoft Entra ID 配置的使用者,或是非 Entra ID 使用者:
- 如果 Confluence 使用者的電子郵件 ID 與 UPN) Microsoft Entra ID (使用者主體名稱相同,請選擇 Microsoft Entra ID 選項。
- 如果 Confluence 用戶的電子郵件 ID 與 Microsoft Entra ID 中的 UPN 不同,請選擇非 Entra ID 選項。
注意事項
- 如果你選擇 Microsoft Entra ID 作為身份來源,連接器會將 Confluence 的使用者電子郵件 ID 對應到 Microsoft Entra ID 中的 UPN 屬性。
- 如果你選擇非 Entra ID 作為身份來源,請提供一個正則表達式,將電子郵件 ID 對應到 UPN。 欲了解更多資訊,請參閱 「映射您的非Entra ID身份」。
- 管理存取權限的使用者或群組的匯報僅以完整爬取方式同步。 增量爬取目前不支援權限更新。
自訂內容設定
你可以自訂包含或排除的資料,並自訂預設連接器屬性。
包含或排除資料
預設情況下,Confluence Cloud 連接器會索引所有部落格和頁面。 你可以包含或排除你想要索引的資料。 你可以使用 Confluence 查詢語言 (CQL) 字串來指定同步頁面的條件。 例如,你可以選擇只索引過去兩年內被修改過的頁面。 欲了解更多資訊,請參閱 使用 CQL 進行進階搜尋。
提示
你可以使用 CQL 過濾器來索引經過一定時間修改後的內容,例如使用。 lastModified >= "2024/12/31"
選擇 預覽結果 以驗證所選屬性及 CQL 字串的樣本值。
管理物業
要從 Confluence Cloud 連接器新增或移除可用屬性,請為該屬性指派一個結構, (定義屬性是否可搜尋、查詢、可檢索或可精煉) ,改變語意標籤,並為該屬性加上別名。 以下屬性預設為索引。
| 預設屬性 | 標籤 | 描述 |
|---|---|---|
| Authors | authors |
參與或合作該項目的公開姓名。 |
| CreatedByName | createdBy |
最近編輯該資料來源項目的公開姓名。 |
| IconUrl | iconUrl |
物品的相關圖示網址。 |
| 標題 | title |
你想在搜尋和其他經驗中顯示的項目標題。 |
| 更新dByName | lastModifiedBy |
最近編輯該資料來源項目的公開姓名。 |
| 更新日期 | lastModifiedDateTime |
該項目在資料來源中最後修改的日期與時間。 |
| URL | url |
資料來源中項目的目標網址。 |
選擇預覽 結果 按鈕以驗證所選屬性與篩選條件。
自訂同步間隔
刷新間隔決定了你的資料在資料來源與 Confluence Cloud 連接器索引之間同步的頻率。 副駕駛連接器使用兩種刷新間隔:
- 全爬行 - 對所有內容進行完全同步。 完整爬取偵測已刪除項目,並同步存取控制清單 (ACL) 變更。 預設情況下,完整爬行每 24 小時執行一次。
- 增量爬取 - 同步新內容與修改內容。 增量爬取不會偵測 ACL 變更或刪除項目。 預設情況下,增量爬行每 15 分鐘執行一次。
你可以更改刷新間隔的預設值。 欲了解更多資訊,請參閱 同步設定指引。