为 Copilot 代理配置 GitHub 应用

配置服务器并创建 GitHub App 后，需要将 GitHub App 配置为与 Copilot 代理一起使用。

先决条件

• 已将服务器配置为部署 Copilot agent，并且已设置主机名（即转发端点）。 有关详细信息，请参阅“Configuring your server to host your Copilot agent”。
• 已为 Copilot 代理创建了 GitHub App。 有关详细信息，请参阅“为 Copilot 扩展创建 GitHub 应用”。

配置 GitHub App

1. 在 GitHub 上任意页的右上角，单击你的个人资料照片。

2. 导航到你的帐户设置。

   • 对于由个人帐户拥有的应用，请单击“设置”****。
   • 对于组织拥有的应用：
     1. 单击“你的组织”。
     2. 在组织的右侧，单击设置。
   • 对于由企业拥有的应用：
     1. 如果使用的是 Enterprise Managed Users，请单击你的企业，以直接转到企业帐户设置。
     2. 如果使用的是个人帐户，请单击你的企业，然后单击企业右侧的设置。

3. 导航到 GitHub App 设置。

   • 对于由个人帐户或组织拥有的应用：
     1. 在左侧边栏中，单击 开发人员设置，然后单击 GitHub Apps。
   • 对于由企业拥有的应用：
     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. 在“应用类型”部分中，选择下拉菜单，然后单击“代理”****。

12. 在“URL”下，输入从终端复制的服务器主机名（即转发端点）。

    Note

    如果在 ngrok 中使用临时域，则每次重新启动 ngrok 服务器时都需要更新此 URL。

13. 在“推理说明”下，键入代理的简要说明，然后单击“保存”****。 这是用户在聊天窗口中将鼠标悬停在代理的数据域上时看到的说明。

14. 预授权 URL 是网站上的一个链接，用于启动扩展的授权过程。 当用户决定授权扩展时，将被重定向到此 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?。