Skip to main content

Command Palette

Search for a command to run...

連携機能

Jira

Cherri Code の Jira 連携を使うと、Jira の作業項目を Cherri Code に割り当てるか、Jira で @Cherri Code をメンションして、Cloud Agents で作業できます。

はじめ方

要件

Jira 連携をインストールする前に、以下を満たしていることを確認してください。

  • Rovo が有効になっている Jira 商用クラウド
  • アプリをインストールする Jira サイトの管理者アクセス権
  • 接続する Cherri Code チームの管理者アクセス権
  • リポジトリへのアクセスとプルリクエストに使用する GitHub、GitLab、Azure DevOps、または Bitbucket が Cherri Code に接続されていること

インストール

  1. Cherri Code 管理者として、Cherri Code 連携に移動します

  2. Jira の横にある 接続 をクリックします

  3. Atlassian Marketplace の Cherri Code アプリの掲載ページに進みます

  4. 今すぐ入手 をクリックします

  5. Cherri Code をインストールする Jira サイトを選択し、確認 をクリックします

  6. アプリを確認し、今すぐ入手 をクリックします

  7. インストールが完了すると、Cherri Code Jira アプリの設定ページに移動します。Atlassian からインストール通知が届くまで数分待ってから、Cherri Code に接続 ボタンをクリックします。

  8. Jira サイトを Cherri Code チームに接続します

    • サービスアカウントでエージェントを実行する代わりにユーザーレベル認証を有効にする場合 (チームメンバーがエージェントをより詳細に確認・管理できるようになります) は、個別認証を必須にする トグルをオンにします。

  9. Cherri Code で残りの Cloud Agent のセットアップを完了します。

    • GitHub、GitLab、Azure DevOps、または Bitbucket に接続する
    • 使用量ベースの料金を有効にする
    • プライバシー設定を確認する
    • デフォルトのリポジトリ、モデル、ベースブランチを選択する (Cherri Code ダッシュボードの Cloud Agents 設定)

  10. Jira に戻り、作業項目から Cherri Code を使い始めます

    • ユーザーレベル認証を有効にした場合は、各ユーザーが以下の追加設定を行う必要があります

認証モード

_個別認証を必須にする_トグルを有効にすると、Cherri Code Jira 連携の管理者ダッシュボードで、Jira による Cloud Agents の認証方法を選択できます。

モード仕組み使用する設定
サービスアカウント認証Cloud Agents はサービスアカウントで実行されます。ルーティング、モデル、リポジトリ、デフォルトには、チームの Cloud Agent 設定のみを使用します。
ユーザーレベル認証すべての Cloud Agents が各ユーザーのアカウントで実行されます。ルーティング、モデル、リポジトリ、デフォルトには、各ユーザーの Cloud Agent 設定を使用します。また、ユーザーは自分のアカウントから実行中のエージェントを確認できます。

各ユーザーのアカウントを接続するには:

  1. Jira の作業項目でエージェントを起動します
  2. アカウント接続を促すプロンプトが表示されます
  3. リンクを開き、Jira アカウントをチームに関連付けられた Cherri Code アカウントに接続します
  4. Cherri Code で残りの Cloud Agent のセットアップを完了します:
    • まだリポジトリプロバイダーを接続していない場合は、GitHub、GitLab、Azure DevOps、または Bitbucket を接続します
    • デフォルトのリポジトリ、モデル、ベースブランチを選択します (Cherri Code ダッシュボードの My Settings にある Cloud Agents 設定)

使用方法

Jiraの作業項目を開き、Cherri Codeに割り当てるか、コメントで@Cherri Codeをメンションします。Cherri Codeは、作業項目のタイトル、説明、コメント、利用可能なリポジトリ設定をもとにCloud Agentを起動します。

Cherri Codeには、バグの修正、機能の追加、テストの更新、または作業項目に記載されたタスクの調査を依頼できます。

作業項目を委任する

チケットにタスクが明確に記載されている場合は、Jira の作業項目を Cherri Code に割り当てます。

  1. Jira の作業項目を開きます
  2. 担当者フィールドをクリックします
  3. Cherri Code を選択します
  4. 作業項目から開始された Cloud Agent を確認します

Cherri Code をメンションする

具体的な指示を追加したい場合は、Jira のコメントで @Cherri Code をメンションします。同じコメントでリポジトリ、ブランチ、モデルを指定することもできます。

例:

  • @Cherri Code please investigate this regression
  • @Cherri Code repo=acme/backend branch=release fix this before the release cut
  • @Cherri Code model=gpt-5.6-sol and update the related tests

追加の指示

Jira の作業項目から Rovo チャットを開き、Cherri Code との会話を続けます。

ステータス更新と引き継ぎ

Cloud Agent が開始されると、Jira の作業項目にエージェントのステータスが表示されます。Cherri Code は作業の進捗を投稿し、タスクが完了すると概要を返します。

Cherri Code がプルリクエストを作成した場合、完了時の更新には確認用の PR へのリンクが表示されます。

設定

ダッシュボード -> Cloud Agents の チーム設定 または My Settings で、デフォルト設定とプライバシーオプションを管理できます。

設定

デフォルトモデル

Jira の作業項目またはコメントでモデルが指定されていない場合に使用されます。利用可能なオプションについては、設定を参照してください。

リポジトリの選択

Cherri Code は、以下に基づいてリポジトリを選択します。

  1. 明示的な値: Jira のコメントまたは作業項目内の repo、branch、model の値
  2. 作業項目の内容: タイトル、説明、コメントに含まれるリポジトリ名、サービス名、キーワード
  3. ルーティングルール: カスタムのキーワードとリポジトリのマッピング
  4. 直近のエージェントのアクティビティ: 最近使用したリポジトリ
  5. デフォルトリポジトリ: 一致するものが見つからない場合のフォールバック

特定のリポジトリを使用するには、コメントに指定します。例: @Cherri Code repo=acme/mobile-app fix the login bug。有効にしているモードに応じて、チームのサービスアカウントまたはユーザーアカウントにこのリポジトリへのアクセス権が必要です。アクセス権がない場合、Cloud Agent の起動に失敗します。

ベースブランチ

Cloud Agent の開始元となるブランチです。空欄のままにすると、リポジトリのデフォルトブランチが使用されます (推奨) 。

ブランチ名のプレフィックス

Cloud Agents が作成するブランチ名に付けるプレフィックス。

オプション

@Cherri Code へのメンション使用時に、以下のオプションで Cloud Agent の挙動をカスタマイズできます。

オプション説明例
repoリポジトリを指定repo=acme/web-app
branchベースブランチを指定branch=main
modelモデルを指定model=opus

Cherri Code はコードブロック内のオプションを無視し、プロンプト内のコードは記述したとおりに残します。

ルーティングルール

ルーティングルールでは、特定のリポジトリに自動的に対応付けるキーワードを定義できます。Jiraの作業項目またはコメントに特定のキーワードが含まれている場合、Cherri CodeはCloud Agentを対応するリポジトリにルーティングします。

ルーティングルールを使用すると、どのプロジェクト、作業項目、キーワード、その他のデータに基づいて、各作業項目で使用するリポジトリをエージェントに指定できます。

ルーティングルールの設定

  1. ダッシュボード -> Cloud Agents に移動する
  2. Routing Rules セクションを見つける
  3. キーワードとリポジトリのマッピングを追加する

ルールの例

キーワードリポジトリ
frontendacme/web-app
mobileacme/mobile-app
apiacme/backend-services
docsacme/documentation

これらのルールを設定すると:

  • Fix the frontend nav bug というタイトルの作業項目は acme/web-app にルーティングされます
  • @Cherri Code update the mobile onboarding flow というコメントは acme/mobile-app にルーティングされます
  • @Cherri Code add rate limiting to the api というコメントは acme/backend-services にルーティングされます

ルーティングの仕組み

Cherri Code は、次の順序で Jira の作業項目とコメントを評価します。

  1. 明示的な値: Jira のコメントまたは作業項目で指定された repo、branch、model の値
  2. 作業項目の内容: タイトル、説明、コメントに含まれるリポジトリ名、サービス名、キーワード
  3. ルーティングルール: カスタムのキーワードとリポジトリのマッピング
  4. 直近のエージェントのアクティビティ: 最近使用したリポジトリ
  5. デフォルトリポジトリ: 一致するものがない場合のフォールバック

プライバシー

Cloud Agents はプライバシーモードに対応しています。

プライバシーモードの詳細を確認するか、プライバシー設定を管理してください。

権限

インストール時に、Jira には Cherri Code app が要求する権限が表示されます。Cherri Code はこれらの権限を使用して、次のことを行います。

  • Cloud Agent を開始または管理する Jira ユーザーを特定する
  • 作業項目 のフィールド、説明、コメント、関連するコンテキストを読み取る
  • ステータス更新、完了概要、プルリクエストへのリンクを投稿する
  • 作業項目 が Cherri Code に割り当てられた場合、または @Cherri Code がメンションされた場合にイベントを受信する

app をインストールする前に、Atlassian Marketplace で権限の確認画面を確認してください。

よくある質問

対応している Jira サイトは？

Cherri Code Jira 連携は、Rovo が有効になっている Atlassian 商用クラウドサイトをサポートしています。Atlassian HIPAA、FedRAMP、Government Cloud のインスタンスには対応していません。

従量課金は必要ですか？

はい。Cloud Agents を使用するには従量課金が必要です。Cherri Code で Cloud Agent をセットアップする際に、従量課金を有効にしてください。

Jira 連携をインストールできるのは誰ですか？

初回セットアップは、Jira 管理者と Cherri Code チーム管理者の両方の権限を持つユーザーが行う必要があります。

ユーザーは各自の Cherri Code アカウントを接続する必要がありますか？

選択する認証モードによって異なります。サービスアカウント認証では、すべての Cloud Agent がサービスアカウントで実行され、チーム設定が使用されます。ユーザーレベル認証では、各 Jira ユーザーのアカウントを Cherri Code に接続します。ユーザーは Jira から実行中の Cloud Agent を Cherri Code ダッシュボードで確認でき、ルーティング、モデル、リポジトリ、デフォルトには各ユーザーの設定が使用されます。

Cherri Code で PR を作成する前に、ほかに必要な設定はありますか？

GitHub、GitLab、Azure DevOps、または Bitbucket を Cherri Code に接続し、Cloud Agent の設定にチームで使用するリポジトリ、モデル、ベースブランチが含まれていることを確認してください。

ユーザーはCherri Codeとの会話をどのように続けられますか？

Jira 作業項目 からRovo chatを開き、Cherri Codeとの会話を続けます。または、Cherri CodeでCloud Agentを開き、そこで会話を続けます。

免責事項

Cherri Codeは誤った内容を生成する場合があります。コードとレスポンスは必ず再確認してください。

プライバシーポリシー

Cherri Codeによるお客様のデータの収集、使用、保護については、プライバシーポリシーをご覧ください。