Creación de conjuntos de aptitudes de Copilot

Introducción

Github Copilot skillsets son una manera simplificada de ampliar la funcionalidad de GitHub Copilot mediante la definición de puntos de conexión de API a los que Copilot puede llamar. Al crear un conjunto de aptitudes, Copilot controla todas las interacciones de IA mientras los puntos de conexión proporcionan los datos o la funcionalidad. Esta guía te lleva por la configuración e implementación de un conjunto de aptitudes dentro de GitHub App.

Requisitos previos

Antes de comenzar, asegúrese de que dispone de lo siguiente:

1. Una GitHub App configurada: necesitarás una GitHub App para que actúe de contenedor del conjunto de aptitudes. Si aún no has configurado una, 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.
2. Puntos de conexión de API: necesitas un punto de conexión por cada aptitud. Cada punto de conexión debe:
   • Aceptar solicitudes POST con el tipo MIME application/json.
   • Ser capaz de verificar la firma de las solicitudes de GitHub para autenticar su origen y evitar el acceso no autorizado.
   • Ser accesible públicamente a través de HTTPS.

Para más información sobre la verificación de la firma, consulta Comprobación de que las cargas proceden de Github.

Requisitos de configuración

Cada conjunto de aptitudes se define dentro de una GitHub App. Una sola GitHub App puede contener hasta cinco capacidades. Cada aptitud individual necesita:

• Un nombre: claro y descriptivo (por ejemplo, "Obtener propuestas").
• Una descripción de la inferencia: una explicación detallada de lo que hace la aptitud y cuándo usarla (por ejemplo, "Busca propuestas externas que coincidan con criterios específicos, como el estado y las etiquetas).
• Un punto de conexión de API: un punto de conexión POST que acepte solicitudes JSON.
• Un esquema JSON: la estructura de los datos que espera el punto de conexión.

Ejemplo de esquema JSON

En este ejemplo se muestra una aptitud que requiere dos parámetros: una cadena de estado y una cadena de etiqueta. Si no se proporciona ningún parámetro, se debe pasar un objeto vacío con el tipo "object" como cuerpo de la solicitud.

{
 "type": "object",
 "properties": {
   "status": {
     "type": "string",
     "description": "filter issues by status (open, closed)",
     "enum": ["open", "closed"]
   },
   "label": {
     "type": "string",
     "description": "filter issues by label"
   }
 }
}

Este formato permite a los usuarios realizar solicitudes de lenguaje natural como find open security issues y Copilot estructurará la llamada API adecuada.

Uso del conjunto de aptitudes

Para usar el conjunto de aptitudes:

1. Escribe @ seguido del nombre de la extensión.

2. Escribe la indicación en lenguaje natural.

   Por ejemplo:

   • @skillset-example generate a lorem ipsum
   • @skillset-example give me sample data with 100 words

Copilot interpreta la solicitud y llama a la aptitud adecuada con los parámetros correctos. No es necesario especificar qué aptitud se usará,Copilot lo determina a partir de la solicitud de lenguaje natural y de las descripciones de inferencia proporcionadas.

Configuración de un conjunto de aptitudes

1. En la esquina superior derecha de cualquier página en GitHub, haga clic en su fotografía de perfil.
2. Navega a la configuración de tu cuenta.
   • Para una aplicación propiedad de una cuenta personal, haga clic en Configuración.
   • Para una aplicación propiedad de una organización:
     1. Haga clic en Sus organizaciones.
     2. A la derecha de la organización, haga clic en Configuración.
3. En la barra lateral izquierda, haz clic en Configuración del desarrollador.
4. En la barra lateral de la izquierda, haga clic en GitHub Apps .
5. En la lista de GitHub Apps, haz clic en la GitHub App que deseas configurar para el conjunto de aptitudes.
6. En el menú de navegación de la izquierda, selecciona Copilot.
7. En App Type, selecciona Skillset en el menú desplegable.
8. Opcionalmente, en el campo Pre-authorization URL, escribe la dirección URL donde se redirigirá a los usuarios para que comiencen el proceso de autenticación. Este paso es necesario si la API requiere que los usuarios conecten su cuenta de GitHub para acceder a determinadas características o datos.
9. Para cada aptitud que quieras agregar (máximo 5):
   1. Haz clic en Add new skill.
   2. Escribe un nombre claro para la aptitud (por ejemplo, "Generar datos de Lorem Ipsum").
   3. Escribe una descripción de la inferencia que sea detallada para ayudar a Copilot a comprender cuándo usar esta aptitud.
   4. Agrega la dirección URL del punto de conexión de API que recibirá las solicitudes POST.
   5. En el campo Parameter, agrega el esquema JSON que define el formato de solicitud esperado.
   6. Haz clic en Add Definition para guardar la aptitud.
10. Haz clic en Save para guardar la configuración.