组织使用 Atlassian 等敏捷项目管理平台 JIRA 使团队能够协作计划、跟踪和交付可交付成果。 Jira 在项目实施期间记录的问题和评论中捕获有关可交付成果运作的组织知识。 然而,让用户轻松、安全地获取这些知识具有挑战性,因为它分散在属于不同项目和冲刺的问题中。 此外,由于开发人员、测试工程师和项目经理等不同的利益相关者通过记录问题然后添加附件和评论来促成同一问题,因此在 Jira 项目中搜索信息时,传统的基于关键字的搜索会变得无效。
您现在可以使用 亚马逊肯德拉 Jira 云连接器用于索引 Jira 项目中的问题、评论和附件,并使用由机器学习 (ML) 提供支持的 Amazon Kendra 智能搜索来搜索此内容。
本文介绍如何使用 Amazon Kendra Jira 云连接器将 Jira 云实例配置为 Amazon Kendra 索引的数据源,并智能搜索其中的项目内容。 我们使用 Jira 项目的示例,其中团队成员通过创建问题并在整个问题生命周期中以描述、评论和附件的形式向问题添加信息来进行协作。
解决方案概述
一个 Jira 实例有一个或多个项目,每个项目都有团队成员处理该项目中的问题。 每个团队成员都拥有一组关于他们可以针对其所属项目中的不同问题执行的操作的权限。 团队成员可以创建新问题,或者以附件和评论的形式向问题添加更多信息,以及在为该项目定义的问题生命周期中更改问题从打开到关闭的状态。 项目经理创建冲刺,将问题分配给特定的冲刺,并将所有者分配给问题。 在项目过程中,在这些问题中捕获的知识不断发展。
在我们的解决方案中,我们使用 Amazon Kendra Jira 连接器将 Jira 云实例配置为 Amazon Kendra 搜索索引的数据源。 根据配置,当数据源同步时,连接器会从 Jira 实例中的项目中抓取内容并建立索引。 或者,您可以将其配置为根据更改日志对内容进行索引。 连接器还收集并获取每个问题、评论和附件的访问控制列表 (ACL) 信息。 ACL 信息用于用户上下文过滤,其中查询的搜索结果根据用户有权访问的内容进行过滤。
先决条件
要使用本文作为参考来尝试适用于 Jira 的 Amazon Kendra 连接器,您需要具备以下条件:
- An AWS账户 具有创建权限 AWS身份和访问管理 (IAM) 角色和策略。 有关详细信息,请参阅 访问管理概述:权限和策略 和 Jira 数据源策略.
- AWS 的基本知识和 Jira 管理的工作知识。
- 对 Jira 云实例的管理员访问权限。
Jira实例配置
本部分介绍 Jira 配置,用于演示如何使用 Jira 连接器配置 Amazon Kendra 数据源、将 Jira 项目中的数据提取到 Amazon Kendra 索引中以及进行搜索查询。 您可以使用您拥有管理员访问权限的自己的 Jira 实例,也可以创建一个新项目并执行以下步骤来尝试适用于 Jira 的 Amazon Kendra 连接器。
在我们的示例 Jira 实例中,我们创建了两个项目来演示用户发出的搜索查询仅返回他们有权访问的项目的结果。 我们使用以下公共领域项目的数据来模拟现实软件开发项目的用例:
以下是项目 1 的看板式看板的屏幕截图。
为 Jira 实例创建 API 令牌
要获取配置 Amazon Kendra Jira 连接器所需的 API 令牌,请完成以下步骤:
- 登录到 https://id.atlassian.com/manage/api-tokens.
- 创建 API 令牌.
- 在出现的对话框中,输入令牌的标签并选择 创建.
- 复制 并在临时记事本上输入令牌。
您无法再次复制此令牌,并且需要它来配置 Amazon Kendra Jira 连接器。
使用适用于 Jira 的 Amazon Kendra 连接器配置数据源
要使用 Jira 连接器将数据源添加到 Amazon Kendra 索引,您可以使用现有索引或 创建一个新索引。 然后完成以下步骤。 有关此主题的更多信息,请参阅 Amazon Kendra 开发人员指南.
- 在 Amazon Kendra 控制台上,打开您的索引并选择 资料来源 在导航窗格中。
- 添加数据源.
- 下 JIRA,选择 添加连接器.
- 在 指定数据源详细信息 部分,输入数据源的详细信息并选择 下一页.
- 在 定义访问和安全性 部分,用于 Jira 帐户网址,输入您的 Jira 云实例的 URL。
- 下 认证,您有两种选择:
- 创建 使用从 Jira 实例复制的 Jira API 令牌添加新密钥,并使用用于登录 Jira 的电子邮件地址作为 Jira ID。 (这是我们为这篇文章选择的选项。)
- 使用现有的 AWS机密管理器 包含您希望连接器访问的 Jira 实例的 API 令牌的密钥。
- 针对 IAM角色,选择 创建一个新角色 或选择配置了适当 IAM 策略的现有 IAM 角色来访问 Secrets Manager 密钥、Amazon Kendra 索引和数据源。
- 下一页.
- 在 配置同步设置 部分,提供有关您的同步范围和运行计划的信息。
- 下一页.
- 在 设置字段映射 部分,您可以选择配置字段映射,或如何将 Jira 字段名称映射到 Amazon Kendra 属性或构面。
- 下一页.
- 检查您的设置并确认添加数据源。
- 添加数据源后,选择 资料来源 在导航窗格中,选择新添加的数据源,然后选择 立即同步 开始与 Amazon Kendra 索引的数据源同步。
同步过程可能需要大约 10-15 分钟。 现在让我们为 Amazon Kendra 索引启用访问控制。 - 在导航窗格中,选择您的索引。
- 在中间窗格中,选择 用户访问控制 标签。
- 编辑设置 并将设置更改为如下图所示。
- 下一页 然后选择 更新.
使用 Amazon Kendra 执行智能搜索
在您尝试在 Amazon Kendra 控制台上搜索或使用 API 之前,请确保数据源同步已完成。 要检查,请查看数据源并验证上次同步是否成功。
- 要开始搜索,请在 Amazon Kendra 控制台上,选择 搜索索引内容 在导航窗格中。
您将被重定向到 Amazon Kendra 搜索控制台。 - 扩大 使用访问令牌测试查询 并选择 申请令牌.
- 针对 用户名,输入与您的 Jira 帐户关联的电子邮件地址。
- 使用.
现在我们准备好搜索索引了。 让我们使用查询“boto3 在哪里存储安全令牌?”
在这种情况下,Kendra 从我们 Jira 上的看板项目中的一张卡片中提供了建议的答案。
请注意,这也是针对讨论 AWS 安全令牌和 Boto3 的问题的建议答案。 您还可以使用多个数据源(包括 SDK 文档和 wiki)与 Amazon Kendra 构建搜索体验,并相应地呈现结果和相关链接。 以下屏幕截图显示了针对同一索引进行的另一个搜索查询。
请注意,当我们应用不同的访问令牌(将搜索与不同的用户关联)时,搜索结果将仅限于该用户有权访问的项目。
最后,我们还可以在搜索中使用与 Jira 相关的过滤器。 首先,我们导航到索引 构面定义 页面并检查 面表 j_status
, j_assignee
及 j_project_name
。 对于每个搜索,我们都可以按这些字段进行过滤,如下面的屏幕截图所示。
清理
为了避免产生未来成本,请清理您在此解决方案中创建的资源。 如果您在测试此解决方案时创建了新的 Amazon Kendra 索引,请将其删除。 如果您仅使用适用于 Jira 的 Amazon Kendra 连接器添加了新数据源,请删除该数据源。
结论
借助 Amazon Kendra Jira 连接器,您的组织可以使用 Amazon Kendra 支持的智能搜索安全地向用户提供 Jira 项目中的宝贵知识。
要了解有关 Amazon Kendra Jira 连接器的更多信息,请参阅 亚马逊 Kendra Jira 连接器 Amazon Kendra 开发人员指南的部分.
有关流行数据源的其他 Amazon Kendra 内置连接器的更多信息,请参阅 使用 Amazon Kendra Slack 连接器通过智能搜索解开 Slack 工作区中的知识 和 使用适用于 Amazon Kendra 的 Quip 连接器通过智能搜索在 Quip 文档中搜索知识.
作者简介
史瑞亚斯·苏布拉曼尼亚 是 AI/ML 专家解决方案架构师,通过使用机器学习帮助客户解决他们在 AWS 云上的业务挑战。
阿比纳夫·贾瓦德卡(Abhinav Jawadekar) 是 AWS 的 AI/ML 语言服务团队中专注于 Amazon Kendra 的首席解决方案架构师。 Abhinav 与 AWS 客户和合作伙伴合作,帮助他们在 AWS 上构建智能搜索解决方案。
- "
- 100
- 420
- 关于我们
- ACCESS
- 因此
- 账号管理
- 横过
- 地址
- 管理员
- 管理
- 敏捷
- Amazon
- 另一个
- 回答
- API
- 适当
- 律师
- 属性
- 可使用
- AWS
- 作为
- 板
- 边界
- 盒子
- 建立
- 内建的
- 商业
- 捕获
- 牌
- 携带
- 挑战
- 挑战
- 更改
- 关闭
- 云端技术
- 合作
- 注释
- 社体的一部分
- 配置
- 安慰
- 内容
- Contents
- 贡献
- 控制
- 成本
- 创建信息图
- 创建
- 创建
- 创造
- 合作伙伴
- data
- 演示
- 详情
- 开发商
- 开发
- 研发支持
- 不同
- 文件
- 域
- ,我们将参加
- 容易
- 邮箱地址
- enable
- 工程师
- 输入
- 演变
- 例子
- 现有
- 体验
- 字段
- 过滤
- 过滤器
- 姓氏:
- 重点
- 以下
- 申请
- 未来
- GitHub上
- 帮助
- 帮助
- 创新中心
- How To
- 但是
- HTTPS
- 身分
- 履行
- 包含
- 指数
- 信息
- 智能化
- 问题
- 问题
- IT
- 知识
- 语言
- 学习用品
- 学习
- 自学资料库
- 链接
- 清单
- 机
- 机器学习
- 制成
- 制作
- 颠覆性技术
- 经理
- 经理
- 会员
- 成员
- ML
- 更多
- 多
- 名称
- 旅游导航
- 打开
- 开放
- 运营
- 附加选项
- 附加选项
- 组织
- 组织
- 其他名称
- 己
- 业主
- 部分
- 伙伴
- 平台
- 政策
- 热门
- 当下
- 校长
- 过程
- 项目
- 项目管理
- 项目
- 提供
- 提供
- 国家
- 相应
- 资源
- 成果
- 回报
- 运行
- SDK
- 搜索
- 安全
- 保安
- 安全令牌
- 特色服务
- 集
- 如图
- 松弛
- 软件
- 软件开发
- 固体
- 方案,
- 解决方案
- 解决
- 专家
- 开始
- Status
- 商店
- 成功
- 团队
- 临时
- test
- 测试
- 始终
- 象征
- 令牌
- 跟踪时
- 传统
- 使用
- 用户
- 确认
- 查看
- 什么是
- 而
- 加工
- 合作