View a markdown version of this page

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

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

Atlassian Confluence 雲端知識庫整合

使用 Atlassian Confluence Cloud 知識庫整合來為 Confluence 內容編製索引，以便 Amazon Quick 代理程式可以搜尋和回答有關內容的問題。Amazon Quick 支援 Confluence 知識庫的選用文件層級存取控制 (ACLs)。啟用時，使用者只會看到他們獲授權在 Confluence 中存取之文件的答案。如需詳細資訊，請參閱文件層級存取控制。

開始之前

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

如果您打算啟用文件層級存取控制，則必須在設定期間提供 Atlassian 管理員憑證。這些登入資料可讓 Amazon Quick 存取所有使用者和群組資訊，無論個別電子郵件可見性設定為何。如果沒有管理員登入資料，則在建立知識庫期間無法使用 ACL 選項。若要提供管理員登入資料，您需要 Atlassian 組織管理員提供下列項目：

  • Atlassian 管理員 API 金鑰 – 在 Atlassian 管理員入口網站中產生的英數字串。

  • 組織 ID (UUID) – 您 Atlassian 組織的唯一識別符。登入管理員入口網站時，您可以在瀏覽器 URL 中找到此項目：admin.atlassian.com/o/orgId。

  • 目錄 ID (UUID) – 使用者目錄的唯一識別符。使用 Atlassian Admin Workspace API 擷取此值。

如需取得這些登入資料的詳細步驟，請參閱 取得 Atlassian 管理員登入資料。

設定知識庫整合

設定精靈有三個步驟：身分驗證、知識庫建立和其他設定。

驗證您的帳戶

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

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

  3. 在建立 Confluence 知識庫對話方塊中的身分驗證方法下，從名稱下拉式清單中選擇現有的連線帳戶，或選擇新增帳戶以建立新的連線。

  4. 如果您要新增帳戶，請完成下列欄位：

    • 名稱 – 連線的描述性名稱。

    • 描述 （選用） – 有關連線的備註。

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

  5. （選用） 在 ACL 管理下，選取使用 Atlassian 管理員登入資料以提供 Atlassian 管理員登入資料。選取時，請輸入下列項目：

    • API 金鑰 – Atlassian 管理員 API 金鑰。

    • OrganizationID (UUID) – 您的 Atlassian 組織 ID。

    • 目錄 ID (UUID) – 您的 Atlassian 使用者目錄 ID。

    重要

    在其他設定中啟用文件層級存取控制 (ACLs) 需要 Atlassian 管理員憑證。如果沒有管理員登入資料，則會停用 ACL 選項。知識庫建立後，就無法新增管理員登入資料。如需取得這些登入資料的步驟，請參閱 取得 Atlassian 管理員登入資料。

  6. 選擇下一步。

  7. 完成出現的 Confluence Cloud 身分驗證快顯視窗。檢閱請求的許可，然後選擇接受以授權 Amazon Quick 存取您的 Confluence 內容。

建立知識庫

  1. 在建立知識庫下，輸入知識庫的名稱。

  2. （選用） 輸入描述，其中包含有關如何使用知識庫的備註。

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

    注意

    遵循結構的 URLs https://company.atlassian.net/wiki/spaces/space-key/overview會視為頁面 URLs，而非空格 URLs。若要為整個空間編製索引，請使用不含 的空間 URL /overview（例如 https://company.atlassian.net/wiki/spaces/space-key)。

  4. 選擇下一步：其他設定以設定存取控制和索引選項，或選擇建立以使用預設設定建立知識庫。

設定其他設定

  1. 若要啟用文件層級存取控制，請選取使用 ACLs控制文件存取。只有在您在身分驗證方法中提供 Atlassian 管理員登入資料時，才能使用此選項。啟用時，Amazon Quick 會從 Confluence 同步存取控制清單，並在查詢時驗證每個使用者的許可。如需存取控制如何運作的詳細資訊，請參閱 文件層級存取控制。

    如果您未啟用 ACLs，則會在知識庫層級控制存取。有權存取知識庫的任何人都可以從其中所有內容中取得洞見。啟用 ACLs時，會在文件層級控制存取。有權存取知識庫的使用者只會看到他們獲授權在 Confluence 中存取的文件的答案。

    重要

    建立知識庫後，無法變更 ACL 管理。如果您需要變更此設定，您必須建立新的知識庫。

    注意

    如果您未在身分驗證方法中提供 Atlassian 管理員登入資料，此選項會停用。若要啟用 ACLs，請選擇返回或取消精靈，然後使用包含管理員憑證的連線帳戶重新開始。

  2. 在多媒體內容、檔案大小和檔案格式下，視需要設定下列索引選項：

    • 文件中的視覺化內容 – 為內嵌在文件中的影像和圖表等視覺化內容編製索引。

    • 音訊檔案 – 為音訊檔案附件編製索引。

    • 影片檔案 – 為影片檔案附件編製索引。

    • 單一檔案大小上限 – 個別附件的檔案大小上限 （預設值：50 MB)。

  3. 選擇建立。

受支援的內容類型

  • Confluence 頁面和部落格文章

  • 頁面和部落格文章附件

當您新增 Confluence 空間 URL 時，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)。

ACL 相關問題

沒有啟用 ACL 知識庫的結果

  • 確認最終使用者在第一次查詢期間出現提示時已登入 Confluence。即時許可驗證需要登入。

  • 確認最終使用者有權存取其 Confluence 執行個體中的相關 Confluence 內容。

同步期間略過的文件

  • 如果同步報告顯示狀態為 SKIPPED 的項目，請確認驗證使用者可存取知識庫中包含的 Confluence 空間和頁面。

  • 如需驗證文件存取的詳細資訊，請參閱 檢查文件存取 (ACL 驗證）。