Jira

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

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

Jira 的主要功能包括：

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

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

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

输出

参数	类型	描述
`ts`	字符串	操作的时间戳
`issueKey`	字符串	问题键 (例如：PROJ-123)
`summary`	字符串	问题摘要
`description`	JSON	问题描述内容
`created`	字符串	问题创建的时间戳
`updated`	字符串	问题最后更新的时间戳
`issue`	JSON	包含所有字段的完整问题对象

`jira_update`

更新 Jira 问题

输入

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

输出

参数	类型	描述
`ts`	字符串	操作的时间戳
`issueKey`	字符串	更新后的问题键 (例如：PROJ-123)
`summary`	字符串	更新后的问题摘要

`jira_write`

编写一个 Jira 问题

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`projectId`	字符串	是	问题所属项目 ID
`summary`	字符串	是	问题摘要
`description`	字符串	否	问题描述
`priority`	字符串	否	问题优先级 ID 或名称 (例如：“10000”或“High”)
`assignee`	字符串	否	问题负责人账户 ID
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。
`issueType`	字符串	是	要创建的问题类型 (例如：Task、Story)
`labels`	数组	否	问题标签 (标签名称数组)
`duedate`	字符串	否	问题截止日期 (格式：YYYY-MM-DD)
`reporter`	字符串	否	问题报告人账户 ID
`environment`	字符串	否	问题环境信息
`customFieldId`	字符串	否	自定义字段 ID (例如：customfield_10001)
`customFieldValue`	字符串	否	自定义字段的值

输出

参数	类型	描述
`ts`	字符串	操作的时间戳
`issueKey`	字符串	创建的问题键 (例如：PROJ-123)
`summary`	字符串	问题摘要
`url`	字符串	创建的问题的 URL
`assigneeId`	字符串	已分配用户的账户 ID（如已分配）

`jira_bulk_read`

批量检索多个 Jira 问题

输入

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

输出

参数	类型	描述
`issues`	数组	包含时间戳、摘要、描述、创建和更新时间戳的 Jira 问题数组

`jira_delete_issue`

删除 Jira 问题

输入

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

输出

参数	类型	描述
`ts`	字符串	操作的时间戳
`issueKey`	字符串	删除的问题键

`jira_assign_issue`

将 Jira 问题分配给用户

输入

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

输出

参数	类型	描述
`ts`	字符串	操作的时间戳
`issueKey`	字符串	被分配的任务键
`assigneeId`	字符串	分配者的账户 ID

`jira_transition_issue`

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

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`issueKey`	string	已转换的问题键
`transitionId`	string	应用的转换 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。如果未提供，将使用域名获取。

输出

参数	类型	描述
`ts`	string	操作的时间戳
`total`	number	匹配问题的总数
`startAt`	number	分页起始索引
`maxResults`	number	每页的最大结果数
`issues`	array	包含键、摘要、状态、负责人、创建时间和更新时间的匹配问题数组

`jira_add_comment`

向 Jira 问题添加评论

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`issueKey`	string	添加评论的问题键
`commentId`	string	创建的评论 ID
`body`	string	评论的文本内容

`jira_get_comments`

获取 Jira 问题的所有评论

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`issueKey`	string	问题键
`total`	number	评论的总数
`comments`	array	包含 ID、作者、正文、创建时间和更新时间的评论数组

`jira_update_comment`

更新 Jira 问题上的现有评论

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`issueKey`	string	问题键
`commentId`	string	更新的评论 ID
`body`	string	更新的评论文本

`jira_delete_comment`

从 Jira 问题中删除评论

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`issueKey`	string	问题键
`commentId`	string	已删除的评论 ID

`jira_get_attachments`

从 Jira 问题中获取所有附件

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`issueKey`	string	问题键
`attachments`	array	附件数组，包括 id、文件名、大小、mimeType、创建时间、作者

`jira_delete_attachment`

从 Jira 问题中删除附件

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`attachmentId`	string	已删除的附件 ID

`jira_add_worklog`

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

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`issueKey`	string	添加工作日志的相关问题键
`worklogId`	string	创建的工作日志 ID
`timeSpentSeconds`	number	花费的时间（以秒为单位）

`jira_get_worklogs`

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

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`issueKey`	string	问题键
`total`	number	工作日志的总数
`worklogs`	array	工作日志数组，包括 id、作者、timeSpentSeconds、timeSpent、评论、创建时间、更新时间、开始时间

`jira_update_worklog`

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

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`issueKey`	string	问题键
`worklogId`	string	更新的工作日志 ID

`jira_delete_worklog`

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

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`issueKey`	string	问题键
`worklogId`	string	已删除的工作日志 ID

`jira_create_issue_link`

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

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`inwardIssue`	string	内部问题键
`outwardIssue`	string	外部问题键
`linkType`	string	问题链接的类型
`linkId`	string	创建的链接 ID

`jira_delete_issue_link`

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

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`linkId`	string	已删除的链接 ID

`jira_add_watcher`

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

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`issueKey`	string	问题键
`watcherAccountId`	string	添加的观察者账户 ID

`jira_remove_watcher`

从 Jira 问题中移除观察者

输入

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

输出

参数	类型	描述
`ts`	string	操作的时间戳
`issueKey`	string	问题键
`watcherAccountId`	string	移除的观察者账户 ID

`jira_get_users`

获取 Jira 用户。如果提供了账户 ID，则返回单个用户，否则返回所有用户的列表。

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`accountId`	字符串	否	可选账户 ID，用于获取特定用户。如果未提供，则返回所有用户。
`startAt`	数字	否	要返回的第一个用户的索引 (用于分页，默认值：0)
`maxResults`	数字	否	要返回的最大用户数 (默认值：50)
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`ts`	字符串	操作的时间戳
`users`	json	用户数组，包含 accountId、displayName、emailAddress、active 状态和 avatarUrls
`total`	数字	返回的用户总数
`startAt`	数字	分页起始索引
`maxResults`	数字	每页最大结果数

备注

分类：tools
类型：jira

输入

参数	类型	必需	描述
`domain`	字符串	是	您的 Jira 域名 (例如：yourcompany.atlassian.net)
`accountId`	字符串	否	可选账户 ID，用于获取特定用户。如果未提供，则返回所有用户。
`startAt`	数字	否	要返回的第一个用户的索引 (用于分页，默认值：0)
`maxResults`	数字	否	要返回的最大用户数 (默认值：50)
`cloudId`	字符串	否	实例的 Jira Cloud ID。如果未提供，将使用域名获取。

输出

参数	类型	描述
`ts`	string	操作的 ISO 8601 时间戳
`users`	array	Jira 用户数组
↳ `accountId`	string	用户的 Atlassian 账户 ID
↳ `displayName`	string	用户显示名称
↳ `active`	boolean	用户账户是否激活
↳ `emailAddress`	string	用户邮箱地址
↳ `accountType`	string	账户类型 (如 atlassian、app、customer)
↳ `avatarUrl`	string	用户头像 URL (48x48)
↳ `timeZone`	string	用户时区
↳ `avatarUrls`	json	多尺寸用户头像 URL (16x16、24x24、32x32、48x48)
↳ `self`	string	此用户的 REST API URL
`total`	number	返回的用户总数
`startAt`	number	分页起始索引
`maxResults`	number	每页最大结果数

Jira

On this page