GitHub Copilot コーディング エージェントのトラブルシューティング

タスクを Copilot に割り当てるときに発生する可能性がある問題の解決方法について説明します。

この機能を使用できるユーザーについて

Copilotコーディングエージェント は、GitHub Copilot Pro、GitHub Copilot Pro+、GitHub Copilot ビジネス、GitHub Copilot Enterprise プランで使用できます。 エージェントは、マネージド ユーザー アカウント によって所有されて明示的に無効になっているリポジトリを除き、GitHub に格納されているすべてのリポジトリで使用できます。
Sign up for Copilot

この記事で

Issue の "Assignees" 一覧に Copilot が存在しない

Copilot に問題を割り当てるには、GitHub Copilot Pro プラン、GitHub Copilot Pro+ プラン、GitHub Copilot ビジネス プラン、または GitHub Copilot Enterprise プランを通じて Copilot にアクセスがある場合のみです。

これらのプランのサブスクリプションをまだお持ちでない場合は、次のボタンをクリックして詳細を確認してください。

          <a href="https://github.com/features/copilot/plans?ref_product=copilot&ref_type=engagement&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline">
          <span>Copilot にサインアップする</span> <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-link-external" aria-label="link external icon" role="img"><path d="M3.75 2h3.5a.75.75 0 0 1 0 1.5h-3.5a.25.25 0 0 0-.25.25v8.5c0 .138.112.25.25.25h8.5a.25.25 0 0 0 .25-.25v-3.5a.75.75 0 0 1 1.5 0v3.5A1.75 1.75 0 0 1 12.25 14h-8.5A1.75 1.75 0 0 1 2 12.25v-8.5C2 2.784 2.784 2 3.75 2Zm6.854-1h4.146a.25.25 0 0 1 .25.25v4.146a.25.25 0 0 1-.427.177L13.03 4.03 9.28 7.78a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042l3.75-3.75-1.543-1.543A.25.25 0 0 1 10.604 1Z"></path></svg></a>

GitHub Copilot Pro、GitHub Copilot Pro+、GitHub Copilot ビジネス、または GitHub Copilot Enterprise を "お持ち" の場合は、Copilotコーディングエージェント が有効になっており、リポジトリに対して手動で無効にされていないことをチェックします。

これらのステップを実行してください：

メモ

Copilotコーディングエージェント が有効になっているかどうかを確認するには、Copilot の設定の「機能」ページ (github.com/settings/copilot/features) をご覧ください。

Enterprise Managed User アカウントを使用すると、Copilot が個人用リポジトリで機能しない

Copilotコーディングエージェント は、マネージド ユーザー アカウント によって所有される個人用リポジトリでは使用できません。 これは、Copilotコーディングエージェント が GitHub ホストランナーで実行されるためです。これは、マネージド ユーザー アカウント が所有する個人リポジトリでは利用できません。 詳しくは、「GitHub ホステッド ランナー」をご覧ください。

マネージド ユーザー アカウント を使って、Copilot を個人用リポジトリの issue に割り当てようとすると、GitHub Actions をリポジトリで使用できないというエラー メッセージが表示されることがあります。

Copilotコーディングエージェント を使うには、個人用リポジトリではなく、organization が所有するリポジトリを使う必要があります。

Copilotは、Copilot チャット から pull request を作成できません

Copilot に pull request を作成するように依頼し、pull request を直接作成できないという応答が返された場合は、Copilotコーディングエージェント が使用可能であることを確認します。

重要

VS Code、Visual Studio、JetBrains IDE では、プロンプトで @github チャット参加者をメンションする必要があります。 GitHub.com の Copilot チャット ではこれを省略できます。

Copilot に issue を割り当てたものの、何も起こらない

しばらく待って、ページを更新します。 Copilot が issue に対して 👀 の反応を残していることに気付くはずです。 この後すぐに、Copilot が issue に関連する下書きの pull request を開き、issue のタイムラインに表示されます。

Copilot が pull request を開いたものの、何も起こらない

Pull request のタイムラインに "Copilot が作業を開始した" イベントがある場合は、[View session] をクリックしてセッション ログを確認します。 これらはライブストリーミングされるため、Copilot が何を行っているかを確認できます。

Copilot が pull request のコメントに応答しない

Copilot は、リポジトリへの書き込みアクセス権限を持つユーザーのコメントにのみ応答します。

書き込みアクセスがあり、Copilot に割り当てられている pull request に @copilot を指定すると、コメントは Copilotコーディングエージェント に渡されます。 Copilotコーディングエージェント がコメントを見たことを示す目の絵文字 (👀) がコメントに追加されます。 その後少しして、pull request のタイムラインに "Copilot started work" イベントが追加されます。

これが発生しない場合は、Copilot がプルリクエストから解除された可能性があるか、あなたに書き込みアクセス権がないかもしれません。 Copilot は、開いているプル リクエストでのメンションにのみ応答することに注意してください。 プル リクエストがマージまたはクローズされると、Copilotコーディングエージェント は、アクティブな開発作業に集中するため、新しいメンションやコメントには応答しません。

エージェントのセッション ログによると、Copilot の作業が停止しているように見える

Copilot はしばらくの間作業が停止しているように見えた後、再度作業を開始することがあります。

セッションが停止したままの場合、1 時間後にタイムアウトになります。 再試行するには、issue の割り当てを解除した後、Copilot に再割り当てすることができます。

コメントへの応答中に Copilot の作業が停止した場合は、pull request に同じコメントをもう一度追加してみてください。

Copilot がプッシュしても、GitHub Actions のワークフローが実行されない

Copilot が pull request に変更をプッシュしても、GitHub Actions のワークフローは自動的には実行されません。

GitHub Actions のワークフローの実行を許可するには、pull request のマージ ボックスの [Approve and run workflows] ボタンをクリックします。 「GitHub Copilotによって作成されたプル要求の確認 を参照してください。

Copilot が CI チェックに合格しない変更をプッシュしている

問題に取り組んでいる間、Copilot は、GitHub Actions を利用して独自の一時的な開発環境にアクセスしています。この環境では、プッシュする前に自動テストとリンターを実行して作業を検証できます。

明確な指示が与えられた場合、それに沿って行動を取る可能性が最も高くなります。 これを行うのに最善の方法は、.github/copilot-instructions.mdファイルです。 「GitHub Copilot を使用してタスクに取り組むためのベスト プラクティス」を参照してください。

ファイアウォールに関する GitHub Copilot からの警告がある

既定では、Copilotのインターネットアクセスがファイアウォールによって制限されます。

インターネットへのaccessを制限すると、データ流出リスクを管理するのに役立ちます。Copilot からの驚くべき動作や悪意のある命令によって、コードやその他の機密情報がリモートの場所に漏洩する可能性があります。

Copilot がファイアウォールによってブロックされた要求を行おうとすると、pull request の本文 (Copilot が issue の割り当てに応答している場合) またはコメント (Copilot がコメントに応答している場合) に警告が追加されます。 警告には、ブロックされたアドレスと要求を行おうとしたコマンドが表示されます。

ファイアウォールによってブロックされたことに関する Copilot からの警告のスクリーンショット。

詳しくは、「GitHub Copilot コーディング エージェントのファイアウォールのカスタマイズまたは無効化」をご覧ください。

Copilot が添付されたスクリーンショットを取得していない

Copilotコーディングエージェント で許可される最大画像サイズは 3.00 MiB です。 これより大きい画像は要求から削除されます。

参考資料

  •         [AUTOTITLE](/copilot/tutorials/coding-agent/best-practices)

  •         [AUTOTITLE](/copilot/customizing-copilot/customizing-the-development-environment-for-copilot-coding-agent)