Copilot を使用して issue を処理する

はじめに

人間のソフトウェア開発者に対して行うのと同じように、GitHub の issue を Copilot に割り当てることができます。 Copilot は issue の処理を開始し、pull request を発生させ、処理が完了したら、レビューを要求します。 詳しくは、「Copilot へのタスクの割り当てについて」をご覧ください。

以前に Copilot を使用して issue を処理したことがない場合は、良い結果を得るための有用なアドバイスを「Best practices for using Copilot to work on tasks」でご覧ください。

Copilot に issue を割り当てる

Copilot に issue を割り当てることで、issue の処理を開始するように Copilot に依頼できます。

以下のようにして Copilot に issue を割り当てることができます。

• GitHub.com で (次のセクションをご覧ください)
• GitHub Mobile 上
• GitHub API を使用して (この記事の後半をご覧ください)
• GitHub CLI を使用する (「gh issue edit」をご覧ください)

GitHub.com で Copilot に issue を割り当てる

別のユーザーを割り当てるのとまったく同じ方法で、GitHub.com の Copilot に issue を割り当てることができます。

1. GitHub で、リポジトリのメイン ページに移動します。

2. リポジトリ名の下にある [イシュー] をクリックします。

   

3. Copilot に割り当てる issue を開きます。

4. 右側のメニューで [担当者] をクリックします。

   

5. 担当者の一覧から [Copilot] をクリックします。

   

GitHub.com のその他の場所から Copilot に issue を割り当てることもできます。

• リポジトリの [Issues] ページにある issue の一覧から。
• GitHub プロジェクト で issue を表示しているとき。

GitHub API を使用して issue を Copilot に割り当てる

GraphQL API に要求を行うことで、Copilot に issue を割り当てることができます。

1. personal access tokenや GitHub App ユーザーからサーバーへのトークンなどのユーザー トークンを使用して API で認証していることを確認してください。

2. GraphQL API のリポジトリの suggestedActors に Copilot が含まれているかどうかを確認して、Copilot コーディング エージェント がリポジトリで有効になっていることを確認します。 monalisa をリポジトリ所有者に置き換え、octocat を名前に置き換えます。

   GraphQL

   query {
     repository(owner: "monalisa", name: "octocat") {
       suggestedActors(capabilities: [CAN_BE_ASSIGNED], first: 100) {
         nodes {
           login
           __typename
   
           ... on Bot {
             id
           }
   
           ... on User {
             id
           }
         }
       }
     }
   }
   

   ユーザーとリポジトリで Copilot コーディング エージェント が有効になっている場合、クエリから返される最初のノードの login 値は copilot-swe-agent です。

3. Copilot に割り当てる issue の GraphQL グローバル ID をフェッチし、monalisa をリポジトリの所有者、octocat を名前、9000 を issue 番号に置き換えます。

   GraphQL

   query {
     repository(owner: "monalisa", name: "octocat") {
       issue(number: 9000) {
         id
         title
       }
     }
   }
   

4. replaceActorsForAssignable GraphQL のミューテーションを使用して、issue を Copilot に割り当てます。 ISSUE_ID を前のステップで返された ID に置き換え、BOT_ID をその前のステップで返された ID に置き換えます。

   GraphQL

   mutation {
     replaceActorsForAssignable(input: {assignableId: "ISSUE_ID", assigneeIds: ["BOT_ID"]}) {
       assignable {
         ... on Issue {
           id
           title
           assignees(first: 10) {
             nodes {
               login
             }
           }
         }
       }
     }
   }
   

Issue に関する Copilot の進行状況を追跡する

Copilot に issue を割り当てた直後に、Copilot は issue に対して 👀 の応答を残します。

数秒後、Copilot は、元の issue にリンクされた下書きの pull request を開きます。 イベントが issue のタイムラインに表示され、pull request にリンクされます。

Copilot が issue を処理するためのエージェント セッションを開始します。 "Copilot started work" イベントが pull request タイムラインに表示され、Copilot が機能すると、通常の状態の更新で pull request 本文が更新され、コミットがブランチにプッシュされます。

Copilot の処理状況を確認する場合は、[View session] をクリックします。 セッション ログ ビューアーが表示され、Copilot による issue の処理のライブ ログが表示されます。 Issue に対する Copilot の処理を停止する場合は、[Stop session] をクリックします。 「Copilot コーディング エージェント ログの使用」を参照してください。

Copilot が終了すると、エージェント セッションが終了し、Copilot がレビューを要求し、通知をトリガーします。 さらに、pull request タイムラインに "Copilot finished work" イベントが表示されます。

Pull request で Copilot を操作する

Copilot が issue の処理を完了したら、pull request を十分に確認し、変更が必要な内容についてコメントする必要があります。 「Copilot によって作成された pull request をレビューする」を参照してください。

参考資料

• Best practices for using Copilot to work on tasks
• Copilot のコーディング エージェントのトラブルシューティング