提升您的客户支持和项目管理团队的生产力，使用 Amazon Q Business 和 Atlassi

提升客户支持与项目管理团队的生产力

利用 Amazon Q Business 和 Atlassian Jira

关键要点

文章重点概述：

有效的客户支持和项目管理是良好客户关系管理的关键。Atlassian Jira 是软件项目中问题跟踪与项目管理的主要平台，但从中提取有价值的见解往往需要人工努力和定制工具。生成式 AI 能够从数据源中提取相关信息并提供准确的回答，为支持团队提供决策支持。

在提高客户支持和项目管理的效率上， Atlassian Jira 成为许多组织工作流程中不可或缺的一部分。它助力软件项目的成功，确保客户服务的卓越。然而，从 Jira 中庞大的数据提取有价值的见解通常需要人工操作和构建专门工具。支持工程师、项目经理和产品经理需要问询有关项目、问题或客户的信息，以便更好地满足客户需求。生成式 AI 能从数据源中提取相关信息，提供精准的回答。

surfshark国内使用教程

构建一个集成相关数据源的生成式 AI 聊天应用需要耗费时间、金钱和人力。首先，需要构建与数据源的连接器；接着，需要对数据进行索引，以便于采用检索增强生成RAG方式高效准确地向大型语言模型LLM提供相关段落。这要求选择一个能够进行语义和向量搜索的索引，并建立基础设施以检索和排名答案，同时还需打造功能丰富的网络应用。

Amazon Q Business 是一款全托管的生成式 AI 助手，能够回答问题、提供摘要、生成内容，并根据企业系统中的数据和信息安全地完成任务。Amazon Q Business 可快速为您提供迫切问题的相关答案，解决问题，生成内容，并利用您公司信息库中的数据开展行动如 Jira 等。Amazon Q 提供了即插即用的原生数据源连接器，可以将内容索引到内置检索器中，并使用大型语言模型LLM提供准确且优质的回答。

使用 Amazon Q Business 从 Jira 中找到准确答案

集成 Amazon Q Business 与 Jira 后，用户可以在文档描述中提问，从而支持多个使用场景：

应用场景说明自然语言搜索用户可以使用对话语言搜索任务、问题或其他与项目相关的信息，使查找数据变得简单，不再需要记住特定的关键词或筛选条件。总结用户可以请求与搜索查询匹配的所有问题、任务或其他实体的简明摘要，使他们能够迅速把握重点。查询澄清如果用户的查询模糊或缺乏足够的上下文，Amazon Q Business 会通过对话确认意图，以确保用户获得最相关和准确的结果。

Amazon Q Business 的 Jira 连接器概述

要爬取和索引 Jira 中的内容，可以将 Amazon Q Business Jira 连接器配置为您的 Amazon Q 业务应用中的数据源。当您将 Amazon Q Business 连接到数据源并启动同步过程时，Amazon Q Business 会从数据源中爬取和索引文件。

文件类型

在 Amazon Q Business 中，文件是数据的单元。我们来了解在 Amazon Q Business Jira 连接器的上下文中，什么被视为文件。一个 文件 是一组信息，包括标题、内容或主体、元数据关于文件的数据和访问控制列表ACL信息，以确保答案来自用户拥有访问权限的文件。

Amazon Q Business Jira 连接器支持爬取以下 Jira 中的实体：

项目 每个项目被视为单个文件问题 每个问题被视为单个文件评论 每条评论被视为单个文件附件 每个附件被视为单个文件工时记录 每个工时记录被视为单个文件

此外，Jira 用户可以创建自定义对象和自定义元数据字段。Amazon Q 支持对这些自定义对象和自定义元数据进行爬取和索引。

Amazon Q Business Jira 连接器还支持从 Jira 各个实体索引丰富的元数据集，并提供将这些源元数据字段映射到 Amazon Q 索引字段的能力。这些字段映射使您能够将 Jira 字段名称映射到 Amazon Q 索引字段名称。Amazon Q 连接器支持三种类型的元数据字段：

默认字段 这是每个文档所需的，例如标题、创建日期、作者等。可选字段 由数据源提供。管理员可以选择一个或多个这些字段，以获取准确的答案。自定义元数据字段 这些字段是在数据源中创建的，除了数据源本身提供的外。

有关更多信息，请参阅 Jira 数据源连接器字段映射。

身份验证

在索引来自 Jira 的内容之前，您需要在 Amazon Q Business 连接器与您的 Jira 云实例之间建立安全连接。要建立安全连接，您需要对数据源进行身份验证。您可以使用 Jira ID 和 Jira API 令牌，通过基本身份验证将 Amazon Q Business 验证到 Jira。

要使用基本身份验证，请使用 AWS Secrets Manager 创建一个包含您的 Jira ID 和 Jira API 令牌的秘密。如果使用 AWS 管理控制台，您可以选择创建新秘密或使用现有的秘密。如果使用 API，则在使用 CreateDataSource 操作时，必须提供现有秘密的 Amazon 资源名称ARN。

有关创建和管理 Jira 中 API 令牌的更多信息，请参阅 为您的 Atlassian 账户管理 API 令牌。

安全查询

安全查询是确保用户仅从有权访问的文档中接收答案的重要功能。Amazon Q Business 通过两步流程实施此安全措施。首先，它对与每个文档关联的 ACL 进行索引。这种索引对数据安全至关重要，因为任何没有 ACL 的文档都被视为公共文档。其次，当发出查询时，系统同时考虑用户的凭据通常是他们的电子邮件地址和查询内容。这一双重检查机制确保结果不仅与查询相关，而且仅限于用户有权限查看的文档。

如需索引没有 ACL 的文档，您必须确保这些文档在数据源中显式标记为公共文档。有关使文档公开访问的更多信息，请参见 允许匿名访问项目。有关如何爬取 Jira ACL 的更多信息，请参阅 如何 Amazon Q 业务连接器爬取 Jira ACLs。

解决方案概述

在本文中，我们将逐步演示如何为 Amazon Q Business 应用配置 Jira 连接器。我们将使用现有的 Amazon Q 应用程序并配置 Jira 连接器，从特定的 Jira 项目和问题类型同步数据，映射相关的 Jira 字段到 Amazon Q 索引，并随后使用 Amazon Q 的 Web 界面查询已摄取的 Jira 数据。

在使用 Amazon Q Business 应用查询 Jira 文件时，我们将演示如何在 Jira 问题、项目及其他问题类型上提问自然语言问题，并利用 Amazon Q Business 获得相关结果和见解。

前提条件

您需要具备以下内容：

一个 Amazon Q Business 应用。如果尚未创建，请参考 使用 Amazon Q Business 和 AWS IAM 身份中心构建私有和安全的企业生成式 AI 应用 获取指导。Jira API 令牌身份验证凭证，包括 Jira ID带域的电子邮件 ID和 Jira 凭证Jira API 令牌。请参见 为您的 Atlassian 账户管理 API 令牌 获取关于如何创建 API 令牌的指导。如果您打算仅对特定项目进行爬取，请记下 Jira 账户 URL 例如，https//companyatlassiannet/和 Jira 项目键 ID 来自 Jira 项目设置。如果您是首次创建 Jira 账户，请参见 为连接到 Amazon Q 设置 Jira。对 Secrets Manager 的访问权限。创建新的 Amazon Q 应用或为现有应用添加数据源、AWS 资源，以及 AWS 身份与访问管理IAM角色和策略的权限。

为 Amazon Q Business 应用配置 Jira 连接器

请完成以下步骤配置连接器：

在 Amazon Q Business 控制台中，导航到导航面板上的 应用程序。选择您希望添加 Jira 连接器的应用。在 操作 菜单中，选择 编辑。

在 更新应用程序 页面上，保持所有值为默认值，然后选择 更新。

在 更新检索器 页面上，保持所有值为默认值，然后选择 下一步。

在 连接数据源 页面上，在 所有 选项卡中，搜索 Jira。选择 Jira 连接器上的加号。

在 名称和描述 部分，输入名称和描述。在 源 部分，输入您公司的 Jira 账户 URL，以 https//yourcompanyatlassiannet/ 形式。

在 身份验证 部分，选择 创建并添加新秘密。为您的 Secrets Manager 秘密输入名称。对于 Jira ID，输入 API 令牌的用户名。对于 密码/令牌，输入 API 令牌的详细信息。选择 保存。

有关如何创建 API 令牌的详细信息，请参见 为您的 Atlassian 账户管理 API 令牌。

在 IAM 角色 部分，对于 IAM 角色，选择 创建一个新的服务角色推荐。

在 同步范围 部分，您可以选择 所有项目 或 仅特定项目。默认情况下，Jira 连接器会索引来自项目的所有内容。您可以选择仅同步特定 Jira 实体，选择适当的选项在 附加配置 下。

在 同步模式 部分，选择 新创建、已修改或已删除内容同步。

在 同步运行计划 部分，选择您希望的频率。对于这篇文章，选择 按需运行。选择 添加数据源，等待检索器创建。

数据源创建后，您将被重定向到 连接数据源 页面，以根据需要添加更多数据源。

对于本次演示，选择 下一步。在 更新组和用户 页面，选择 添加组和用户。

您在这一部分添加的用户和组来自于 AWS IAM 身份中心 并由您的管理员设置。

在 添加或分配用户和组 弹出窗口中，选择 分配现有用户和组，以添加在连接的 IAM 身份中心中配置的现有用户。若您具备添加用户的权限，也可选择 添加新用户。选择 下一步。

在 分配用户和组 弹出窗口中，根据用户显示名称或组名称搜索用户。选择您希望添加的用户或组，然后选择 分配。

这将关闭弹出窗口。您添加的组和用户现在应该在 组 或 用户 标签中可见。

对于每个组或用户条目，必须分配 Amazon Q Business 订阅层级。

若要启用组的订阅，在 更新组和用户 页面上，选择 组如果需要为单个用户分配订阅，请选择 用户 标签。在 当前订阅 列中，选择 选择订阅 并选择一个订阅Q Business Lite 或 Q Business Pro。选择 更新应用 完成添加和设置 Amazon Q Business 的 Jira 数据连接器。

配置 Jira 字段映射

为了帮助您构建数据的检索和聊天过滤格式，Amazon Q Business 将数据源文档属性或元数据爬取，并映射到您的 Amazon Q 索引中的字段。Amazon Q 保留了一些字段，以在查询您的应用时使用。当可能时，Amazon Q 会自动将这些内置字段映射到您数据源中的属性。

如果内置字段没有默认映射，或者希望映射额外的索引字段，可以使用自定义字段映射指定数据源属性如何映射到您的 Amazon Q 应用。

在 Amazon Q Business 控