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

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

GitHub Copilot Pro プラン、GitHub Copilot Pro+ プラン、GitHub Copilot ビジネス プラン、または GitHub Copilot Enterprise プランのいずれかを通じて Copilot にアクセスできる場合にのみ、issue を Copilot に割り当てることができます。

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

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

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

• GitHub Copilot ビジネス または Copilot Enterprise プランをご利用の場合、Copilotコーディングエージェント を使用できるかどうかは、Enterprise または organization の管理者が制御します。 「企業GitHub Copilot コーディング エージェントの管理」を参照してください。

• Organization が所有するリポジトリの場合、リポジトリで Copilotコーディングエージェント を使用できるかどうかは、organization、Enterprise、またはその両方の管理者が管理します。 「GitHub Copilot コーディング エージェントを組織に追加する を参照してください。

• 個人用のリポジトリの場合、リポジトリ内で Copilotコーディングエージェント が使用できるかどうかはユーザーのアカウントの設定で構成されます。 「個々のサブスクライバーとしての GitHub Copilot ポリシーの管理」を参照してください。

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

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

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

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

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

Copilot に pull request を作成するように依頼し、pull request を直接作成できないという応答が返された場合は、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 が pull request から割り当てを解除されたか、ユーザーに書き込みアクセス権限がない可能性があります。 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 チェックに合格しない変更をプッシュしている

Issue の作業中、Copilot は、GitHub Actions を利用して独自の一過性の開発環境にアクセスできます。この開発環境では、自動的なテストとリンターを実施することで、プッシュする前に作業の検証を行えます。

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

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

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

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

Copilot がファイアウォールによってブロックされた要求を行おうとすると、pull request の本文 (Copilot が issue の割り当てに応答している場合) またはコメント (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)