1
0
mirror of synced 2025-12-21 10:57:10 -05:00
Files
docs/content/copilot/building-copilot-extensions/creating-a-copilot-extension/creating-a-github-app-for-your-copilot-extension.md
Sam Browning 051d49a9d5 [Megabranch, DO NOT MERGE] Create Copilot Extensions builder docs, update user-focused Extensions docs (#51954)
Co-authored-by: Jules Porter <jules-p@users.noreply.github.com>
Co-authored-by: Jules <19994093+jules-p@users.noreply.github.com>
Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com>
Co-authored-by: Jason Etcovitch <jasonetco@github.com>
Co-authored-by: Jess Hosman <1183847+jhosman@users.noreply.github.com>
Co-authored-by: Dimitrios Philliou <d1m1tr10s@github.com>
Co-authored-by: Sophie <29382425+sophietheking@users.noreply.github.com>
Co-authored-by: hubwriter <hubwriter@github.com>
2024-09-09 10:02:13 -07:00

3.4 KiB

title, intro, versions, topics, shortTitle, type
title intro versions topics shortTitle type
Creating a GitHub App for your Copilot Extension Learn how to create a {% data variables.product.prodname_github_app %} for your {% data variables.product.prodname_copilot_extension_short %}.
feature
copilot-extensions
Copilot
Create GitHub App how_to

{% data reusables.copilot.copilot-extensions.beta-note %}

A {% data variables.product.prodname_copilot_extension_short %} is a {% data variables.product.prodname_github_app %} that is associated with a {% data variables.product.prodname_copilot_agent_short %}. The {% data variables.product.prodname_github_app %} you associate your {% data variables.product.prodname_copilot_agent_short %} with is used to authenticate the {% data variables.product.prodname_copilot_agent_short %} with {% data variables.product.prodname_dotcom %} and to authorize the {% data variables.product.prodname_copilot_agent_short %} to access the {% data variables.product.prodname_copilot_chat_short %} API. Each {% data variables.product.prodname_copilot_agent_short %} must be associated with a unique {% data variables.product.prodname_github_app %}.

Prerequisites

  • You have created a {% data variables.product.prodname_copilot_agent_short %}. For more information, see "AUTOTITLE." Alternatively, you can use a demo agent. For more information, see "AUTOTITLE."
  • You have configured your server to deploy your {% data variables.product.prodname_copilot_agent_short %}, and you have your hostname (aka forwarding endpoint). For more information, see "AUTOTITLE."

Creating a {% data variables.product.prodname_github_app %}

{% data reusables.apps.settings-step %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %}

  1. Click New {% data variables.product.prodname_github_app %}.

  2. Under "{% data variables.product.prodname_github_app %} name," enter a name for your app.

    [!NOTE] The name cannot be longer than 34 characters.

    Your app's name will be shown in the user interface when your app takes an action. Uppercase letters will be converted to lowercase, with spaces replaced by -, and accents ignored. For example, My APp Näme would display as my-app-name.

    The name must be unique across {% data variables.product.company_short %}. You cannot use the same name as an existing {% data variables.product.company_short %} account, unless it is your own user or organization name.

  3. Optionally, under "Description," type a description of your app. Users and organizations will see this description when they install your app.

  4. Under "Homepage URL," enter a URL for your app. You can use:

    • Your app's website URL.
    • The URL of the organization or user that owns the app.
    • The URL of the repository where your app's code is stored, if it is a public repository.
  5. Under "Webhook," deselect Active.

  6. Click Create {% data variables.product.prodname_github_app %}.

Next steps