本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Atlassian Confluence 云知识库集成
<a name="confluence-knowledge-base"></a>

使用 Atlassian Confluence Cloud 知识库集成为 Confluence 内容编制索引，这样 Amazon Quick 代理就可以搜索和回答有关该内容的问题。

## 开始前的准备工作
<a name="confluence-kb-prerequisites"></a>

在设置集成之前，请确保您具备以下条件。
+ Atlassian 融合云。
+ 有关订阅要求，请参阅[在控制台中设置集成](integration-console-setup-process.md)。

## 身份验证
<a name="confluence-kb-auth-setup"></a>

对于知识库集成，Amazon Quick 在设置过程中通过弹出式流程处理身份验证。完成以下步骤。

1. 完成出现的 Confluence 云身份验证弹出窗口。

1. 授予 Amazon Quick 访问您的 Confluence 内容的权限。

1. 查看并完成身份验证过程。

## 设置知识库集成
<a name="confluence-kb-setup"></a>

1. 在 Amazon Quick 控制台中，选择**集成。**

1. 选择 **Atlassian Confluence Cloud**，然后选择添加（加上 “\$1”）按钮。

1. 在 “**创建 Confluence 知识库**” 对话框的 “**已连接帐户**” 下，填写以下字段：
   + **名称**-数据访问集成的描述性名称。
   + **Confluence 网址** — 您的 Atlassian 网站的网址（例如，）。`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 页面和博客文章
+ 空间内容
+ 页面和博客附件

## 访问控制
<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 云知识库。

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 **应用程序**”，然后选择第三方和 Mar** ketplace 应用程序的链接。在 **“设置”** 下，找到 “**用户安装的应用程序**”，然后切换到允许用户使用应用程序。用户授权 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 云实例。

1. 尝试使用其他浏览器或清除浏览器缓存。

### 知识库中缺少内容
<a name="confluence-kb-troubleshooting-missing-content"></a>

**症状：**
+ 知识库同步已完成，但未对预期内容编制索引。
+ 搜索结果不包括来自特定空间或页面的内容。
+ 整个空间中只有一个文档被编入索引。

**解决步骤：**

1. 验证通过身份验证的 Confluence Cloud 用户是否可以访问您在设置期间选择的空间和页面。

1. 检查所选内容类型是否受支持（页面、博客文章和附件）。

1. 查看知识库配置中的内容选择，确认包含的空格和页面是否正确。

1. 检查你的 Confluence 是否 URLs 有后`/overview`缀。 URLs 以结尾的`/wiki/spaces/space-key/overview`会被视为单页 URL，而不是完整空格。如果您打算索引整个空间，请使用不带索引的空间 URL`/overview`（例如，`https://company.atlassian.net/wiki/spaces/space-key`）。