Configuring your GitHub App for your Copilot extension

Learn how to configure your GitHub App so that it is associated with your Copilot Extension.

Tool navigation

この記事の内容

Once you have configured your server and created your GitHub App, you need to configure your GitHub App for use with your Copilot extension.

Prerequisites

Configuring your 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. To the right of the GitHub App you want to configure for your Copilot Extension, click Edit.

  5. In the "Identifying and authorizing users" section, under "Callback URL", enter your callback endpoint URL, then click Save changes.

    メモ

    Your server's hostname is the forwarding endpoint that you copied from your terminal when you configured your server. See Configuring your server to host your Copilot extension.

    If you are using an ephemeral domain in ngrok, you will need to update this URL every time you restart your ngrok server.

  6. In the left sidebar, click Permissions & events.

  7. To expand the "Account permissions" section, click anywhere in the section.

  8. [GitHub Copilot Chat] の行で、[Access:] ドロップダウン メニューを選択し、[Read-only] をクリックします。

  9. コンテキストの受け渡しを有効にするには、[Copilot Editor Context] 行で、[Access:] ドロップダウン メニューを選び、[Read-only] をクリックします。 コンテキストの受け渡しの詳細については、「Context passing for your agent」を参照してください。

  10. [変更を保存] をクリックします。

  11. In the left sidebar, click Copilot.

  12. Read the GitHub Marketplace Developer Agreement and the GitHub Pre-release License Terms, then accept the terms for creating a Copilot Extension.

  13. In the "App type" section, select the dropdown menu, then click Agent.

  14. Under "URL," enter your server's hostname (aka forwarding endpoint) that you copied from your terminal.

    メモ

    If you are using an ephemeral domain in ngrok, you will need to update this URL every time you restart your ngrok server.

  15. Under "Inference description", type a brief description of your agent, then click Save. This will be the description users see when they hover over your extension's slug in the chat window.

  16. Your pre-authorization URL is a link on your website that starts the authorization process for your extension. Users will be redirected to this URL when they decide to authorize your extension. If you are using a pre-authorization URL, under "Pre-authorization URL," enter the URL, then click Save.

  17. In your GitHub App settings, in the left sidebar, click Install App, then, next to the account you want to install your app on, click Install.

  18. GitHub の任意のページの右上で、検索バーの横にある GitHub Copilot アイコンをクリックします。

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

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

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

  20. Invoke your extension by typing @EXTENSION-NAME, replacing any spaces in the extension name with -, then press Enter.

  21. If this is your first time using the extension, you will be prompted to authenticate. Follow the steps on screen to authenticate your extension.

  22. Ask your extension a question in the chat window. For example, What is the software development lifecycle?.

  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. To the right of the GitHub App you want to configure for your Copilot Extension, click Edit.

  5. In the "Identifying and authorizing users" section, under "Callback URL", enter your callback endpoint URL, then click Save changes.

    メモ

    Your server's hostname is the forwarding endpoint that you copied from your terminal when you configured your server. See Configuring your server to host your Copilot extension.

    If you are using an ephemeral domain in ngrok, you will need to update this URL every time you restart your ngrok server.

  6. In the left sidebar, click Permissions & events.

  7. To expand the "Account permissions" section, click anywhere in the section.

  8. [GitHub Copilot Chat] の行で、[Access:] ドロップダウン メニューを選択し、[Read-only] をクリックします。

  9. コンテキストの受け渡しを有効にするには、[Copilot Editor Context] 行で、[Access:] ドロップダウン メニューを選び、[Read-only] をクリックします。 コンテキストの受け渡しの詳細については、「Context passing for your agent」を参照してください。

  10. [変更を保存] をクリックします。

  11. In the left sidebar, click Copilot.

  12. Read the GitHub Marketplace Developer Agreement and the GitHub Pre-release License Terms, then accept the terms for creating a Copilot Extension.

  13. In the "App type" section, select the dropdown menu, then click Skillset.

  14. Your pre-authorization URL is a link on your website that starts the authorization process for your extension. Users will be redirected to this URL when they decide to authorize your extension. If you are using a pre-authorization URL, under "Pre-authorization URL," enter the URL, then click Save.

  15. 追加するスキルごとに (最大 5):

    1. [Add new skill] をクリックします。
    2. スキルの明確な [Name] を入力します (例: "Generate Lorem Ipsum Data")。
    3. Copilot がこのスキルを使うべきときを理解するのに役立つ、詳細な [Inference description] を書きます。
    4. POST 要求を受け取る [API endpoint URL] を追加します。
    5. [Parameter] フィールドに、予想される要求形式を定義する JSON スキーマを追加します。
    6. [Add Definition] をクリックしてスキルを保存します。

  16. [Save] をクリックしてスキルセットを保存します。

  17. In your GitHub App settings, in the left sidebar, click Install App, then, next to the account you want to install your app on, click Install.

  18. GitHub の任意のページの右上で、検索バーの横にある GitHub Copilot アイコンをクリックします。

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

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

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

  20. Invoke your extension by typing @EXTENSION-NAME, replacing any spaces in the extension name with -, then press Enter.

  21. If this is your first time using the extension, you will be prompted to authenticate. Follow the steps on screen to authenticate your extension.

  22. Ask your extension a question in the chat window. For example, What is the software development lifecycle?.