View a markdown version of this page

Atlassian Confluence 云知识库集成 - Amazon Quick
开始前的准备工作身份验证设置知识库集成受支持的内容类型访问控制管理知识库故障排除

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

Atlassian Confluence 云知识库集成

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

开始前的准备工作

在设置集成之前，请确保您具备以下条件。

身份验证

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

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

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

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

设置知识库集成

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

  2. 选择 Atlassian Confluence Cloud，然后选择添加（加上 “+”）按钮。

  3. 在 “创建 Confluence 知识库” 对话框的 “已连接帐户” 下，填写以下字段：

    • 名称-数据访问集成的描述性名称。

    • Confluence 网址 — 您的 Atlassian 网站的网址（例如，）。your-site.atlassian.net

  4. 选择 “登录”，然后在弹出窗口中完成 Confluence Cloud 身份验证流程。

  5. 在 “创建知识库” 下，填写以下字段：

    • 名称-知识库的名称。

    • 描述（可选）-有关如何使用知识库的说明。

  6. 在 “内容” 下，粘贴要包含的 Confluence 空间、博客或页面。 URLs 在每个 URL 之后选择 “添加”。

    注意

    URLs 遵循结构的内容https://company.atlassian.net/wiki/spaces/space-key/overview被视为页面 URLs。

  7. 选择创建。

受支持的内容类型

  • Confluence 页面和博客文章

  • 空间内容

  • 页面和博客附件

访问控制

重要

Amazon Quick 不会同步来自数据源的访问控制列表 (ACLs)。默认情况下，当你在 Amazon Quick 中创建知识库时，只有你才能从知识库中获得见解。对于共享内容，您可以通过更新知识库权限为不同的用户和群组提供访问权限。

管理知识库

编辑现有知识库

  1. 在 Amazon Quick 控制台中，选择知识库。

  2. 从列表中选择你的 Confluence 云知识库。

  3. 选择 “操作” 下的三点图标，然后选择 “编辑知识库”。

  4. 根据需要更新您的配置设置，然后选择保存。

故障排除

要编辑、共享或删除您的集成，请参阅管理现有集成。

有关一般知识库疑难解答（包括同步问题和文档丢失），请参阅故障排除知识库。

已屏蔽的 OAuth 应用程序授权

症状：

  • 错误消息：“您的网站管理员必须先为 instance-name .atlassian.net 网站授权此应用程序，然后该应用程序才能访问您的帐户。”

  • 在同意对话框中单击 “接受” 无效。

原因：

您的 Atlassian 站点管理员已屏蔽用户 OAuth 安装的应用程序。启用此设置后，只有站点或组织管理员才能授权新的第三方应用程序。

解决步骤：

使用以下选项之一来解决此问题。

  • 选项 1（推荐）：管理员直接授权应用程序

    1. Atlassian 站点管理员导航到 Amazon Quick，然后使用 Confluence Cloud 开始新的知识库设置。

    2. 由于管理员拥有站点级别的权限，因此会出现一个没有错误的干净同意屏幕。

    3. 管理员选择 “接受” 安装应用程序。

    管理员授权该应用程序后，网站上的所有其他用户都可以毫无问题地进行连接。

  • 选项 2：暂时允许用户安装应用程序 — 管理员前往 “应用程序” admin.atlassian.com、“Atlassian 应用程序”，然后选择第三方和 Mar ketplace 应用程序的链接。在 “设置” 下，找到 “用户安装的应用程序”，然后切换到允许用户使用应用程序。用户授权 Amazon Quick 后，将该设置切换回屏蔽用户应用程序。

重要

管理员授权适用于每个 Atlassian 站点，而不是每个组织。如果您的公司有多个站点（例如team-a.atlassian.net和team-b.atlassian.net），则每个站点都需要单独授权。

注意

当用户安装的应用程序处于解锁状态（选项 2）时，网站上的任何用户都可以授权任何 OAuth 应用程序。用户连接后立即重新启用屏蔽。

身份验证弹出窗口失败

症状：

  • 身份验证弹出窗口不会立即出现或关闭。

  • 弹出窗口出现，但无法完成 OAuth流程。

解决步骤：

  1. 确认您的浏览器允许来自 Amazon Quick 控制台域的弹出窗口。

  2. 确认您的网络可以访问您的 Confluence 云实例。

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

知识库中缺少内容

症状：

  • 知识库同步已完成，但未对预期内容编制索引。

  • 搜索结果不包括来自特定空间或页面的内容。

  • 整个空间中只有一个文档被编入索引。

解决步骤：

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

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

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

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