GitHub Copilot のセッションの追跡

はじめに

Copilot にタスクを割り当てると、バックグラウンドで自律的に機能してタスクを完了します。 「GitHub Copilot コーディング エージェントについて」を参照してください。

エージェントパネル、エージェントタブ、GitHub CLI、および GitHub Copilot の Raycast拡張機能は、リポジトリ全体にわたってエージェントセッションの概要を提供します。 それらを使って、新しいタスクを開始し、Copilot の進行状況を追跡できます。

また、Visual Studio Code から特定のリポジトリ内の Copilot のセッションを追跡することもできます。

エージェント セッションの間または後に、セッション ログを調べて、問題に対する Copilot のアプローチを理解できます。

[エージェント] タブからのエージェント セッションの追跡

実行中のエージェント セッションと過去のエージェント セッションの一覧は、GitHub または専用エージェント タブのすべてのページから確認できます。セッションを開始した場合、または別のユーザーのセッションで作業するように Copilot に求められた場合は、エージェント セッションがセッションの一覧に表示されます。

          [[エージェント] タブ](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text)を開くには、[ <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-agent" aria-label="The Agents icon" 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 に pull request の作成を依頼する を参照してください。

GitHub CLI からのエージェント セッションの追跡

          `agent-task` コマンド セットは、GitHub CLI の v2.80.0 以降でのみ使用できます。 このコマンド セットはパブリック プレビュー段階であり、変更される可能性があります。

GitHub CLI から gh agent-task list コマンドを使って、実行中と過去のエージェント セッションの一覧を表示できます。 出力では、ご自分の最近のセッションの一覧が示されます。

特定のセッションについてさらに詳しい情報を見るには、gh agent-task view コマンドを使います。 たとえば、monalisa/bookstore リポジトリの pull request #123 に関連付けられているセッションに関する情報を見るには、gh agent-task view --repo monalisa/bookstore 123 を実行します。

セッション ログを表示するには、--log オプションを追加します。 エージェントが動作している間、ライブ ログをストリーミングする必要がある場合は、--follow オプションを使います。

使用できるすべてのオプションを確認するには、gh agent-task list --help または gh agent-task view --help を実行します。

Raycast からのエージェント セッションの追跡

Raycast は、macOS 用の拡張可能な起動ツールです。 Raycast 用 GitHub Copilot 拡張機能を使うと、コンピューター上のどこにいても Copilot コーディング エージェント タスクを開始して追跡できます。

1. Raycast Web サイトから Raycast をインストールします。
2. 拡張機能のページにある [Install Extension] ボタンをクリックして、Raycast の GitHub Copilot 拡張機能をインストールします。
3. Raycast を開いて "Copilot" を検索し、[View Tasks] コマンドを見つけて Enter キーを押します。

4.        **[Sign in with GitHub]** をクリックして、認証フローを完了します。 Raycast が再び開きます。
   

5. タスクの一覧が表示されます。 リンクされた pull request に移動するには、Enter キーを押します。 セッション ログを表示するには、Command+L キーを押します。

Raycast から新しいエージェント セッションを始めることもできます。 「GitHub Copilot に pull request の作成を依頼する」を参照してください。

Visual Studio Code からセッションを追跡する

          [GitHub Pull Requests 拡張機能](https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github)を使用すると、Visual Studio Code 内の特定のリポジトリの実行中および過去のエージェント セッションの一覧を確認できます。

拡張機能をインストールすると、サイドバーの [GitHub] ボタンをクリックすることで Copilot のセッションが表示されます。

一覧表示されている各セッションの状態を一目で確認し、各セッションをクリックすることで、Visual Studio Code 内の pull request にアクセスできます。

セッション ログを表示するには、一覧内の pull request をクリックした後、[View Session] をクリックします。

Visual Studio Code から新しいエージェント セッションを開始することもできます。 「GitHub Copilot に pull request の作成を依頼する」を参照してください。

直接VS Codeでエージェント セッションを開くには、エージェントタブの 「VS Codeで開く」 オプションをクリックしてください。

JetBrains IDE からのセッションの追跡

GitHub Copilot チャット 拡張機能を使用して、JetBrains IDE でプロジェクトの実行中および過去のエージェント セッションの一覧を表示できます。 「環境への GitHub Copilot 拡張機能のインストール」を参照してください。

Copilotのセッションをすべて表示するには、サイドバーの GitHub Coding Agent ジョブ ボタンをクリックするか、GitHub Copilot チャット から Copilot にタスクを委任した後に [ジョブ 一覧を開く ] ボタンをクリックします。

一覧に表示される各セッションの状態を一目で確認できます。 [ ブラウザーで開く ] をクリックしてブラウザーで pull request を開くか、実行中のジョブを右クリックして [ ジョブの取り消し ] をクリックして取り消します。

Copilot は、エージェント ジョブが開始および終了したときにも通知します。

Eclipse からのセッションの追跡

GitHub Copilot チャット 拡張機能を使用して、Eclipse でプロジェクトの実行中および過去のエージェント セッションの一覧を確認できます。 「環境への GitHub Copilot 拡張機能のインストール」を参照してください。

Copilotのすべてのセッションは、チャットウィンドウの右上にある をクリックするか、またはGitHub Copilot チャットからCopilotにタスクを委任した後に、[ジョブ一覧を開く]ボタンをクリックすることで表示できます。

一覧に表示される各セッションの状態を一目で確認できます。 [ ブラウザーで開く ] をクリックしてブラウザーで pull request を開くか、実行中のジョブを右クリックして [ ジョブの取り消し ] をクリックして取り消します。

Copilot は、エージェント ジョブが開始および終了したときにも通知します。

GitHub Mobile からセッションを追跡する

GitHub Mobile でエージョンによって生成された実行中および過去の pull request の一覧を表示できます。

1. GitHub Mobile ホーム ページの [Agents] セクションで、[Agent Tasks] をタップします。

   Copilot に生成を依頼した、現在開いている pull request の一覧が表示されます。

2. pull request の一覧をフィルター処理するには、一覧の上部にあるボタンを使用します。

   たとえば、マージされたタスクのみを表示するには、[Open] をタップしてから、ドロップダウンで [Merged] をタップします。

   

Copilot のアプローチを理解するためのセッション ログの使用

GitHub または Visual Studio Code で Copilot のセッション ログを調べると、タスクに対してどのようなアプローチが取られたかを把握できます。

セッション ログでは、Copilot の内部モノローグと、リポジトリの理解、変更の実施、その作業の検証に使われたツールを確認できます。

エージェント タブから Copilot セッションを制御する

Copilot を操作する間、タスクを完了させることができます。 セッションを進行する理由には次のようなものがあります。

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

Copilot を操作するには、次の手順に従います。

1.        [[エージェント] タブ](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text&utm_source=docs-web-copilot-agents&utm_medium=docs&utm_campaign=universe25post)を開きます。
   

2.        **エージェント セッション**の一覧で、さらに入力するタスクを選択します。
   

3. プロンプトボックスで、Copilot がタスクを実行している際にプロンプトします。

たとえば、Use our existing ErrorHandler utility class instead of writing custom try-catch blocks for each endpoint. のように指定します。

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

Copilot セッションの停止

セッション ログ ビューアーの [Stop session] をクリックして、Copilot がタスクで動作し続けるのを停止できます。

次のような理由でセッションを停止することがあります。

• 必要な作業の説明を間違えたため、やり直します。
• 要求した変更を行う必要がないことがわかったので、それ以上作業しないよう Copilot を停止する必要があります。

参考資料

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

•         [AUTOTITLE](/copilot/using-github-copilot/coding-agent/troubleshooting-copilot-coding-agent)