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

# Atlassian Confluence 雲端知識庫整合
<a name="confluence-knowledge-base"></a>

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

## 開始之前
<a name="confluence-kb-prerequisites"></a>

在設定整合之前，請確定您有下列項目。
+ Atlassian Confluence 雲端執行個體。
+ 如需快速訂閱需求，請參閱 [在主控台中設定整合](integration-console-setup-process.md)。

如果您打算啟用文件層級存取控制，則必須在設定期間提供 Atlassian 管理員憑證。這些登入資料可讓 Amazon Quick 存取所有使用者和群組資訊，無論個別電子郵件可見性設定為何。如果沒有管理員登入資料，則在建立知識庫期間無法使用 ACL 選項。若要提供管理員登入資料，您需要 Atlassian 組織管理員提供下列項目：
+ **Atlassian 管理員 API 金鑰** – 在 Atlassian 管理員入口網站中產生的英數字串。
+ **組織 ID (UUID)** – 您 Atlassian 組織的唯一識別符。登入管理員入口網站時，您可以在瀏覽器 URL 中找到此項目：`admin.atlassian.com/o/orgId`。
+ **目錄 ID (UUID)** – 使用者目錄的唯一識別符。使用 Atlassian Admin Workspace API 擷取此值。

如需取得這些登入資料的詳細步驟，請參閱 [取得 Atlassian 管理員登入資料](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials)。

## 設定知識庫整合
<a name="confluence-kb-setup"></a>

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

### 驗證您的帳戶
<a name="confluence-kb-setup-auth"></a>

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

1. 在**知識**下，選擇 **Atlassian Confluence Cloud**，然後選擇新增 （加 "\$1") 按鈕。

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

1. 如果您要新增帳戶，請完成下列欄位：
   + **名稱** – 連線的描述性名稱。
   + **描述** （選用） – 有關連線的備註。
   + **Confluence URL** – 您 Atlassian 網站的 URL （例如 `https://your-site.atlassian.net`)。

1. （選用） 在 **ACL 管理**下，選取**使用 Atlassian 管理員登入**資料以提供 Atlassian 管理員登入資料。選取時，請輸入下列項目：
   + **API 金鑰** – Atlassian 管理員 API 金鑰。
   + **OrganizationID (UUID)** – 您的 Atlassian 組織 ID。
   + **目錄 ID (UUID)** – 您的 Atlassian 使用者目錄 ID。
**重要**  
在其他**設定**中啟用文件層級存取控制 (ACLs) 需要 Atlassian 管理員憑證。如果沒有管理員登入資料，則會停用 ACL 選項。知識庫建立後，就無法新增管理員登入資料。如需取得這些登入資料的步驟，請參閱 [取得 Atlassian 管理員登入資料](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials)。

1. 選擇**下一步**。

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

### 建立知識庫
<a name="confluence-kb-setup-create"></a>

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

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

1. 在 **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`)。

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

### 設定其他設定
<a name="confluence-kb-setup-settings"></a>

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

   如果您未啟用 ACLs，則會在知識庫層級控制存取。有權存取知識庫的任何人都可以從其中所有內容中取得洞見。啟用 ACLs時，會在文件層級控制存取。有權存取知識庫的使用者只會看到他們獲授權在 Confluence 中存取的文件的答案。
**重要**  
建立知識庫後，無法變更 ACL 管理。如果您需要變更此設定，您必須建立新的知識庫。
**注意**  
如果您未在**身分驗證方法**中提供 Atlassian 管理員登入資料，此選項會停用。若要啟用 ACLs，請選擇**返回**或取消精靈，然後使用包含管理員憑證的連線帳戶重新開始。

1. 在**多媒體內容、檔案大小和檔案格式**下，視需要設定下列索引選項：
   + **文件中的視覺化內容** – 為內嵌在文件中的影像和圖表等視覺化內容編製索引。
   + **音訊檔案** – 為音訊檔案附件編製索引。
   + **影片檔案** – 為影片檔案附件編製索引。
   + **單一檔案大小上限** – 個別附件的檔案大小上限 （預設值：50 MB)。

1. 選擇**建立**。

## 受支援的內容類型
<a name="confluence-kb-content-types"></a>
+ Confluence 頁面和部落格文章
+ 頁面和部落格文章附件

當您新增 Confluence 空間 URL 時，Amazon Quick 會編目該空間中的所有頁面和部落格文章。如需支援的附件檔案類型和大小限制，請參閱 [檔案大小和內容限制](knowledge-base-integrations.md#file-size-and-content-limits)。

## 管理知識庫
<a name="confluence-kb-management"></a>

### 編輯現有的知識庫
<a name="confluence-kb-edit"></a>

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

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

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

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

## 疑難排解
<a name="confluence-kb-troubleshooting"></a>

若要編輯、共用或刪除整合，請參閱 [管理現有的整合](integration-workflows.md#managing-existing-integrations)。

如需一般知識庫故障診斷，包括同步問題和遺失文件，請參閱 [故障診斷知識庫](troubleshooting-knowledge-bases.md)。

### 封鎖的 OAuth 應用程式授權
<a name="confluence-kb-troubleshooting-blocked-oauth"></a>

**徵狀：**
+ 錯誤訊息：「您的網站管理員必須為網站 *instance-name*.atlassian.net 授權此應用程式，應用程式才能存取您的帳戶。」
+ 在同意對話方塊中選擇**接受**不會有任何影響。

**原因：**

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

**解決步驟：**

使用下列其中一個選項來解決此問題。
+ **選項 1 （建議）：管理員直接授權應用程式**

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

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

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

  管理員授權應用程式後，網站上的所有其他使用者可以連線而不會發生問題。
+ **選項 2：暫時允許使用者安裝的應用程式** – 管理員前往 `admin.atlassian.com`，導覽至**應用程式**、**Atlassian 應用程式**，然後選擇第三方和 Marketplace 應用程式的連結。在**設定**下，尋找**使用者安裝的應用程式**並切換以允許使用者應用程式。在使用者授權 Amazon Quick 之後，將設定切換回封鎖使用者應用程式。

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

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

### 身分驗證快顯視窗失敗
<a name="confluence-kb-troubleshooting-auth-popup"></a>

**徵狀：**
+ 身分驗證快顯視窗不會立即顯示或關閉。
+ 隨即出現快顯視窗，但無法完成 OAuth 流程。

**解決步驟：**

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

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

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

### 知識庫中缺少內容
<a name="confluence-kb-troubleshooting-missing-content"></a>

**徵狀：**
+ 知識庫同步完成，但預期的內容不會編製索引。
+ 搜尋結果不包含來自特定空格或頁面的內容。
+ 只有一個文件會針對整個空間編製索引。

**解決步驟：**

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

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

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

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

### ACL 相關問題
<a name="confluence-kb-troubleshooting-acl"></a>

**沒有啟用 ACL 知識庫的結果**
+ 確認最終使用者在第一次查詢期間出現提示時已登入 Confluence。即時許可驗證需要登入。
+ 確認最終使用者有權存取其 Confluence 執行個體中的相關 Confluence 內容。

**同步期間略過的文件**
+ 如果同步報告顯示狀態為 SKIPPED 的項目，請確認驗證使用者可存取知識庫中包含的 Confluence 空間和頁面。
+ 如需驗證文件存取的詳細資訊，請參閱 [檢查文件存取 (ACL 驗證）](sync-reports-observability.md#sync-reports-acl-verification)。