GitHub Copilot のセッションを追跡する

はじめに

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

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

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

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

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

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

          [agents タブ](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> をクリックして、任意のページのナビゲーション バーでエージェント パネルを開き、 **View all** をクリックします。

各セッションの状態が表示されます。セッションをクリックしてセッションログと概要を開き、エージェントの進行状況、トークンの使用状況、セッション数、セッションの長さを監視できます。

タブから新しいエージェントセッションを開始できます。 GitHub Copilotにプルリクエストの作成を依頼するを参照してください。

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 は、Windows および macOS 用の拡張可能なランチャーです。 Raycast 用 GitHub Copilot 拡張機能を使うと、コンピューター上のどこにいても Copilotコーディングエージェントタスクを開始して追跡できます。

Raycast Web サイトから Raycast をインストールします。
拡張機能のページにある [Install Extension] ボタンをクリックして、Raycast の GitHub Copilot 拡張機能をインストールします。
Raycast を開いて "Copilot" を検索し、[View Tasks] コマンドを見つけて Enter キーを押します。
[GitHub でサインインをクリックし、認証フローを完了します。 Raycast が再び開きます。
タスクの一覧が表示されます。リンクされた pull request に移動するには、Enter キーを押します。セッションログを表示するには、Command+L キーを押します。

メモ

Raycast で一部のタスクを表示できない場合は、リポジトリを所有する組織で OAuth app access制限が有効になっている可能性があります。 "GitHub Copilot for Raycast" OAuth app の承認を要求する方法については、OAuth アプリの組織承認を要求するを参照してください。

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

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

特定のリポジトリの実行中および過去のエージェントセッションの一覧は、 Visual Studio Code で、GitHub Pull Requests 拡張機能で確認できます。

拡張機能をインストールしたら、サイドバーの GitHub ボタンをクリックして、Copilot のセッションを表示できます。

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

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

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

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

メモ

VS Code でセッションを開く方法は、現在VS Code Insider でのみ使用できます。

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

メモ

JetBrains IDE の Copilotコーディングエージェントはパブリックプレビューにあり、変更される可能性があります。

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

Copilot のセッションをすべて表示するには、サイドバーの GitHub Coding Agent Jobs ボタンをクリックするか、GitHub Copilot チャットからタスクを Copilot に委任した後、Open Job List ボタンをクリックします。

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

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

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

メモ

Eclipse の Copilotコーディングエージェントはパブリックプレビューにあり、変更される可能性があります。

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

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

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

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

GitHub Mobile でエージェントによって生成された現在の及び過去の pull request の一覧を表示できます。

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

Copilot に生成を依頼した、現在開いている pull request の一覧が表示されます。
pull request の一覧をフィルター処理するには、一覧の上部にあるボタンを使用します。

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

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

Copilot のセッションロッグは、GitHub または Visual Studio Code で参照できます。これらを参照することで、タスクへのアプローチ方法を理解できます。

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

メモ

Copilot には、プッシュする前に変更を検証するための自動テストとリンターを実行する機能が含まれる、独自の開発環境があります。

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

Copilot がタスクを完了するために作業している間にこれを制御できます。セッションを誘導する理由には次のようなものが挙げられます。

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

Copilot を制御するには、次の手順に従います。

       [agents タブ](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text)を開きます。

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

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

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

Copilot は、現在のツール呼び出しが完了したら、入力の実装を開始します。

メモ

ステアリングでは、メッセージごとに 1 つの Premium 要求 が使用されます。

Copilot セッションの停止

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

[Stop session] ボタンが強調されているログビューアーのスクリーンショット。

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

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

参考資料

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

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