¡Hola developer 👋🏻! Este repositorio contiene el ejemplo que te mostré durante el vídeo sobre "Cómo crear una GitHub Copilot Extensions usando skillsets" de mi canal de YouTube.

Cómo ejecutar el ejemplo

Este código está desarrollado en Node.js por lo que necesitas o bien tenerlo instalado en tu máquina local o bien puedes usar Dev Containers, o GitHub Codespaces. Si quieres saber más de estas dos tecnologías puedes ver los siguientes vídeos de mi canal de YouTube:

Una vez que elijas el entorno donde quieres ejecutarlo, necesitas instalar las dependencias. Para ello, ejecuta el siguiente comando en la terminal:

npm install

y una vez instaladas las dependencias, puedes ejecutar el servidor con el siguiente comando:

 npm start

Por otro lado, necesitas utilizar algo para que GitHub Copilot Extension pueda acceder a tu servidor local. Para ello, puedes utilizar ngrok con una cuenta gratuita. La configuración de Dev Containers ya tiene todo preparado para que puedas utilizarlo sin tener que instalar nada más 😇. Para arrancar ngrok necesitas ejecutar este comando:

ngrok http 3000

Note

La primera vez te dirá que te registres o que configures tu token de autenticaciión. En el terminal te dará todos los pasos a seguir. Una vez que lo tengas configurado, ejecuta de nuevo el comando y te dará una URL pública que podrás utilizar para configurar tu GitHub Copilot Extension.

Crear una extensión de GitHub Copilot

Hace ya tiempo te mostré cómo crear una extensión de GitHub Copilot en este otro vídeo:

En ese momento solo había una forma de hacerlo que era crear el agente en su totalidad, debes preocuparte del metaprompting, del RAG, etcétera. Sin embargo, ahora podemos utilizar los skillsets para extender las capacidades de GitHub Copilot Extension de una forma más sencilla. Simplemente podemos utilizar el agente que ya conocemos y pasarle una serie de endpoints con una descripción de los mismos para que pueda usarlos según le convenga. Este tipo se llama Skillset y para crearlo debes ir al apartado de Settings> Developer Settings > GitHub Apps> New GitHub App y llevar a cabo la siguiente configuración:

• GitHub App name: El nombre de tu extensión. Es el que usarás cuando quieras interactuar con ella.
• Homepage URL: La URL de tu aplicación. En mi ejemplo https://www.returngis.net
• Callback URL: La URL de tu aplicación. En mi ejemplo https:/github.com
• Puedes ponerle un logo si quieres, pero es opcional.
• Deshabilita la opción Webhook
• Permissions: A nivel Account Permissions hay que usar Copilot Chat > Read-only

Una vez que guardes los cambios solo queda un paso más. En la sección que se llama Copilot en esta ocasión hay que elegir en el combo llamado App Type la que dice Skillset. Una vez que la selecciones podrás ver un apartado llamado Skill definitionsdonde podremos dar de alta los diferentes endpoints que queremos que GitHub Copilot tenga en cuenta cuando interactuemos con esta extensión.

Endpoints de ejemplo

Para este ejemplo he creado tres endpoints que forman parte de este repositorio.

• /dragonball: Este endpoint devuelve información sobre los personajes de Dragon Ball.
• /starwars: Este endpoint devuelve información sobre los personajes de Star Wars.
• /ado: Este endpoint se conecta a Azure DevOps y es capaz de devolver los work items de un proyecto que se le pida.

En cada uno de ellos puedes encontrar como comentario cuál sería el valor para el campo Inference descriptiony el JSON Schema a poner en el campo Parameters. El nombe puede ser el que tú elijas y la URL será la que nos de Ngrok + el path de cada uno de los endpoints.

Una vez que ya tengas configurado todo esto, puedes pedirle cosas como:

• @returngis-skillset generame un array con 10 personajes de Dragon Ball

• @returngis-skillset ahora mezclamelo con 10 personajes de Star Wars

• @returngis-skillset damelo en formato JSON con el nombre, el genero y la procedencia

Esto está muy bien para comprender cómo funciona el skillset y cómo podemos utilizarlo para generar datos de ejemplo para nuestras aplicaciones.

Si queremos llevarlo a un ejemplo más real, podemos utilizar el endpoint de Azure DevOps para recuperar los work items de un proyecto:

• @returngis-skillset dame los work items del proyecto Tour-Of-Heroes
• @returngis-skillset ahora dame los work items de tipo To Do
• @returngis-skillset cuáles están asignados a mi
• @returngis-skillset cuáles están asociados a Jon
• @returngis-skillset y a Jaime