Skip to main content

GitHub Copilot のセッションの追跡

You can use the agents panel or page, Visual Studio Code, JetBrains IDEs, the GitHub CLI, Raycast and session logs to track Copilot's progress and understand its approach.

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

Copilot コーディング エージェント は、GitHub Copilot Pro、GitHub Copilot Pro+、GitHub Copilot Business、GitHub Copilot Enterprise プランで使用できます。 エージェントは、マネージド ユーザー アカウント によって所有されて明示的に無効になっているリポジトリを除き、GitHub に格納されているすべてのリポジトリで使用できます。
Sign up for Copilot

はじめに

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

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

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

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

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

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

[エージェント] タブを開くには、[ をクリックして、任意のページのナビゲーション バーでエージェント パネルを開き、[すべて表示] をクリックします。

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

タブから新しいエージェント セッションを開始できます。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 で表示できないタスクがある場合は、リポジトリを所有する organization で OAuth app のアクセス制限が有効になっている可能性があります。 "GitHub Copilot for Raycast" OAuth app の承認を要求する方法については、「OAuth アプリの Organization の承認を要求する」をご覧ください。

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

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

GitHub Pull Requests 拡張機能を使用すると、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で開く」 オプションをクリックしてください。

メモ

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

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

メモ

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

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

Copilotのセッションをすべて表示するには、サイドバーのGitHub Coding Agent ジョブ ボタンをクリックするか、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] をタップします。

    Screenshot of the status dropdown list with a check mark against 'Open'.

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

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

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

メモ

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

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

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

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

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

  1. [エージェント] タブを開きます。
  2. エージェント セッションの一覧で、さらに入力するタスクを選択します。
  3. プロンプトボックスで、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 を停止する必要があります。

参考資料