Note
GitHub Copilot Extensions 为 公共预览版,可能随时更改。
1. 了解 Copilot agents
Copilot agents 包含 Copilot Extension 的自定义代码,并与 GitHub App 集成,以形成 Copilot Extension 本身。 有关详细信息,请参阅“关于 Copilot 代理”。
要成功生成 Copilot agent,需要了解代理与以下各项的通信方式:
- 使用服务器发送事件的 Copilot 平台。 请参阅“配置 Copilot 代理以与 Copilot 平台通信”。
- GitHub API。 请参阅“配置 Copilot 代理以与 GitHub 通信”。
2. 查看示例 Copilot agents 和 Copilot Extensions SDK
要查看先前概念的实践运用并了解代理的实现,请查看以下示例代理和软件开发工具包 (SDK),所有这些概念均可在 copilot-extensions
组织中获得:
- Blackbeard(最佳起点):简单代理,使用 Copilot 的大型语言模型 (LLM) API 和特定系统提示,以海盗模式响应请求。
- GitHub Models:更复杂的代理,可让你通过 Copilot Chat 询问 GitHub Marketplace 中上架的各种 LLM 并与之交互。 GitHub Models 代理使用了函数调用。
- 函数调用:一个用 Go 编写的示例代理,演示了函数调用和确认对话框。
- RAG 扩展:用 Go 编写的示例代理,演示了检索增强生成的简单实现。
- 预览版 SDK:通过自动处理请求验证、有效负载分析和响应格式,简化了 Copilot Extensions 开发的 SDK。 此 SDK 允许扩展生成器更专注于创建核心功能,而不是样本代码。
3.生成 Copilot agent
使用前面步骤中的参考资料,规划和生成 Copilot agent。 可以选择实现以下任一选项:
- 为了避免生成和管理自己的 LLM 部署,代理可以调用 Copilot LLM 部署。 请参阅“将 Copilot 的 LLM 用于代理”。
- 要快速解释用户输入并从各种预定义函数中选择要执行的函数,可以在代理中实现函数调用。 要了解更多信息,请参阅 Azure OpenAI 文档中的如何将函数调用与 Azure OpenAI 服务结合使用和 OpenAI 文档中的函数调用。
4. 部署 Copilot agent
要让 Copilot agent 可以访问 Copilot 平台和 GitHub,需要将其部署到可通过 HTTP 请求访问的服务器。 请参阅“Configuring your server to host your Copilot extension”。
5. 创建 GitHub App,并将其与 Copilot agent 集成
要创建 Copilot Extension,需要创建和配置 GitHub App,然后将其与 Copilot agent 集成。 请参阅“为 Copilot 扩展创建 GitHub 应用”和“Configuring your GitHub App for your Copilot extension”。
6. 选择 Copilot Extension 的可用性
选择 Copilot Extension 的两个可见性级别之一:
- 公共****:拥有该扩展安装页面链接的任何用户或组织帐户都可以进行安装。
- 私有****:只有创建该扩展的用户或组织帐户才能进行安装。
如果要公开 Copilot Extension ,可以选择在 GitHub Marketplace 中上架。
要了解如何更改 Copilot Extension 的可见性并在 GitHub Marketplace 中上架,请参阅“管理 Copilot 扩展的可用性”。
后续步骤
要了解如何使用 Copilot Extension,请参阅“使用扩展将外部工具与 Copilot Chat 集成”。