Copilot エージェント用の GitHub アプリの構成

GitHub App を構成して、Copilot agent に関連付ける方法について説明します。

この記事の内容

Note

GitHub Copilot Extensions は パブリック プレビュー 段階であり、変更される可能性があります。

サーバーを構成し、GitHub App を作成したら、Copilot エージェントで使用するように GitHub App を構成する必要があります。

前提条件

GitHub App の構成

  1. GitHub の任意のページの右上隅にある、自分のプロファイル写真をクリックします。

  2. アカウント設定にアクセスしてください。

    • 個人用アカウントが所有するアプリの場合は、[設定] をクリックします。
    • 組織が所有するアプリの場合:
      1. [自分の組織] をクリックします。
      2. 組織の右側にある [設定] をクリックします。
    • Enterprise が所有するアプリの場合:
      1. Enterprise Managed Users を使用する場合は、[Enterprise] をクリックして Enterprise アカウントの設定に移動します。
      2. 個人用アカウントを使用する場合は、[Enterprise] をクリックしてから、Enterprise の右側にある [設定] をクリックします。

  3. GitHub App 設定にアクセスしてください。

    • 個人用アカウントまたは組織が所有するアプリの場合:
      1. 左側のサイドバーで、 [開発者向け設定] をクリックし、 [GitHub Apps] をクリックします。
    • Enterprise が所有するアプリの場合:
      1. 左側のサイドバーで、 [設定] から GitHub Apps をクリックします。

  4. Copilot Extension の場合、構成する GitHub App の右側にある [編集] をクリックします。

  5. [ユーザーの識別と承認] セクションの [コールバック URL] にサーバーのホスト名を入力し、 [変更の保存] をクリックします。

    Note

    このステップは、インストール時にユーザー認証(OAuth)を要求する場合のみ必要です。

    サーバーのホスト名は、サーバーを構成したときにターミナルからコピーした転送エンドポイントです。 詳しくは、「Configuring your server to host your Copilot agent」を参照してください。

    ngrok でエフェメラル ドメインを使用している場合は、ngrok サーバーを再起動するたびにこの URL を更新する必要があります。

  6. 左側のサイドバーで、[アクセス許可とイベント] をクリックします。

  7. [アカウントのアクセス許可] セクションの展開には、セクション内の任意の場所をクリックします。

  8. 「GitHub Copilot Chat」の行で、「アクセス:」ドロップダウンメニューを選択し、「読み取り専用」をクリックします。 [変更を保存] をクリックします。

  9. 左側のサイドバーで、[Copilot] をクリックします。

  10. GitHub Marketplace 開発者契約およびGitHub プレリリースライセンス条項を読み、Copilot Extensionを作成するための条項に同意します。

  11. [アプリの種類] セクションで、ドロップダウン メニューを選択して、 Agent をクリックします。

  12. 「URL」の欄には、ターミナルからコピーしたサーバーのホスト名(転送エンドポイントとも呼ばれる)を入力します。

    Note

    ngrok でエフェメラル ドメインを使用している場合は、ngrok サーバーを再起動するたびにこの URL を更新する必要があります。

  13. [推論の説明] で、エージェントの簡単な説明を入力し、[ 保存] をクリックします。 これは、ユーザーがチャット ウィンドウでエージェントのスラッグの上にマウス ポインターを置いたときに表示がされる説明です。

  14. 事前承認 URL は、拡張機能の承認プロセスを開始する Web サイト上のリンクです。 拡張機能を承認すると、ユーザーはこの URL にリダイレクトされます。 事前承認 URL を使用している場合は、[事前承認 URL] に URL を入力し、[変更の保存] をクリックします。

  15. GitHub App 設定の左側のサイドバーで、[アプリのインストール] をクリックし、アプリをインストールするアカウントの横にある [インストール] をクリックします。

  16. GitHub の任意のページで、ページの右下にある GitHub Copilot アイコンをクリックします。

    GitHub Copilot Chat パネルが表示されます。 パネルのサイズ変更を行うには、上端または左端をクリックしてドラッグします。

  17. パネルに Copilot で行った以前の会話が含まれている場合は、パネルの右上にある [新しい会話] アイコン (プラス記号) をクリックします。

    新しい会話ボタンのスクリーンショット。濃いオレンジ色の枠線で強調表示されています。

  18. 拡張機能を呼び出すには、「@EXTENSION-NAME」と入力し、拡張機能名内のスペースを - に置き換えてから、Enter を押します。

  19. 拡張機能を初めて使用する場合は、認証を求められます。 画面の手順に従って拡張機能を認証します。

  20. チャット ウィンドウで拡張機能に質問します。 たとえば、 What is the software development lifecycle? です。