Jira

Jira 是一个领先的项目管理和问题跟踪平台，帮助团队有效地规划、跟踪和管理敏捷软件开发项目。作为 Atlassian 套件的一部分，Jira 已成为全球软件开发团队和项目管理专业人士的行业标准。

Jira 提供了一套全面的工具，通过其灵活且可定制的工作流系统来管理复杂项目。凭借其强大的 API 和集成能力，Jira 使团队能够简化开发流程，并保持对项目进度的清晰可见性。

Jira 的主要功能包括：

敏捷项目管理：支持 Scrum 和 Kanban 方法论，提供可定制的看板和工作流
问题跟踪：复杂的跟踪系统，用于管理缺陷、用户故事、史诗和任务，并提供详细报告
工作流自动化：强大的自动化规则，用于简化重复性任务和流程
高级搜索：JQL（Jira 查询语言）支持复杂问题过滤和报告

在 Kaizen 中，Jira 集成允许您的代理无缝地与您的项目管理工作流互动。这为自动化问题创建、更新和跟踪提供了可能性，作为您的 AI 工作流的一部分。该集成使代理能够以编程方式创建、检索和更新 Jira 问题，从而促进自动化项目管理任务，确保重要信息得到妥善跟踪和记录。通过将 Kaizen 与 Jira 连接，您可以构建智能代理，在自动化日常项目管理任务的同时保持项目的可见性，提高团队生产力，并确保一致的项目跟踪。

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`projectId`	字符串	否	Jira 项目 ID (可选；检索单个问题时不需要)。
`issueKey`	字符串	是	要检索的 Jira 问题键 (例如：PROJ-123)
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	包含问题键、摘要、描述、创建和更新时间戳的 Jira 问题详细信息

`jira_update`

更新 Jira 问题

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`projectId`	字符串	否	要更新问题的 Jira 项目 ID。如果未提供，将检索所有问题。
`issueKey`	字符串	是	要更新的 Jira 问题键
`summary`	字符串	否	问题的新摘要
`description`	字符串	否	问题的新描述
`status`	字符串	否	问题的新状态
`priority`	字符串	否	问题的新优先级
`assignee`	字符串	否	问题的新负责人
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	更新的 Jira 问题详情，包括时间戳、问题键、摘要和成功状态

`jira_write`

编写一个 Jira 问题

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`projectId`	字符串	是	问题的项目 ID
`summary`	字符串	是	问题的摘要
`description`	字符串	否	问题的描述
`priority`	字符串	否	问题的优先级
`assignee`	字符串	否	问题的负责人
`cloudId`	字符串	否	实例的 Jira 云 ID。如果未提供，将使用域名获取。
`issueType`	字符串	是	要创建的问题类型 (例如：任务、故事)

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	创建的 Jira 问题详情，包括时间戳、问题键、摘要、成功状态和 URL

`jira_bulk_read`

批量检索多个 Jira 问题

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`projectId`	字符串	是	Jira 项目 ID
`cloudId`	字符串	否	Jira 云 ID

输出

参数	类型	描述
`success`	boolean	操作成功状态
`output`	array	包含 Jira 问题的数组，包括摘要、描述、创建和更新的时间戳

`jira_delete_issue`

删除 Jira 问题

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	要删除的 Jira 问题键 (例如：PROJ-123)
`deleteSubtasks`	布尔值	否	是否删除子任务。如果为 false，则无法删除具有子任务的父问题。
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	删除的问题详情，包括时间戳、问题键和成功状态

`jira_assign_issue`

将 Jira 问题分配给用户

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	要分配的 Jira 问题键 (例如：PROJ-123)
`accountId`	字符串	是	要分配问题的用户的账户 ID。使用 "-1" 进行自动分配，或使用 null 取消分配。
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	分配详情，包括时间戳、问题键、分配人 ID 和成功状态

`jira_transition_issue`

在工作流状态之间移动 Jira 问题（例如，从“待办”到“进行中”）

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	要转换的 Jira 问题键 (例如：PROJ-123)
`transitionId`	字符串	是	要执行的转换 ID (例如：“11”表示“待办”，“21”表示“进行中”)
`comment`	字符串	否	转换问题时添加的可选评论
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	转换详情，包括时间戳、问题键、转换 ID 和成功状态

`jira_search_issues`

使用 JQL（Jira 查询语言）搜索 Jira 问题

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`jql`	字符串	是	用于搜索问题的 JQL 查询字符串 (例如：“project = PROJ AND status = Open”)
`startAt`	数字	否	要返回的第一个结果的索引 (用于分页)
`maxResults`	数字	否	要返回的最大结果数 (默认值：50)
`fields`	数组	否	要返回的字段名称数组 (默认值：['summary', 'status', 'assignee', 'created', 'updated'])
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	搜索结果，包括时间戳、总数、分页详情和匹配问题的数组

`jira_add_comment`

向 Jira 问题添加评论

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	要添加评论的 Jira 问题键 (例如：PROJ-123)
`body`	字符串	是	评论正文文本
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	评论详情，包括时间戳、问题键、评论 ID、正文和成功状态

`jira_get_comments`

获取 Jira 问题的所有评论

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	要获取评论的 Jira 问题键 (例如：PROJ-123)
`startAt`	数字	否	要返回的第一条评论的索引 (默认值：0)
`maxResults`	数字	否	要返回的评论的最大数量 (默认值：50)
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	评论数据，包括时间戳、问题键、总数和评论数组

`jira_update_comment`

更新 Jira 问题上的现有评论

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	包含评论的 Jira 问题键 (例如：PROJ-123)
`commentId`	字符串	是	要更新的评论 ID
`body`	字符串	是	更新后的评论文本
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	更新的评论详情，包括时间戳、问题键、评论 ID、正文文本和成功状态

`jira_delete_comment`

从 Jira 问题中删除评论

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	包含评论的 Jira 问题键 (例如：PROJ-123)
`commentId`	字符串	是	要删除的评论 ID
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	删除详情，包括时间戳、问题键、评论 ID 和成功状态

`jira_get_attachments`

从 Jira 问题中获取所有附件

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	要获取附件的 Jira 问题键 (例如：PROJ-123)
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	附件数据，包括时间戳、问题键和附件数组

`jira_delete_attachment`

从 Jira 问题中删除附件

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`attachmentId`	字符串	是	要删除的附件 ID
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	删除详情，包括时间戳、附件 ID 和成功状态

`jira_add_worklog`

向 Jira 问题添加时间跟踪工作日志条目

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	要添加工作日志的 Jira 问题键 (例如：PROJ-123)
`timeSpentSeconds`	数字	是	花费的时间（以秒为单位）
`comment`	字符串	否	工作日志条目的可选评论
`started`	字符串	否	可选的 ISO 格式开始时间 (默认为当前时间)
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	工作日志详情，包括时间戳、问题键、工作日志 ID、花费的时间（以秒为单位）和成功状态

`jira_get_worklogs`

从 Jira 问题中获取所有工作日志条目

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	要获取工作日志的 Jira 问题键 (例如：PROJ-123)
`startAt`	数字	否	要返回的第一个工作日志的索引 (默认值：0)
`maxResults`	数字	否	要返回的最大工作日志数 (默认值：50)
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	包含时间戳、问题键、总数和工作日志数组的工作日志数据

`jira_update_worklog`

更新 Jira 问题上的现有工作日志条目

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	包含工作日志的 Jira 问题键 (例如：PROJ-123)
`worklogId`	字符串	是	要更新的工作日志条目的 ID
`timeSpentSeconds`	数字	否	花费的时间（以秒为单位）
`comment`	字符串	否	工作日志条目的可选评论
`started`	字符串	否	ISO 格式的可选开始时间
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	包含时间戳、问题键、工作日志 ID 和成功状态的工作日志更新详情

`jira_delete_worklog`

从 Jira 问题中删除工作日志条目

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	包含工作日志的 Jira 问题键 (例如：PROJ-123)
`worklogId`	字符串	是	要删除的工作日志条目的 ID
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	删除详情，包括时间戳、问题键、工作日志 ID 和成功状态

`jira_create_issue_link`

在两个 Jira 问题之间创建链接关系

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`inwardIssueKey`	字符串	是	内部问题的 Jira 问题键 (例如：PROJ-123)
`outwardIssueKey`	字符串	是	外部问题的 Jira 问题键 (例如：PROJ-456)
`linkType`	字符串	是	链接关系的类型 (例如：“阻止”、“关联到”、“重复”)
`comment`	字符串	否	可选评论，添加到问题链接中
`cloudId`	字符串	否	实例的 Jira 云 ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	问题链接详情，包括时间戳、内部问题键、外部问题键、链接类型和成功状态

`jira_delete_issue_link`

删除两个 Jira 问题之间的链接

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`linkId`	字符串	是	要删除的问题链接的 ID
`cloudId`	字符串	否	实例的 Jira 云 ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	删除详情，包括时间戳、链接 ID 和成功状态

`jira_add_watcher`

为 Jira 问题添加观察者以接收更新通知

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	要添加观察者的 Jira 问题键 (例如：PROJ-123)
`accountId`	字符串	是	要添加为观察者的用户账户 ID
`cloudId`	字符串	否	实例的 Jira 云 ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	观察者详情，包括时间戳、问题键、观察者账户 ID 和成功状态

`jira_remove_watcher`

从 Jira 问题中移除观察者

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`issueKey`	字符串	是	要移除观察者的 Jira 问题键 (例如：PROJ-123)
`accountId`	字符串	是	要移除的观察者用户账户 ID
`cloudId`	字符串	否	实例的 Jira 云 ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`success`	布尔值	操作成功状态
`output`	对象	移除详情，包括时间戳、问题键、观察者账户 ID 和成功状态

注意事项

类别: tools
类型: jira

Jira

On this page