View a markdown version of this page

Atlassian Confluence 雲端知識庫整合 - Amazon Quick
開始之前身分驗證設定知識庫整合受支援的內容類型存取控制管理知識庫疑難排解

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Atlassian Confluence 雲端知識庫整合

使用 Atlassian Confluence Cloud 知識庫整合來為 Confluence 內容編製索引，以便 Amazon Quick 代理程式可以搜尋和回答有關內容的問題。

開始之前

在設定整合之前，請確定您有下列項目。

身分驗證

對於知識庫整合，Amazon Quick 會在設定期間透過快顯流程處理身分驗證。完成下列步驟。

  1. 完成出現的 Confluence Cloud 身分驗證快顯視窗。

  2. 授予 Amazon Quick 存取 Confluence 內容的許可。

  3. 檢閱並完成身分驗證程序。

設定知識庫整合

  1. 在 Amazon Quick 主控台中，選擇整合。

  2. 選擇 Atlassian Confluence Cloud，然後選擇新增 （加 "+") 按鈕。

  3. 在建立 Confluence 知識庫對話方塊中的連線帳戶下，完成下列欄位：

    • 名稱 – 資料存取整合的描述性名稱。

    • Confluence URL – 您 Atlassian 網站的 URL （例如 your-site.atlassian.net)。

  4. 選擇登入，然後在快顯視窗中完成 Confluence Cloud 身分驗證流程。

  5. 在建立知識庫下，完成下列欄位：

    • 名稱 – 知識庫的名稱。

    • 描述 （選用） – 關於如何使用知識庫的備註。

  6. 在內容下，貼上您要包含的 Confluence 空間、部落格或頁面URLs。選擇每個 URL 後的新增。

    注意

    遵循結構的 URLshttps://company.atlassian.net/wiki/spaces/space-key/overview會視為頁面 URLs。

  7. 選擇建立。

受支援的內容類型

  • Confluence 頁面和部落格文章

  • Spaces 內容

  • 頁面和部落格附件

存取控制

重要

Amazon Quick 不會從資料來源同步存取控制清單 ACLs)。根據預設，當您在 Amazon Quick 中建立知識庫時，只有您可以從知識庫取得洞見。對於共用內容，您可以透過更新知識庫許可，為不同的使用者和群組提供存取權。

管理知識庫

編輯現有的知識庫

  1. 在 Amazon Quick 主控台中，選擇知識庫。

  2. 從清單中選擇您的 Confluence Cloud 知識庫。

  3. 選擇動作下的三點圖示，然後選擇編輯知識庫。

  4. 視需要更新您的組態設定，然後選擇儲存。

疑難排解

若要編輯、共用或刪除整合，請參閱 管理現有的整合。

如需一般知識庫疑難排解，包括同步問題和缺少文件，請參閱 故障診斷知識庫。

封鎖的 OAuth 應用程式授權

徵狀：

  • 錯誤訊息：「您的網站管理員必須為網站 instance-name.atlassian.net 授權此應用程式，應用程式才能存取您的帳戶。」

  • 在同意對話方塊中按一下接受沒有效果。

原因：

您的 Atlassian 網站管理員已封鎖使用者安裝的 OAuth 應用程式。啟用此設定時，只有網站或組織管理員可以授權新的第三方應用程式。

解決步驟：

使用下列其中一個選項來解決此問題。

  • 選項 1 （建議）：管理員直接授權應用程式

    1. Atlassian 網站管理員導覽至 Amazon Quick，並使用 Confluence Cloud 開始新的知識庫設定。

    2. 由於管理員具有網站層級的許可，因此會出現明確的同意畫面，不會發生錯誤。

    3. 管理員選擇接受來安裝應用程式。

    管理員授權應用程式後，網站上的所有其他使用者可以連線而不會發生問題。

  • 選項 2：暫時允許使用者安裝的應用程式 – 管理員前往 admin.atlassian.com，導覽至應用程式、Atlassian 應用程式，然後選擇第三方和 Marketplace 應用程式的連結。在設定下，尋找使用者安裝的應用程式並切換以允許使用者應用程式。在使用者授權 Amazon Quick 之後，將設定切換回封鎖使用者應用程式。

重要

管理授權適用於每個 Atlassian 網站，而非每個組織。如果您的公司有多個網站 （例如 team-a.atlassian.net和 team-b.atlassian.net)，則每個網站都需要個別的授權。

注意

當使用者安裝的應用程式解除封鎖 （選項 2) 時，網站上的任何使用者都可以授權任何 OAuth 應用程式。在使用者連線後，立即重新啟用區塊。

身分驗證快顯視窗失敗

徵狀：

  • 身分驗證快顯視窗不會立即顯示或關閉。

  • 出現快顯視窗，但無法完成 OAuth 流程。

解決步驟：

  1. 確認您的瀏覽器允許來自 Amazon Quick 主控台網域的快顯視窗。

  2. 確認您的 Confluence Cloud 執行個體可從您的網路存取。

  3. 請嘗試使用不同的瀏覽器或清除瀏覽器快取。

知識庫中缺少內容

徵狀：

  • 知識庫同步完成，但預期的內容不會編製索引。

  • 搜尋結果不包含來自特定空格或頁面的內容。

  • 只有一個文件會針對整個空間編製索引。

解決步驟：

  1. 確認已驗證的 Confluence Cloud 使用者可存取您在設定期間選取的空間和頁面。

  2. 檢查是否支援選取的內容類型 （頁面、部落格文章和附件）。

  3. 檢閱知識庫組態中的內容選擇，以確認包含正確的空格和頁面。

  4. 檢查/overview尾碼的 Confluence URLs。以 URLs的 URL /wiki/spaces/space-key/overview 會視為單一頁面 URL，而非完整空間。如果您打算為整個空間編製索引，請使用不含 的空間 URL /overview（例如 https://company.atlassian.net/wiki/spaces/space-key)。