プロジェクト管理

JiraをAIエージェントに接続する

Jiraに接続したAtakoのエージェントは、トークンを生成したアカウントと同じ権限で、ワークフロー内のIssueを検索、作成、進行させられます。

Atakoのエージェントが執筆 · 確認・承認者 Romain Laodicina · Atako CTO

想定されるワークフロー

受信チケットの仕分けと優先順位付け

サポートチャネルやフォームからのシグナルをもとに、エージェントは適切な種類と優先度でIssueを作成し(create_issue)、業務ルールに従ってアサインし(assign_issue)、受け取った文脈をコメントとして追加します(add_comment)。チームは、実際の作業に取りかかる前に読んで仕分ける必要のない、すでに分類済みのチケットを手にすることになります。

スプリント進捗の週次レポート

エージェントはJQLクエリで現在のスプリントのIssueを照会し(search_issues)、ログされた時間を取得し(list_worklogs)、最近の変更を確認したうえで(get_issue_changelog)、epicや親チケットへのコメントとして要約を公開します(add_comment)。事前のステータス会議なしに、毎週月曜の朝にはレポートが用意されており、ブロックされているチケットはスプリント全体のリストに埋もれることなく前面に表示されます。

インシデント関連チケットの追跡とクローズ

別のチャネルで修正が確認されると、エージェントは利用可能なワークフローの遷移を確認し(list_transitions)、チケットを進行させ(transition_issue)、元のインシデントと紐づけ(create_issue_link)、関係するウォッチャーに通知します。チケットには経緯の完全な記録が残り、散らばったSlackメッセージや各人の記憶から後で時系列を再構築する必要のないポストモーテムに役立ちます。

コネクタのアクション

  • search_issues (読み取り、JQL)

    JQLクエリでIssueを検索する。

  • get_issue (読み取り)

    IDまたはキーでIssueを取得する。

  • get_issue_changelog (読み取り)

    Issueの変更履歴を取得する。

  • list_worklogs (読み取り)

    Issueにログされた作業時間を一覧表示する。

  • list_transitions (読み取り)

    Issueで利用可能なワークフローの遷移を一覧表示する。

  • list_projects (読み取り)

    アカウントから見えるプロジェクトを一覧表示する。

  • create_issue (書き込み)

    プロジェクトにIssueを作成する。

  • update_issue (書き込み)

    既存Issueのフィールドを更新する。

  • transition_issue (書き込み)

    ワークフロー内でIssueを進行させる。

  • add_comment (書き込み)

    Issueにコメントを追加する。

  • assign_issue (書き込み)

    Issueをユーザーにアサインする。

  • add_worklog (書き込み)

    Issueに費やした時間を記録する。

  • create_issue_link (書き込み)

    2つのIssueを関連付ける(ブロックする、関連するなど)。

前提条件

  • 対象プロジェクトへのbrowse、create、edit権限を持つJiraアカウント(Jira管理者である必要はない)。
  • id.atlassian.comのSecurity、続いてAPI tokensでAPIトークンを生成する。
  • Jiraのサイト名(yourcompany.atlassian.netのyourcompanyの部分)を確認する。
  • email:tokenの形式で認証用の識別子を組み立てる。
  • Atako側で、エージェントにgrantを付与するためのインテグレーション管理権限。

接続方法

  1. 1

    Atlassian APIトークンを生成する

    id.atlassian.comでSecurity、続いてAPI tokensに進み、トークンを作成、名前を付けてコピーする。

  2. 2

    接続用の識別子を組み立てる

    Jiraアカウントのメールアドレスと APIトークンをemail:tokenの形式で結合する。

  3. 3

    AtakoでJiraを接続する

    設定、続いて連携で、Jiraのサイト名を入力し識別子を貼り付ける。

  4. 4

    エージェントにgrantを付与する

    エージェントのページまたは接続画面から、許可する具体的なアクションとその範囲を選択する。

自律型エージェントをJiraに接続する理由

Jiraは技術チームがIssueを管理する場所であり続けていますが、それらのIssueをめぐる仕分け、催促、レポート作成には、実際の開発作業に見合わない不釣り合いな時間がかかります。ツールコーリングを通じてJiraに接続されたAtakoのエージェントは、この作業の一部を専用の実行環境で継続的に行い、週次のステータス会議を待ちません。

Webhookや定型スケジュールのスクリプトとの違いは、エージェントが継続的に稼働し、行動を起こす前に状況を解釈する点です。他のチャネル(メール、Slack)からシグナルを受け取り、JQLクエリでJiraを照会して文脈を取得したうえで、付与されたアクションに応じて、Issueを作成するか、コメントするか、ワークフローを進めるかを判断します。

Atakoのドキュメントによると、Jiraコネクタは39種類のアクション(読み取り24、書き込み15)をカバーしており、JQL検索からworklogの追跡まで対応します。プロダクト側の具体的な活用例としては、CI/CDインシデントの仕分けがあります。ここでは、エージェントがパイプラインの失敗と最近のコミットを突き合わせたうえで、すでにドキュメント化されたJiraチケットを起票します。

制限とベストプラクティス

Atlassianは、Jira Cloud APIのレート制限をポイント制のモデルへと移行させており、各リクエストは複雑さに応じて変動するコストを消費し、1時間あたりの上限に加えて秒単位のバースト上限も設けられています。多数のIssueを一度に照会するエージェントは、1回のリクエストですべてを読み込むのではなく、呼び出しをページ分割する必要があります。

APIトークンは、それを作成したJiraアカウントの権限を厳密に引き継ぎます。そのアカウントがあるプロジェクトにアクセスできなければ、Atako側でどのようなgrantを設定していても、エージェントもそのプロジェクトにアクセスできません。

他のインテグレーションと同様、接続だけではアクセス権は一切付与されません。正確なgrant(エージェント、アクション、範囲)が必要です。エージェントをJiraプロジェクトに接続する前に、権限モデルとプランをご確認ください。

関連するユースケース

関連する連携機能

よくある質問

エージェントはJiraのチケットを単独でクローズできますか。

できます。書き込み範囲でtransition_issueアクションを持ち、プロジェクトのワークフローが要求される遷移を許可している場合です。この明示的なgrantがなければ、エージェントは読み取りとコメントはできますが、Issueのステータスを進めることはできません。

エージェントを接続するにはJiraの管理者である必要がありますか。

いいえ。APIトークンは、それを生成したアカウントの権限をそのまま引き継ぎます。対象プロジェクトへのbrowse、create、edit権限を持つアカウントで十分で、Jiraの完全な管理権限は必要ありません。

エージェントのJiraアクセスをどう取り消しますか。

id.atlassian.comからAPIトークンを削除するか、Atako側で接続を取り消します。どちらの方法でも、この接続を使用していたすべてのエージェントのアクセスは即座に失われます。

エージェントはJiraのIssueを完全に削除できますか。

コネクタにはdelete_issueというアクションが存在し、関連するサブタスクの削除も含まれますが、エージェントのgrantが書き込み範囲でこれを明示的に許可している場合にのみ利用できます。

次に読む

出典

Romain Laodicina

Atako CTO

このコンテンツはAtakoのAIエージェントが執筆し、その後Atako CTOのRomain Laodicinaが確認・修正・承認しました。

最初のAIエージェントを導入

無料でアカウントを作成し、コード不要で数分でエージェントを起動できます。

AIの最前線を 常にキャッチアップ。

新機能、新しいエージェント、当社のAI分析を直接受信箱にお届けします。スパムなし、いつでも配信停止できます。