Copilot のコーディングエージェント管理

GitHubのエージェント機能を使用する場合は、Copilot コーディングエージェントが有効になっているリポジトリ内 の [エージェント ] タブを使用して、ワークフローを終了せずにエージェントセッションを開始、監視、管理できます。 [エージェント] ページを使用して、エージェントセッションを表示および開始することもできます。 Copilot コーディングエージェントを有効にする方法については、GitHub Copilot コーディングエージェントへのアクセスの管理を参照してください。

1. リポジトリを選択し、エージェントを選択する

新しいエージェントタスクを開始します。

リポジトリの エージェント タブを開きます

    [[エージェント] ページ](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text)を開く

    **Copilot チャット** の `/task`] ボタンまたは [](https://github.com/copilot?ref_product=copilot&ref_type=engagement&ref_style=text) コマンドを使用する

GitHub のページの上部にあるをクリックして、[エージェント] パネルを開きます。

ドロップダウンメニューを使用して、Copilot を必要に応じて使用するリポジトリを選択します。
必要に応じて、Copilot の pull request のベースブランチを選択します。
必要に応じて、をクリックし、「カスタムエージェント」ドロップダウンメニューを開いて、特殊な動作とツールを使用するカスタムエージェントを割り当てることができます。リポジトリ、組織、エンタープライズ内の既存のカスタムエージェントを選択できます。 エージェントを作成 ボタンをクリックして、選択したリポジトリとブランチに新しいエージェントプロファイルを作成することもできます。詳しくは、「カスタムエージェントの作成」をご覧ください。
必要に応じて、 CURRENT-MODEL ドロップダウンメニューを選択し、任意の AI モデルをクリックします。
リクエストを説明するプロンプトを入力します。例えば次が挙げられます。
```
Implement a user-friendly message for common errors.
```
タスクの開始 をクリックするか、Return キーを押します。

Copilot はタスクの作業を開始し、変更を新しい pull request にプッシュし始め、そこでレビュー担当者として自動的に追加されます。

新しいエージェントタスクを開始する方法の詳細については、 GitHub Copilot に pull request の作成を依頼するを参照してください。

2. エージェントのアクティビティを監視する

Copilot が動作し始めると、セッションログは、その進行状況と思考プロセスで引き続き更新されます。

各セッションの状態が表示されます。セッションをクリックしてセッションログを開きます。このログでは、エージェントの進行状況を監視したり、使用しているツールを確認したり、セッションの実行時間を追跡したりできます。

エージェントセッションは、GitHub CLI、GitHub Mobile、Visual Studio Code、Raycast、JetBrains IDE から追跡することもできます。詳しくは、「GitHub Copilot のセッションの追跡」をご覧ください。

3. 必要に応じてエージェントをリダイレクトする

実行を停止せずに、Copilot にステップインして ステアリング入力 を提供できます。ステアリングでは、メッセージごとに 1 つの Premium 要求 が使用されます。

セッションを進行する理由には次のようなものがあります。

Copilot は間違った方向に向いているように見え、より明確にしたいと考えています。
必要な作業の説明を間違えたため、やり直します。

エージェントセッションログの下にあるプロンプトボックスで、Copilot をタスクの実行中に表示します。例えば次が挙げられます。

Use our existing ErrorHandler utility class instead of writing custom try-catch blocks for each endpoint.

Copilot は現在のツール呼び出しが終了したら、入力を反映します。

4. ローカル開発環境でエージェントセッションを開く

Copilot をローカル開発環境での更なる変更について指導することができるほか、人の専門知識が必要な場合は編集を行うことができます。

VS Code

エージェントセッションビューの下部にある VS Code で開く ボタンをクリックして、セッションを直接 VS Code で起動します。

メモ

VS Code でセッションを開くには、最新バージョンの VS Code 、GitHub Copilot 拡張機能、および GitHub Pull Requests 拡張機能が必要です。

GitHub Copilot CLI（コマンドラインインターフェース）

エージェントセッションビューの下部にある Open in VS Code の横にあるドロップダウンリスト をクリックします。

          **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-agent" aria-label="Agent" role="img"><path d="M14.5 8.9v-.052A2.956 2.956 0 0 0 11.542 5.9a.815.815 0 0 1-.751-.501l-.145-.348A3.496 3.496 0 0 0 7.421 2.9h-.206a3.754 3.754 0 0 0-3.736 4.118l.011.121a.822.822 0 0 1-.619.879A1.81 1.81 0 0 0 1.5 9.773v.14c0 1.097.89 1.987 1.987 1.987H4.5a.75.75 0 0 1 0 1.5H3.487A3.487 3.487 0 0 1 0 9.913v-.14C0 8.449.785 7.274 1.963 6.75A5.253 5.253 0 0 1 7.215 1.4h.206a4.992 4.992 0 0 1 4.586 3.024A4.455 4.455 0 0 1 16 8.848V8.9a.75.75 0 0 1-1.5 0Z"></path><path d="m8.38 7.67 2.25 2.25a.749.749 0 0 1 0 1.061L8.38 13.23a.749.749 0 1 1-1.06-1.06l1.719-1.72L7.32 8.731A.75.75 0 0 1 8.38 7.67ZM15 13.45h-3a.75.75 0 0 1 0-1.5h3a.75.75 0 0 1 0 1.5Z"></path></svg> をクリックします。GitHub Copilot CLI（コマンドラインインターフェース）

で続行**し、copilot --resume=<session ID> コマンドをクリップボードにコピーします。

          ![[Continue in Copilot CLI]\(Copilot CLI で続行\) が濃いオレンジ色のアウトラインで強調表示されているセッション アクションドロップダウン リストのスクリーンショット。](/assets/images/help/copilot/coding-agent/open-agent-session-in-copilot-cli.png)

ターミナルでコマンドを貼り付けて実行し、エージェントセッションを再開します。

5. エージェントコードの確認とマージ

Copilot がセッションを完了したら、プルリクエストに移動して変更を確認できます。 pull request から、差分をスキャンしたり、Copilot にさらに改善を要求したり、変更を承認してマージしたりできます。「GitHub Copilot によって作成された pull request のレビュー」を参照してください。

6. エージェントセッションをアーカイブする

停止されたセッションをアーカイブして、セッションの一覧から削除できます。

アーカイブするエージェントセッションを開きます。
右上隅にあるをクリックし、 セッションをアーカイブ をクリックします。
開いたダイアログボックスで、[ はい、アーカイブ] をクリックします。