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

エージェントの進行状況を確認し、タスクに集中させます。

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

Coding agents are available with the GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot ビジネス and GitHub Copilot Enterprise plans.
Sign up for Copilot

この記事で

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

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

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

    • リポジトリの エージェント タブを開きます
    •     [Agents ページを開きます](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text)
    • [タスク] ボタンまたは Copilot チャット の /task コマンドを使用します
    • GitHub のページの上部にある をクリックして、[エージェント] パネルを開きます。

  2. ドロップダウン メニューを使用して、コーディング エージェントを使用するリポジトリを選択します。

  3. 必要に応じて、Copilot の pull request のベース ブランチを選択します。

  4. 必要に応じて、コーディング エージェントまたは カスタム エージェント に対して特殊な動作とツールを割り当てることを希望する場合は、 をクリックし、エージェントのドロップダウン メニューを開くことができます。 使用中のリポジトリ、organization (組織)、またはエンタープライズから、既存の カスタム エージェント を選択できます。 [ Create an agent (エージェントを作成)] をクリックして、選択したリポジトリとブランチの中に新しい エージェント プロファイル を作成することもできます。 詳しくは、「Copilotコーディングエージェント 用のカスタム エージェントの作成」をご覧ください。

    メモ

    GitHub Copilot Pro+ プランと Copilot Enterprise プランでは、サードパーティのコーディング エージェントを使用できます。

  5. 必要に応じて、 CURRENT-MODEL ドロップダウン メニューを選択し、任意の AI モデルをクリックします。

  6. 要求を説明するプロンプトを入力します。 例えば次が挙げられます。

    Implement a user-friendly message for common errors.

  7.        **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-paper-airplane" aria-label="Start task" role="img"><path d="M.989 8 .064 2.68a1.342 1.342 0 0 1 1.85-1.462l13.402 5.744a1.13 1.13 0 0 1 0 2.076L1.913 14.782a1.343 1.343 0 0 1-1.85-1.463L.99 8Zm.603-5.288L2.38 7.25h4.87a.75.75 0 0 1 0 1.5H2.38l-.788 4.538L13.929 8Z"></path></svg>** をクリックするか、<kbd>Enter キー</kbd>を押します。

Copilot は、タスクの作業を開始し、変更をプル リクエストにプッシュし、ユーザーをレビュアーとして自動的に追加します。

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

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. ローカル開発環境でエージェント セッションを開く

ローカル開発環境でエージェントをガイドすること、または人間の専門知識を必要とする任意の編集を行うことができます。

VS Code

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

メモ

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

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

  1. エージェント セッション ビューの下部の [VS Code で開く] の横にあるドロップダウン リストをクリックします。
  2.           **<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)
  1. ターミナルでコマンドを貼り付けて実行し、エージェント セッションを再開します。

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

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

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

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

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