Thanks to visit codestin.com
Credit goes to docs.github.com

Skip to main content

GitHub Copilotのセッションの追跡

エージェント パネルまたはページ、 Visual Studio Code、JetBrains IDE、Eclipse、 GitHub CLI、Raycast、セッション ログを使用して、 Copilotの進行状況を追跡し、そのアプローチを理解できます。

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

Copilot クラウドエージェント は、 GitHub Copilot Pro、 GitHub Copilot Pro+、 GitHub Copilot ビジネス 、および GitHub Copilot Enterprise プランで使用できます。 エージェントは、GitHubが所有し、明示的に無効にされているリポジトリを除き、マネージド ユーザー アカウントに格納されているすべてのリポジトリで使用できます。
Sign up for Copilot

はじめに

          Copilotタスクを与えた後、バックグラウンドで自律的に動作してタスクを完了します。 「[AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-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 クラウドエージェント タスクを開始して追跡し、コンピューター上のどこにいてもセッション ログをライブで監視できます。

  1.        [Raycast Web サイト](https://www.raycast.com)から Raycast をインストールします。
    
  2. 拡張機能のページの [拡張機能のインストール] ボタンをクリックして、raycast のGitHub Copilot拡張機能をインストールします
  3. Raycast を開き、"Copilot" を検索し、[タスクの 表示] コマンドを見つけて、 Enter キーを押します。
  4. [GitHubでサインイン] をクリックし、認証フローを完了します。 Raycast が再び開きます。
  5. タスクの一覧が表示されます。 タスクを選択し、次のキーボード ショートカットを使用します。
    • セッション ログをライブで監視するには、 Enter キーを押します。 ログはリアルタイムで更新されるため、raycast を離れることなく Copilotの進行状況を監視できます。
    • ブラウザーでセッション ログを開くには、 Command+Enter (macOS) またはCtrl+Enter (Windows) を押します。
    • リンクされた pull request を開くには、Command+P (macOS) または Ctrl+P (Windows) を押します。

メモ

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

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

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

特定のリポジトリの実行中および過去のエージェント セッションの一覧は、Visual Studio Codeを使用して で確認できます。

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

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

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

          Visual Studio Codeから新しいエージェント セッションを開始することもできます。 「[AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr#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 拡張機能をインストールする」を参照してください。

          Copilotのすべてのセッションを表示するには、サイドバーの **GitHub Cloud Agent Jobs** ボタンをクリックするか、タスクを **** から Copilot に委任した後で ギットハブ コパイロット チャット ボタンをクリックします。

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

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

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

メモ

          Copilot クラウドエージェント Eclipse は パブリック プレビューであり、変更される可能性があります。
          ギットハブ コパイロット チャット拡張機能を使用して、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に委任した後、[ギットハブ コパイロット チャット] ボタンをクリックします。

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

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

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

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

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

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

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

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

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

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

          Copilot クラウドエージェントからのコミットには、次の特性があります。
  • すべてのコミットはCopilotによって作成され、タスクを開始した人は共同作成者としてマークされます。
  • 各コミット メッセージには、そのコミットのセッション ログへのリンクが含まれているため、コード レビュー中に変更 Copilot 理由を理解したり、後で監査のためにトレースしたりできます。
  • Copilot クラウドエージェントからのコミットは署名され、GitHubでは "検証済み" として表示されます。

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

          Copilot、GitHub、または Raycast でVisual Studio Codeのセッション ログを調べて、タスクにどのように取り組んだかを理解できます。

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

メモ

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

[エージェント] タブから Copilot セッションを操作する

タスクの完了中に Copilot を誘導できます。 セッションを進行する理由には次のようなものがあります。

  • Copilot は間違った方向に向いているように見え、より明確にしたいと考えています。

  • 必要な作業の説明を間違えたため、やり直します。

            Copilotを操作するには、次の手順に従います。
    
  1.        [[エージェント] タブ](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text)を開きます。
    
  2.        **エージェント セッション**の一覧で、さらに入力するタスクを選択します。
    
  3. タスクを実行中のプロンプト ボックス内で、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 がそれ以上作業を行うのを止めたいと考えています。

詳細については、次を参照してください。