Gemini Enterprise 的 Jira Cloud 连接器可让您访问 Jira Cloud 数据，从而与项目、问题和用户信息进行互动。
支持的 Jira Cloud 版本
Jira Cloud 连接器支持第 2 版 Jira Cloud REST API。
支持的操作
启用 Jira Cloud 连接器后，最终用户可以在 Gemini Enterprise 中使用自然语言命令执行以下操作。
| 操作 | 说明 |
|---|---|
| 创建评论 | 在指定的 Jira 问题上创建新评论，以添加反馈、更新或备注。 |
| 更新评论 | 修改现有评论的文本。 |
| 创建问题 | 在 Jira Cloud 项目中创建新问题。如需创建问题，您需要提供摘要、项目 ID 和问题类型 ID。 |
| 更新问题 | 更新 Jira Cloud 中的现有问题。您需要提供问题 ID 以标识问题，并且可以修改各种字段，例如摘要、说明和受让人。 |
除了上述操作之外，您还可以执行其他只读操作。
必需的范围
如需让 Gemini Enterprise 使用 Jira Cloud 数据存储区执行搜索和操作，您需要以下范围：
| 连接模式 | 范围 | 用途 |
|---|---|---|
| 联合搜索和操作 | read:jira-user，read:jira-work |
需要此权限才能实时提取和显示搜索结果及用户详细信息。 |
write:jira-work |
允许助理修改工作项（例如，更新问题字段）。 | |
write:comment:jira |
使助理能够直接从搜索界面发布新评论或回复。 | |
write:issue:jira |
创建新问题或对现有问题进行重大修改时需要此权限。 | |
| 仅限联合搜索 | read:jira-user，read:jira-work |
用于搜索和查看问题、项目和用户个人资料。 |
| 数据提取和操作 | read:jira-work、read:user:jira、read:group:jira、read:avatar:jira |
需要此权限才能进行大规模数据注入和同步用户/群组元数据。 |
read:issue-security-level:jira，read:issue-security-scheme:jira |
对于访问权限控制至关重要；确保提取的数据遵守 Jira 的安全边界。 | |
read:audit-log:jira |
用于跟踪更改并执行增量同步，以确保提取的数据保持最新状态。 | |
write:jira-work |
必须在已提取的环境中对工作项执行写入操作。 | |
write:comment:jira |
使用助理向问题添加评论时需要。 | |
write:issue:jira |
允许创建或修改问题。 | |
| 数据注入 | read:jira-work、read:user:jira、read:group:jira、read:avatar:jira |
需要此权限才能抓取 Jira 内容和用户关系并将其编入索引。 |
read:issue-security-level:jira，read:issue-security-scheme:jira |
需要映射权限，以便只有授权用户才能搜索提取的数据。 | |
read:audit-log:jira |
同步引擎需要此属性来确定哪些项已更新或删除。 |
如需了解如何配置这些范围，请参阅配置最小应用范围。
数据注入的速率限制
Jira Cloud 连接器支持默认的数据注入速率限制，即每秒 12 次查询 (QPS)。这些速率限制仅适用于通过 Jira Cloud 连接器提取数据。
限制
本部分概述了可能会影响您使用 Jira Cloud 连接器的已知问题和限制。
不支持对现有的 Jira Cloud 数据存储区强制执行 VPC Service Controls 边界。如需强制执行 VPC Service Controls，您必须删除并重新创建数据存储区。如需详细了解 VPC Service Controls 以及如何在启用 VPC Service Controls 后使用操作，请参阅使用 VPC Service Controls 保护应用。
Jira Cloud 数据存储区仅在全球、美国和欧盟位置受支持。
创建新应用或向现有应用添加数据存储区时，我们建议您添加包含属于单一连接器类型的操作的数据存储区。例如，请勿将两个已启用操作的 Jira Cloud 数据存储区与同一应用相关联。
以下是 Jira Cloud 提取连接器的限制：
对于非结构化数据，每种媒体类型都有不同的限制。如需了解详情，请参阅为自定义数据源准备数据。
对于结构化数据，每个文档的大小不得超过 500 KB。
具有特定（非空）角色的应用角色无法获授
Browse project或安全级别权限。不支持通过用户自定义字段或群组自定义字段定义的文档权限。
Jira Cloud 不允许在工作日志级别施加任何限制。
Jira Cloud 不会将超过 2,000 页的 PDF 附件编入索引。
添加到不公开评论中的附件不会继承评论的访问限制 (ACL)。
系统只会提取 Jira Cloud 中问题的前 20 条评论。
无法注入 Sprint 表。
旧版用户管理模型不支持与 Jira Cloud 集成。仅支持集中式用户管理模型。如需了解详情，请参阅 Atlassian 组织整合指南。
查询 Jira 实体（例如事务）时，相关数据（例如评论和附件）不会自动包含在内。这是因为它们是作为单独的实体存储和编入索引的。不支持根据附件的内容进行搜索以查找父问题。
后续步骤
- 如需创建和配置与 Jira Cloud 的连接器，请参阅设置 Jira Cloud 数据存储区。