Note
GitHub Copilot Extensions は パブリック プレビュー 段階であり、変更される可能性があります。
サーバーを構成し、GitHub App を作成したら、Copilot エージェントで使用するように GitHub App を構成する必要があります。
前提条件
- Copilot agent をデプロイするようにサーバーを構成しており、ホスト名 (転送エンドポイントとも呼ばれる) があります。 詳しくは、「Copilot エージェントをデプロイするためのサーバーの構成」をご覧ください。
- Copilot エージェントの GitHub App を作成しました。 詳しくは、「Copilot 拡張機能用の GitHub アプリの作成」をご覧ください。
GitHub App の構成
-
GitHub の任意のページの右上隅にある、自分のプロファイル写真をクリックします。
-
アカウント設定にアクセスしてください。
- 個人用アカウントが所有するアプリの場合は、[設定] をクリックします。
- 組織が所有するアプリの場合:
- [自分の組織] をクリックします。
- 組織の右側にある [設定] をクリックします。
- Enterprise が所有するアプリの場合:
- Enterprise Managed Users を使用する場合は、[Enterprise] をクリックして Enterprise アカウントの設定に移動します。
- 個人用アカウントを使用する場合は、[Enterprise] をクリックしてから、Enterprise の右側にある [設定] をクリックします。
-
GitHub App 設定にアクセスしてください。
- 個人用アカウントまたは組織が所有するアプリの場合:
- 左側のサイドバーで、 [開発者向け設定] をクリックし、 [GitHub Apps] をクリックします。
- Enterprise が所有するアプリの場合:
- 左側のサイドバーで、 [設定] から GitHub Apps をクリックします。
- 個人用アカウントまたは組織が所有するアプリの場合:
-
Copilot Extension の場合、構成する GitHub App の右側にある [編集] をクリックします。
-
[ユーザーの識別と承認] セクションの [コールバック URL] にサーバーのホスト名を入力し、 [変更の保存] をクリックします。
Note
このステップは、インストール時にユーザー認証(OAuth)を要求する場合のみ必要です。
サーバーのホスト名は、サーバーを構成したときにターミナルからコピーした転送エンドポイントです。 詳しくは、「Copilot エージェントをデプロイするためのサーバーの構成」を参照してください。
ngrok でエフェメラル ドメインを使用している場合は、ngrok サーバーを再起動するたびにこの URL を更新する必要があります。
-
左側のサイドバーで、[アクセス許可とイベント] をクリックします。
-
[アカウントのアクセス許可] セクションの展開には、セクション内の任意の場所をクリックします。
-
「GitHub Copilot Chat」の行で、「アクセス:」ドロップダウンメニューを選択し、「読み取り専用」をクリックします。 [変更を保存] をクリックします。
-
左側のサイドバーで、[Copilot] をクリックします。
-
GitHub Marketplace 開発者契約およびGitHub プレリリースライセンス条項を読み、Copilot Extensionを作成するための条項に同意します。
-
[アプリの種類] セクションで、ドロップダウン メニューを選択して、 Agent をクリックします。
-
「URL」の欄には、ターミナルからコピーしたサーバーのホスト名(転送エンドポイントとも呼ばれる)を入力します。
Note
ngrok でエフェメラル ドメインを使用している場合は、ngrok サーバーを再起動するたびにこの URL を更新する必要があります。
-
[推論の説明] で、エージェントの簡単な説明を入力し、[ 保存] をクリックします。 これは、ユーザーがチャット ウィンドウでエージェントのスラッグの上にマウス ポインターを置いたときに表示がされる説明です。
-
事前承認 URL は、拡張機能の承認プロセスを開始する Web サイト上のリンクです。 拡張機能を承認すると、ユーザーはこの URL にリダイレクトされます。 事前承認 URL を使用している場合は、[事前承認 URL] に URL を入力し、[変更の保存] をクリックします。
-
GitHub App 設定の左側のサイドバーで、[アプリのインストール] をクリックし、アプリをインストールするアカウントの横にある [インストール] をクリックします。
-
GitHub の任意のページで、ページの右下にある GitHub Copilot アイコンをクリックします。
GitHub Copilot Chat パネルが表示されます。 パネルのサイズ変更を行うには、上端または左端をクリックしてドラッグします。
-
パネルに Copilot で行った以前の会話が含まれている場合は、パネルの右上にある [新しい会話] アイコン (プラス記号) をクリックします。
-
拡張機能を呼び出すには、「
@EXTENSION-NAME
」と入力し、拡張機能名内のスペースを-
に置き換えてから、Enter
を押します。 -
拡張機能を初めて使用する場合は、認証を求められます。 画面の手順に従って拡張機能を認証します。
-
チャット ウィンドウで拡張機能に質問します。 たとえば、
What is the software development lifecycle?
です。