メインコンテンツへスキップ

​
統合の設定

  1. app.devin.ai の Devin アカウントで、Settings > Integrations > Jiraに移動し、“Connect” をクリックします。
  2. Jira にリダイレクトされるので、権限を確認して Devin へのアクセスを許可します。
  3. 接続したら、設定ページで プレイブックラベル を設定し、必要に応じて 自動化トリガー も設定します。
接続後は、サービスアカウント も接続することを推奨します。これにより、Devin のコメントは個人アカウントではなくボット名義で表示されます。詳しくは、下記のサービスアカウントの接続を参照してください。

​
Jira から Devin をトリガーする方法

Jira チケットから Devin セッションを開始する方法は 4 つあります。

​
チケットをDevinに割り当てる

JiraでチケットをDevinのサービスアカウントに直接割り当てます。Devinは、Jira統合設定で設定されているデフォルトのプレイブックを利用して、チケットの作業を開始します。

​
プレイブックラベルを追加する

チケットにプレイブックラベル (例: !plan、!implement、!triage) を追加します。Devin は、ラベルに対応する特定のプレイブックを使用してセッションを開始します。これらのラベルは、統合設定で構成したプレイブックラベルに対応しています。これらのラベルは Jira プロジェクトで手動で作成する必要があります。ラベル名は統合設定からコピーしてください。

​
devin ラベルを追加する

任意の Jira 課題に devin ラベルを追加します (必要に応じて、最初に Jira プロジェクトでこのラベルを作成してください)。Devin は デフォルトのプレイブック を利用してチケットの作業を開始します。
この連携では単語境界一致 (大文字と小文字は区別しない) を利用するため、devin を独立した単語として含むラベルであればトリガーされます。たとえば devin、Devin、devin-workshop、devin-task です。一方、devinworkshop や devin_workshop のように、“devin” がより大きな単語の一部になっているラベルではトリガーされません。

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

チケットのコメントで、具体的な指示とともに @Devin にメンションします。Devin はセッションを開始し、プレイブックを適用せずに、そのコメントをタスクの指示として利用します。チケットに対してすでにセッションが存在する場合は、そのメッセージが既存のセッションに転送されます。

​
統合の設定

​
セッションモード

セッションモードのトグルでは、Jira のトリガーに対して Devin がどのように応答するかを設定できます。
  • セッションを直接作成 (デフォルトで有効) : Devin は完全なセッションを作成してチケットに取り組み、進捗を Jira に投稿します。
  • スコーピングのみ (無効) : Devin はチケットを分析するだけで、要約、実装計画、確信度の見積もりを含むスコーピングコメントを投稿します。その後、表示されたリンクをクリックして、手動でセッションを開始できます。

​
プレイブックラベル

プレイブックラベルを使うと、どのDevinのプレイブックをJiraのラベルとして使えるようにするかを制御できます。プレイブックを追加すると、そのマクロ (たとえば !plan) がラベルになり、そのプレイブックでDevinをトリガーするためにJira課題に割り当てられるようになります。ラベルはJiraプロジェクトで手動で作成する必要があります。ラベル名は統合設定からコピーしてください。
  • デフォルトのプレイブック: 1つのプレイブックがデフォルトとして設定されます。特定のプレイブックラベルなしでチケットがトリガーされた場合 (たとえば devin ラベルだけを付けた場合や、チケットをDevinに割り当てた場合) 、Devinはこのデフォルトのプレイブックを利用します。
  • プレイブックの追加: 追加のプレイブックを加えるには、“Add playbook” をクリックします。追加できるのは、マクロを持つプレイブックのみです。
  • プレイブックの削除: プレイブックを削除すると、そのラベルをトリガーとして使えなくなります。

​
自動化トリガー

自動化トリガーを利用すると、Devin はチケットが特定の条件に一致した際に、手動で割り当てたりラベルを付けたりしなくても、自動的に作業を開始できます。トリガーは、次の条件に基づいて設定できます。
  • Projects: 特定の Jira プロジェクト内のチケットに対してのみトリガーします。
  • Labels: チケットに特定のラベルが付いている場合にのみトリガーします。
  • Statuses: チケットが特定のステータス (例: “To Do”, “In Progress”) になった場合にのみトリガーします。
  • Playbook: トリガーされたセッションで Devin が利用するプレイブックを、必要に応じて指定できます。
トリガーでは エッジ検出 を利用します。つまり、チケットがトリガー条件に一致していない状態から一致する状態に変わったとき (例: ラベルが追加された場合やステータスが変更された場合) にのみ発火し、すでに条件に一致しているチケットに対しては発火しません。

​
Enterprise: Jira プロジェクトの対応付け

複数のDevin組織を含むEnterprise環境のデプロイでは、管理者はJiraプロジェクトを特定のDevin組織に対応付けできます。これにより、各Jiraプロジェクトのチケットが正しいDevin組織に振り分けられます。Enterprise環境でJira統合を機能させるには、この対応付けが必要です。

​
Jira で Devin とやり取りする

Devin がチケットの対応を開始すると、Jira を通じて進捗が共有されます。
  • PR リンク: Devin がプルリクエストを作成すると、その PR の URL が Jira の Jira 課題 にリモートリンクとして自動的に追加され、コメントにも投稿されます。
  • セッションリンク: Web アプリ内の Devin セッションへの直接リンクも提供されるため、進捗をリアルタイムで確認できます。
  • フォローアップメッセージ: コメントで @Devin にメンションすると、Devin に追加の指示を与えたり、質問したりできます。

​
サービスアカウントの接続

管理者アカウントで Jira を接続した後、必要に応じて、OAuth 2.0 のクライアント認証情報を使用してサービスアカウントを接続できます。これにより、Devin のコメントは個人アカウントではなく、専用のボット ID として表示されます。
  1. Atlassian 組織の管理者設定で、次の Classic scopes を持つ OAuth 2.0 サービスアカウントを作成します：
    • read:me
    • read:jira-user
    • read:jira-work
    • write:jira-work
  2. Settings > Integrations > Jira で、Connect service account をクリックし、クライアント ID とクライアントシークレットを入力します。