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

はじめに

          Copilotタスクを与えた後、バックグラウンドで自律的に動作してタスクを完了します。 「[AUTOTITLE](/copilot/concepts/about-copilot-coding-agent)」を参照してください。

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

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

エージェントセッション中またはエージェントセッション後に、セッションログを調べて、問題に対する 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にプルリクエストの作成を依頼するを参照してください。

エージェントセッションを追跡する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" を検索し、[タスクの 表示] コマンドを見つけて、 Enter キーを押します。
[GitHubでサインイン] をクリックし、認証フローを完了します。 Raycast が再び開きます。
タスクの一覧が表示されます。リンクされた pull request に移動するには、Enter キーを押します。セッションログを表示するには、Command+L キーを押します。

メモ

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

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

          Visual Studio Code からのセッションのトラッキング

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

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

一覧に表示される各セッションの状態を一目で確認したり、そのセッションをクリックして Visual Studio Code内の pull request に移動したりできます。

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

          Visual Studio Codeから新しいエージェント セッションを開始することもできます。 「[AUTOTITLE](/copilot/how-tos/agents/copilot-coding-agent/asking-copilot-to-create-a-pull-request#asking-copilot-to-create-a-pull-request-from-copilot-chat-in-visual-studio-code)」を参照してください。

          VS Codeでエージェント セッションを直接開くには、[エージェント] タブ**の [VS Codeで開く**] オプションをクリックします。

メモ

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

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

メモ

          Copilot クラウド エージェント は JetBrains IDE にある パブリック プレビューであり、変更される可能性があります。

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

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

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

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

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

メモ

          Copilot クラウド エージェント Eclipse は パブリック プレビューであり、変更される可能性があります。

          GitHub Copilot チャット拡張機能を使用して、Eclipse でプロジェクトの実行中および過去のエージェント セッションの一覧を確認できます。 「[AUTOTITLE](/copilot/how-tos/set-up/install-copilot-extension?tool=eclipse)」を参照してください。

          Copilotのすべてのセッションを表示するには、チャット ウィンドウの右上にある [**<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>**] をクリックするか、タスクを**** からCopilotに委任した後、[GitHub Copilot チャット] ボタンをクリックします。

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

          GitHub Mobile からのセッションのトラッキング

エージェントによって生成された実行中のプル要求と過去のプル要求の一覧は、 GitHub Mobileで確認できます。

       GitHub Mobileホーム ページの [エージェント] セクションで、[**エージェント タスク]** をタップします。

生成するように Copilot 求めた現在開いているプル要求の一覧が表示されます。

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

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

セッションログへのコミットのトレース

          Copilot クラウド エージェントからのコミットには、次の特性があります。

すべてのコミットはCopilotによって作成され、タスクを開始した人は共同作成者としてマークされます。
各コミットメッセージには、そのコミットのセッションログへのリンクが含まれているため、コードレビュー中に変更 Copilot 理由を理解したり、後で監査のためにトレースしたりできます。

        Copilot クラウド エージェントからのコミットは署名され、GitHubでは "検証済み" として表示されます。

セッションログを使用して 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 セッションの停止

セッションログビューアーで [Copilot] をクリックすると、**** がタスクの作業を続行するのを停止できます。

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

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

必要な作業の説明を間違えたため、やり直します。
要求した変更を行う必要はないことを認識したので、 Copilot がそれ以上作業を行うのを止めたいと考えています。

参考資料

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

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