Este artículo está diseñado para ayudarte a crear una Extensión de GitHub Copilot completamente nueva. Si lo que quieres es aprender cómo crear y probar de forma rápida una Extensión de Copilot de demostración creada por GitHub, consulta Inicio rápido para extensiones de GitHub Copilot usando agentes.
Los conjuntos de aptitudes y los agentes son las dos maneras de ampliar las capacidades de Copilot y el contexto mediante la . Permiten integrar servicios externos y API en , pero cada uno atiende diferentes casos de uso y ofrece distintos niveles de control y complejidad:
- Los conjuntos de aptitudes son ligeros y funcionales y están diseñados para desarrolladores que necesitan que Copilot lleve a cabo tareas específicas (por ejemplo, recuperación de datos u operaciones simples) con una configuración mínima. Controlan el enrutamiento, la creación de indicaciones, la evaluación de funciones y la generación de respuestas automáticamente, lo que hace que sean perfectos para integraciones rápidas y sencillas. Para obtener más información sobre los conjuntos de aptitudes, consulta About skillsets for Copilot Extensions.
- Los agentes son para integraciones complejas que necesitan un control total sobre cómo se procesan las solicitudes y se generan respuestas. Permiten implementar lógica personalizada, integrarla con otros modelos LLM o la API de Copilot, administrar el contexto de conversación y controlar todos los aspectos de la interacción del usuario. Aunque los agentes requieren más tareas de ingeniería y mantenimiento, ofrecen máxima flexibilidad para flujos de trabajo sofisticados. Para más información sobre los agentes, consulta About agents for Copilot Extensions.
1. Más información sobre Agentes de Copilot
Agentes de Copilot contienen el código personalizado de su Extensión de Copilot, y cuentan con la integración de GitHub App para formar Extensión de Copilot en sí. Para más información, consulta About agents for Copilot Extensions.
Para compilar correctamente un Agente de Copilot, debe comprender cómo se comunica el agente con:
- La plataforma Copilot mediante eventos enviados por el servidor. Consulta Configuración del agente de Copilot para comunicarse con la plataforma de Copilot.
- La API GitHub. Consulta Configuración del agente de Copilot para comunicarse con GitHub.
2. Revise el ejemplo Agentes de Copilot y el SDK de Extensiones de Copilot
Para ver los conceptos anteriores en la práctica y obtener información sobre las implementaciones del agente, revise los siguientes agentes de ejemplo y el kit de desarrollo de software (SDK), todos los cuales están disponibles en la organización copilot-extensions:
- Blackbeard (mejor punto de partida): un agente simple que responde a solicitudes como un pirata mediante la API y los avisos especiales del sistema del modelo de lenguaje grande Copilot.
- GitHub Models: un agente más complejo que le permite preguntar e interactuar con varios LLM enumerados en GitHub Marketplace a través de Copilot Chat. El agente de GitHub Models usa la llamada a funciones.
- Llamada a funciones: un agente de ejemplo escrito en Go que muestra la llamada de función y los cuadros de diálogo de confirmación.
- Extensión de RAG: un agente de ejemplo escrito en Go que muestra una implementación sencilla de la generación aumentada de recuperación.
- SDK de versión preliminar: un SDK que simplifica el desarrollo de Extensiones de Copilot mediante el control automático de la comprobación de solicitudes, el análisis de carga y el formato de respuesta. Este SDK permite a los generadores de extensiones centrarse más en la creación de funciones básicas y menos en código reutilizable.
3. Creación de un Agente de Copilot
Con el material de referencia de los pasos anteriores, planee y compile Agente de Copilot. Puede elegir desplegar cualquiera de las siguientes opciones:
- Para evitar compilar y administrar su propia implementación de LLM, el agente puede llamar a la implementación de LLM de Copilot. Consulta Uso de LLM de Copilot para el agente.
- Para interpretar rápidamente la entrada del usuario y elegir entre una variedad de funciones predefinidas que se van a ejecutar, puede desplegar llamadas a funciones en el agente. Para más información, consulte Cómo utilizar la llamada a funciones con Azure OpenAI Service en la documentación de Azure OpenAI y Llamada a funciones en la documentación de OpenAI.
4. Despliegue Agente de Copilot
Para que Agente de Copilot sean accesible para la plataforma Copilot y GitHub, debe implementarlos en un servidor al que pueda acceder la solicitud HTTP. Consulta Configuración del servidor para hospedar la extensión de Copilot.
5. Cree GitHub App e integre la aplicación con Agente de Copilot
Para crear un Extensión de Copilot, debe crear y configurar un GitHub App, e integrar la aplicación con Agente de Copilot. Consulta Creación de una aplicación de GitHub para la extensión de Copilot y Configuración de la aplicación de GitHub para el agente de Copilot.
6. Elija la disponibilidad de Extensión de Copilot
Elija uno de los dos niveles de visibilidad para Extensión de Copilot:
- Público: cualquier cuenta de usuario u organización con el vínculo de la página de instalación de la extensión puede instalarla.
- Privado: solo la cuenta de usuario u organización que creó la extensión puede instalarla.
Si Extensión de Copilot es pública, puedes elegir publicarla en GitHub Marketplace.
Para obtener información sobre cómo cambiar la visibilidad de Extensión de Copilot y publicarlo en GitHub Marketplace, consulta Administración de la disponibilidad de la extensión de Copilot.
Pasos siguientes
Para obtener información sobre cómo usar Extensión de Copilot, consulta Uso de extensiones para integrar herramientas externas con Copilot Chat.
1. Más información sobre Conjuntos de aptitudes de GitHub Copilot
Conjuntos de aptitudes de GitHub Copilot contienen el código personalizado de su Extensión de Copilot, y cuentan con la integración de GitHub App para formar Extensión de Copilot en sí.
A diferencia de los Agentes de Copilot, los Conjuntos de aptitudes de Copilot controlan la lógica subyacente de la creación de indicaciones, la evaluación de funciones y la generación de respuestas, lo que los convierte en la opción ideal para los desarrolladores que buscan integraciones rápidas y eficientes con un esfuerzo mínimo. Para más información, consulta About skillsets for Copilot Extensions.
2. Compilación de un Conjunto de aptitudes de Copilot
Para explorar un ejemplo de una implementación de conjunto de aptitudes, consulta el repositorio skillset-example en la organización copilot-extensions.
Para crear un conjunto de aptitudes, consulta Creación de conjuntos de aptitudes de Copilot.
3. Despliegue del Conjunto de aptitudes de Copilot
Para que Conjunto de aptitudes de Copilot sean accesible para la plataforma Copilot y GitHub, debe implementarlos en un servidor al que pueda acceder la solicitud HTTP. Consulta Configuración del servidor para hospedar la extensión de Copilot.
4. Cree GitHub App e integre la aplicación con Conjunto de aptitudes de Copilot
Para crear un Extensión de Copilot, debe crear y configurar un GitHub App, e integrar la aplicación con Conjunto de aptitudes de Copilot. Consulta Creación de una aplicación de GitHub para la extensión de Copilot y Configuración de la aplicación de GitHub para el agente de Copilot.
5. Elija la disponibilidad de Conjunto de aptitudes de Copilot
Elija uno de los dos niveles de visibilidad para Extensión de Copilot:
- Público: cualquier cuenta de usuario u organización con el vínculo de la página de instalación de la extensión puede instalarla.
- Privado: solo la cuenta de usuario u organización que creó la extensión puede instalarla.
Si Extensión de Copilot es pública, puedes elegir publicarla en GitHub Marketplace.
Para obtener información sobre cómo cambiar la visibilidad de Extensión de Copilot y publicarlo en GitHub Marketplace, consulta Administración de la disponibilidad de la extensión de Copilot.
Pasos siguientes
Para obtener información sobre cómo usar Extensión de Copilot, consulta Uso de extensiones para integrar herramientas externas con Copilot Chat.