Devin の Jira 統合

Jira Cloud を Devin に接続する方法は 2 つあります。どちらも Jira の作業項目を Devin に任せてプルリクエストを受け取れますが、インストール方法とトリガー方法が異なります。

​

どちらのオプションを利用すべきですか？

• ワークスペースで Jira Cloud のエージェント機能が有効になっている場合 → Rovo エージェントを利用します。Devin は他のエージェントと同様に担当者の選択欄や @メンションに表示され、作業項目のエージェントカードで結果を報告します。また、サイトをリンクすると、その Jira の作業項目イベントを Devin の自動化のトリガーとして利用できるようになります。
• Jira ワークスペースで Rovo が無効になっている場合 → サービスユーザーを利用します。Devin はお客様が作成した Jira のサービスアカウントを介して動作し、コメントとリモートリンクで結果を報告します。

どちらのオプションでも通常の Devin セッションが実行され、Devin の自動化と連携できます。また、要件と請求方法も共通です。

​

Devin の自動化

Devin の自動化は、Jira から Devin を自動的に起動するための仕組みで、どちらの方法でも利用できます。Jira サイトを接続すると (Devin for Jira アプリ経由でリンクした場合も、管理者アカウントで接続した場合も) 、そのサイトの作業項目のイベントを Jira トリガーとして利用できます。自動化を作成する際に、次のいずれかを選択します。

• Issue created — 作業項目が作成されたとき。
• Issue updated — 作業項目のいずれかのフィールドが変更されたとき。変更されたフィールドは自動化の条件で参照できます。
• Label added — 作業項目にラベルが追加されたとき。ラベルごとに 1 つのイベントが発生します。
• Status changed — 作業項目のステータスが変更されたとき、またはステータスが設定された状態で作業項目が作成されたとき。
• Assigned — 担当者が設定された状態で作業項目が作成されたとき、または担当者が変更されたとき。
• Comment created — 作業項目にコメントが追加されたとき。Devin 自身が投稿したコメントではトリガーされません。

条件では、プロジェクト、ラベル、ステータス、担当者、エピック (作業項目の親) 、要約でフィルタリングできます。自動化のセッションが終了すると、その最終メッセージが作業項目にコメントとして投稿されます。投稿元は、アプリ経由でリンクしたサイトでは Devin アプリ、管理者アカウントで接続したサイトではサービスユーザー接続です。サイトに両方の接続がある場合、各イベントはサービスユーザー接続を通じて 1 回だけ配信されます。

​

オプション1: Jira の Devin Rovo エージェント

Devin for Jira は、Rovo エージェントコネクタ上に構築された Atlassian Forge アプリです。インストールしてリンクすると、Devin を Jira Cloud サイト上のエージェントとして利用できます。作業項目を Devin に割り当てるか、コメントで @Devin をメンションするだけで、Devin が作業を計画し、コードを書き、プルリクエストを作成して、作業項目上で結果を報告します。

​

セットアップ

セットアップは 2 つのステップで行います。まず Jira サイトにアプリをインストールし、次に Devin の管理者がそのサイトを Devin アカウントに連携します。

​

1. サイトにアプリをインストールする

1. Jira 管理者が Atlassian Marketplace の Devin を開き、Jira Cloud サイト (your-site.atlassian.net) にインストールします。
2. Jira 管理者は、アプリが要求する権限を確認して承認します。このアプリは、作業項目とコメントの読み取り・書き込み、Jira ユーザーとそのメールアドレスの読み取り (Devin ユーザーとの照合に使用) 、プロジェクト権限の確認を行います。

アプリをインストールすると、Devin がサイト上にエージェントとして表示されます。ただし、サイトが Devin アカウントにリンクされるまでは、作業を受け付けられません。

​

2. Jira サイトを Devin アカウントにリンクする

1. Jira で Settings > Apps に移動し、アプリによって追加された Devin ページを開きます。「This site is not connected to a Devin account yet.」と表示されます。
2. Connect to Devin をクリックします。新しいタブで Devin のページが開きます。サインインを求められた場合は、Devin にサインインしてください。
3. 表示されている Jira サイトが自分のものであることを確認し、リンク先の Devin アカウントを選択して Link site をクリックします。
4. Jira に戻り、Check again をクリックします。サイトの接続先の Devin アカウントがページに表示されます。

リンクしたサイトは、Devin の Settings > Connections > Jira に Devin app for Jira · installed from Jira として Linked バッジ付きで表示されます。接続を解除するには、同画面でサイトの Actions メニューを開き、Unlink site… を選択して Unlink site で確定します。解除すると、Devin はその Jira サイトからの新しい作業の受け付けを直ちに停止します。ただし、Devin ですでに実行中のセッションは停止されません。再度リンクするには、Jira 管理者が Jira で改めて Connect to Devin をクリックします。

​

トリガー

作業項目のイベントをきっかけに Devin を自動で開始するには、Devin の自動化を利用します。また、Rovo エージェントを使って作業項目から手動で Devin セッションを開始する方法も 2 つあります。

​

作業項目を Devin に割り当てる

作業項目の担当者フィールドで Devin を選択します。Devin はセッションを開始し、作業項目の要約と説明をタスクとして作業に取りかかります。

• タスクがアクティブな間は、同じユーザーが 5 分以内に繰り返し割り当てても重複として扱われます。時間をおいて再度割り当てた場合や、別のユーザーが割り当てた場合は、最初のセッションが実行中であっても別のセッションが開始されることがあります。
• Devin の作業完了後に再度 Devin に割り当てると、新しいセッションが開始されます。

​

コメントで Devin を@メンションする

コメントで @Devin をメンションし、具体的な指示を記述します。Devin はセッションを開始し、そのコメントをタスク、作業項目の説明を前提情報として扱います。Devin は作業を完了したとき、または質問のために作業を中断したときに、最新のメッセージをあなた宛てのコメントとして作業項目に投稿します。 Devin をメンションしたコメントごとに、個別のセッションが開始されます。実行中のセッションを続けるには、エージェントパネル で返信してください。

​

エージェントパネル

Devin の作業中は、作業項目の Jira エージェントパネルに進捗が表示されます。

• ライブステータス: エージェントパネルには Devin の進捗がリアルタイムで表示されます。
• セッションリンク: Devin の最初のメッセージは、Web アプリ内の Devin セッションへのリンクです。リンク先で進行状況を確認したり、作業を引き継いだりできます。
• Devin のメッセージ: Devin の返信は、クリック可能なリンクを含む整形済みのレスポンスとしてカード上に残ります。
• 質問: Devin がユーザーの入力を必要とする場合は、カードに質問が表示されます。Jira エージェントパネルのタスクチャットから返信してください。返信は同じ Devin セッションに送信されます。
• キャンセル: Jira からタスクをキャンセルすると、Devin は停止し、セッションはスリープ状態になります。

Jira から Devin タスクにメッセージを送信したりタスクをキャンセルしたりできるのは、そのタスクを開始した Jira ユーザーのみです。 Devin が作業項目を受け付けられない場合は、カードにその理由が表示されます。たとえば、Jira サイトがまだ Devin アカウントにリンクされていない、Atlassian アカウントを Devin ユーザーと照合できなかった、組織またはユーザーが現在これ以上 Agent Compute Unit (ACU) を消費できない、といった理由です。原因に対処してから、作業項目を再度 Devin に割り当ててください。

​

プルリクエストのリンク

Jira のエージェントパネルに表示される Devin のレスポンスには、プルリクエストのリンクが含まれます。Devin が作成したもののレスポンス内で言及しなかったプルリクエストは、レスポンス末尾の Pull requests に一覧表示されます。@メンションで開始されたセッションでは、Devin の最終メッセージが作業項目にもコメントとして投稿されます。ただし、このコメントにプルリクエストのリンクが含まれるのは、Devin がリンクを記載した場合に限られます。

​

オプション 2: Jira のサービスユーザー

このオプションでは、Devin は OAuth 経由で Jira サイトに接続し、Jira のサービスアカウントとして操作を行います。Jira には何もインストールする必要はありません。Jira の管理者が Devin の設定画面から Devin を承認し、ユーザー側で Atlassian にサービスアカウントを作成します。このサービスアカウントが Jira における Devin の ID となり、作業項目の割り当て先ユーザー、および Devin のコメントの投稿者になります。Jira ワークスペースで Rovo が無効になっている場合は、このオプションを利用してください。

​

セットアップ

​

1. 管理者アカウントで接続する

1. Devin で Settings > Connections > Jira に移動し、Connect account をクリックして、Connect with an admin account を選択します。
2. Jira 管理者として Atlassian にサインインし、アクセスを許可します。Devin はこのアカウントを使用して、サイトに webhook を登録します。

サービスアカウントを追加するまでは、Devin のコメントは Jira を接続した管理者アカウントの名義で投稿されます。また、作業項目を Devin に割り当てることもできません。

​

2. サービスアカウントを追加する

1. OAuth 2.0 の認証情報と以下のスコープを持つ Atlassian サービスアカウントを設定します。
   • read:me
   • read:jira-user
   • read:jira-work
   • write:jira-work
2. サービスアカウントに Jira アプリケーションへのアクセス権を付与し、対象プロジェクトの閲覧、コメントの追加、自身のコメントの編集と削除、課題のリンクを行う権限を与えます。認証情報を保存すると Devin がその内容を検証し、不足している権限があれば報告します。
3. Settings > Connections > Jira で接続のメニューを開き、Add service-account credentials を選択して、クライアント ID とクライアントシークレットを入力します。

これ以降、Devin のコメントはサービスアカウント名義で表示され、このアカウントに作業項目を割り当てるとセッションが開始されます。認証情報を差し替えたり削除したりしても、Webhook はそのまま保持されます。 Devin は通常、設定済みのサービスアカウントを使って投稿します。このアカウントのアクセストークンを取得できない場合、Devin は Jira を接続した管理者の OAuth トークンにフォールバックすることがあり、その際はコメントが管理者名義で表示されます。

​

3. 自動化を作成する

作業項目のイベントをきっかけに Devin を自動的に開始するには、Jira トリガーを設定した Devin の自動化を作成します。詳しくは Devin の自動化を参照してください。

​

トリガー

作業項目の作成時や変更時に Devin を自動的に開始するには、Devin の自動化を利用します。作業項目で手動で Devin を開始することもできます。

• 作業項目をサービスアカウントに割り当てる。 Devin がその作業項目でセッションを開始します。サービスアカウントが必要です。
• devin ラベルを追加する。 既存の作業項目にラベルを追加した場合、マッチングは大文字と小文字を区別せず、単語単位で行われます。Devin、devin-workshop、devin-task はトリガーになりますが、devinworkshop と devin_workshop はトリガーになりません。ラベルが設定済みの状態で作業項目が作成された場合、ラベルトリガーは devin と完全に一致するラベル (大文字と小文字は区別しない) に対してのみ発生し、devin-workshop は対象外です。
• コメントでサービスアカウントを@メンションする。 Devin がその作業項目でセッションを開始し、コメントのテキストをタスクに追記します。その作業項目で Devin のアクティブなセッションがすでにある場合は、新しいセッションは開始されず、コメントはそのセッションに転送されます。

作業項目に Devin のセッションがある間は、その作業項目に対する新たな割り当てやラベルは無視され、@メンションはそのセッションに送られます。この紐付けは 30 日間、または@メンションの際にセッションの終了やエラーが検出されるまで維持されます。

​

セッションの実行ユーザー

Devin は、自身をトリガーした Jira ユーザーを、接続されている Devin アカウントのメンバーと照合します。

1. まず、リンクされた Atlassian アカウントで照合します。メンバーは Settings > Connections > Atlassian から自分のアカウントをリンクできます。リンクすると、Devin はその人として Jira を読み取れるようになります。
2. リンクがない場合は、メールアドレスで照合します。メールアドレスがアカウント内のメンバー 1 人とだけ完全に一致する Jira ユーザーが照合対象となり、その照合結果は記憶されます。

セッションは照合された Devin ユーザーとして run され、そのユーザーのセッション一覧に表示されます。権限もそのユーザーのものが適用されます。一致するメンバーがいない場合や、照合されたメンバーに組織内で Devin セッションを利用する権限がない場合は、代わりに共有の Devin Jira ボットユーザーとしてセッションが run されます。作業項目に対応する組織を Devin が特定できない場合は、その旨がコメントで通知されます。

​

コメントとプルリクエストのリンク

セッションが開始されると、Devin は「Devin is working on your request」というコメントを投稿し、セッションへのリンクを追加します。Devin がプルリクエストを作成すると、その URL が作業項目にリモートリンクとして追加されるとともに、Devin セッションへのリンクと合わせてコメントとしても投稿されます。

​

要件

両方のオプションに共通:

• Jira Cloud。 Devin for Jira は Forge アプリであり、OAuth 接続は Atlassian Cloud OAuth を利用するため、どちらのオプションでも Jira Cloud サイトが必要です。セルフホスト型の Jira については、API を介したカスタムチケット管理システムの接続を参照してください。
• アプリのインストールまたは OAuth 接続の承認を行う Jira 管理者と、サイトのリンクまたは接続の設定を行う Devin 管理者(Devin アカウントの統合を管理できるユーザー)。
• Devin アカウントごとに 1 つの Jira サイト。 1 つの Jira サイトにリンクできる Devin アカウントは 1 つだけで、1 つの Devin アカウントに同時にリンクできる Jira サイトも 1 つだけです。別のサイトをリンクするには、先に現在のサイトのリンクを解除してください。
• 接続済みのリポジトリ。 Devin がブランチをプッシュしてプルリクエストを作成するために必要です。Devin がプルリクエストを作成できるのは、アクセス権のあるリポジトリに限られます。まず、GitHub 統合などを通じてソースコードプロバイダーを接続してください。

Rovo エージェントの場合:

• Atlassian Marketplace からインストールした Devin for Jira アプリと、ワークスペースで有効化された Jira Cloud のエージェント機能。オプション 1 を参照してください。
• Devin Core、Team、または Enterprise プランと、統合を管理する権限、セッションを開始する権限、および利用可能な使用量。
• Devin をトリガーする各ユーザーに Devin ユーザーが必要です。 Devin は、リンクされた Atlassian アカウントまたはメールアドレスを使って、Jira ユーザーをリンク済み Devin アカウントのメンバーと照合します。どちらでも一致しない場合、そのユーザーは Settings > Connections > Atlassian で自分のアカウントをリンクできます。それでも解決しない場合は、そのユーザーがリンク済み Devin アカウントに所属しているか、確認済みのメールアドレスが一致しているかを管理者が確認してください。照合できない Jira ユーザーからの作業項目は拒否されます。
• セッションを開始する権限。 照合された Devin ユーザーには、所属する組織で Devin セッションを利用する権限が必要です。複数の組織に所属するユーザーの場合、Devin はまずそのユーザーのデフォルトの作業組織を使用します。デフォルトの作業組織は Settings > Preferences で選択できます。Devin が組織を選択できない場合は、デフォルトを設定するようそのユーザーに求めます。

サービスユーザーの場合:

• サービスアカウントを追加するに記載のスコープとアプリケーションアクセスを持つ Jira サービスアカウント。これにより、作業項目を Devin に割り当てたり、Devin のコメントをボットとして投稿したりできます。
• 接続を承認するための Jira 管理者アカウント。後で再接続すると、サービスアカウントの認証情報や Webhook を失うことなく承認を更新できます。

​

請求

Jira から開始されたセッションは、通常の Devin セッションと同じ扱いです。セッションを実行する Devin 組織の ACU を、Web アプリやその他の統合から開始されたセッションと同じレートで消費し、その組織の使用量の上限にも計上されます。組織が使用量の上限に達して新しいセッションを開始できない場合、Devin は Jira 上でその作業項目を辞退します。辞退は、Rovo エージェントの場合はカード上に、サービスユーザーの場合はコメントで表示されます。 アプリは無料でインストールできます。Devin の使用量はお客様の Devin プランに基づいて請求されます。また、Devin は Jira のコンテンツを Atlassian の外部で処理します。