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

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

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

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

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

## 身分驗證
<a name="confluence-kb-auth-setup"></a>

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

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

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

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

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

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

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

1. 在**建立 Confluence 知識庫**對話方塊中的**連線帳戶**下，完成下列欄位：
   + **名稱** – 資料存取整合的描述性名稱。
   + **Confluence URL** – 您 Atlassian 網站的 URL （例如 `your-site.atlassian.net`)。

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

1. 在**建立知識庫**下，完成下列欄位：
   + **名稱** – 知識庫的名稱。
   + **描述** （選用） – 關於如何使用知識庫的備註。

1. 在**內容**下，貼上您要包含的 Confluence 空間、部落格或頁面URLs。選擇每個 URL 後的**新增**。
**注意**  
遵循結構的 URLs`https://company.atlassian.net/wiki/spaces/space-key/overview`會視為頁面 URLs。

1. 選擇**建立**。

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

## 存取控制
<a name="confluence-kb-access-controls"></a>

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

## 管理知識庫
<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`)。