适用于 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 以标识问题，并且可以修改各种字段，例如摘要、说明和分配对象。 |
| 更改问题状态 | 更改 Jira Cloud 中现有问题的状态。您需要提供问题 ID 来标识问题。 |
必需的范围
如需让 Gemini Enterprise 使用 Jira Cloud 数据存储区执行搜索和操作，您需要拥有以下范围：
如需让 Gemini Enterprise 使用 Jira Cloud 数据存储区执行搜索和操作，您需要拥有以下范围：
传统范围
| 连接模式 | 权限 | 用途 |
|---|---|---|
| 联合搜索和操作 | read:jira-user，read:jira-work |
允许助理实时提取和显示搜索结果及用户详细信息。 |
write:jira-work |
允许助理修改工作项（例如，更新问题字段）以及管理评论或问题。 | |
| 仅限联合搜索 | read:jira-user，read:jira-work |
允许助理搜索和查看问题、项目和用户个人资料。 |
| 数据注入和操作 | read:jira-work |
允许助理广泛抓取数据并将工作项编入索引。 |
write:jira-work |
允许助理在已注入的环境中对工作项执行写入操作（创建、更新、添加注释）。 | |
| 数据注入 | read:jira-work |
允许 Google 助理抓取 Jira 内容并将其编入索引以在搜索中使用。 |
精细范围
| 连接模式 | 权限 | 用途 |
|---|---|---|
| 联合搜索和操作 | write:comment:jira |
允许数据存储区直接从搜索界面发布新评论或回复。 |
write:issue:jira |
允许数据存储区创建新问题或对现有问题执行重大修改。 | |
write:attachment:jira |
允许数据存储区向 Jira 问题添加附件。 | |
read:issue:jira |
允许数据存储区读取问题。 | |
read:issue-type:jira |
允许数据存储区读取问题类型。 | |
read:comment:jira |
允许数据存储区读取评论。 | |
read:comment.property:jira |
允许数据存储区读取问题评论属性。 | |
read:project:jira |
允许数据存储区读取项目。 | |
read:priority:jira |
允许数据存储区读取优先级。 | |
read:issue.transition:jira |
允许数据存储区读取问题转换。 | |
read:issue-meta:jira |
允许数据存储区读取问题元数据。 | |
read:board-scope.admin:jira-software |
允许数据存储区读取看板的配置、项目功能、过滤器、属性和快速过滤器。 | |
read:board-scope:jira-software |
允许数据存储区读取看板、看板上的问题、积压工作中的问题、报告和版本。 | |
read:issue-details:jira |
允许数据存储区读取问题详细信息。 | |
read:jql:jira |
允许数据存储区读取 Jira 查询语言 (JQL) 查询。 | |
| 仅限联合搜索 | read:issue:jira |
允许数据存储区读取问题。 |
read:issue-type:jira |
允许数据存储区读取问题类型。 | |
read:comment:jira |
允许数据存储区读取评论。 | |
read:comment.property:jira |
允许数据存储区读取问题评论属性。 | |
read:project:jira |
允许数据存储区读取项目。 | |
read:priority:jira |
允许数据存储区读取优先级。 | |
read:issue.transition:jira |
允许数据存储区读取问题转换。 | |
read:issue-meta:jira |
允许数据存储区读取问题元数据。 | |
read:board-scope.admin:jira-software |
允许数据存储区读取看板的配置、项目功能、过滤器、属性和快速过滤器。 | |
read:board-scope:jira-software |
允许数据存储区读取看板、看板上的问题、积压工作中的问题、报告和版本。 | |
read:issue-details:jira |
允许数据存储区读取问题详细信息。 | |
read:jql:jira |
允许数据存储区读取 Jira 查询语言 (JQL) 查询。 | |
| 数据注入和操作 | 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:comment:jira |
允许使用数据存储区向问题添加评论。 | |
write:issue:jira |
允许助理创建或修改问题。 | |
| 数据注入 | 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 数据存储区仅在
global、us和eu位置受支持。
以下是 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 数据存储区。