Creación y uso de agentes personalizados para CLI de GitHub Copilot

Introducción

Agentes personalizados le permiten personalizar la experiencia de Copilot para tareas específicas.

Cuando solicite a Copilot que lleve a cabo una tarea, puede optar por usar uno de sus agentes personalizados, si Copilot determina que la experiencia del agente es adecuada para la tarea.

El trabajo realizado por un agente personalizado se lleva a cabo mediante un subagente, que es un agente temporal que se activa para completar la tarea. El subagent tiene su propia ventana de contexto, que se puede rellenar mediante información que no es relevante para el agente principal. De esta manera, especialmente para tareas más grandes, partes del trabajo se pueden delegar a agentes personalizados, sin sobrecargar la ventana de contexto del agente principal. Después, el agente principal puede centrarse en la planificación y coordinación de nivel superior.

Para más información, consulta Acerca de los agentes personalizados.

Creación de un agente personalizado

Cada agente personalizado se define mediante un archivo Markdown con una extensión .agent.md. Puede crear estos archivos usted mismo o agregarlos desde la CLI, como se describe en los pasos siguientes.

1. En modo interactivo, escriba /agent.

2. Seleccione Crear nuevo agente en la lista de opciones.

3. Seleccione entre las opciones para crear el agente personalizado en el repositorio o en su directorio personal.

   •      **Project** (`.github/agents/`)
     

   •      **Usuario** (`~/.config/copilot/agents/`)
     

   Nota:

   Si tiene agentes personalizados con el mismo nombre en ambas ubicaciones, se utilizará el de su directorio personal, en lugar de utilizar el del repositorio.

4. Elija si quiere obtener Copilot para crear el archivo agente personalizado o crearlo usted mismo.

          **Opción 1: Usar Copilot**
   

   Escriba los detalles del agente que desea crear. Describa la experiencia del agente y cuándo se debe usar el agente. Copilot tomará la descripción que escriba y la empleará para crear un perfil de agente.

   Por ejemplo, podría ingresar:

   I am a security expert. I check code files thoroughly for potential security issues. Use me whenever a security review/check/audit is requested for one or more code files, or when the word "seccheck" is used in a prompt in reference to code files.
   
   I will identify potential problems, such as code that:
   
   - Exposes secrets or credentials
   - Allows cross-site scripting
   - Allows SQL injection
   - Contains vulnerable dependencies
   - Allows authentication to be bypassed
   
   If any problems are identified, create a single GitHub issue in this repository on GitHub.com with details of problems, giving full details of each issue, including, but not limited to, risk level and recommended fix.
   

   Después de que Copilot ha terminado de generar el perfil inicial del agente, muestra las siguientes opciones:

   • Continuar
   • Revisión del contenido
   • Volver a intentarlo
   • Salir

   Si decide revisar el contenido, el archivo del agente se abre en el editor predeterminado. Puede revisar y realizar cambios, si es necesario, antes de continuar con el proceso de creación del agente en la CLI.

   Para completar el proceso de creación, elija Continuar.

          **Opción 2: Creación manual del perfil del agente**
   

   Al elegir crear el archivo del agente usted mismo, se le guiará a través de una serie de avisos para rellenar la información necesaria para crear el perfil del agente.

   1. Escriba un nombre para el agente. El nombre que escriba es el nombre que se muestra al enumerar los agentes disponibles. Una versión de esto se usará como nombre del archivo del agente; por ejemplo, si escribe "Experto en seguridad", el archivo del agente se denominará security-expert.agent.md.

      Sugerencia

      Para facilitar el uso de un agente personalizado mediante programación, se recomienda elegir un nombre que conste solo de letras minúsculas y guiones.

   2. Escriba una descripción que indique qué experiencia tiene este agente y cuándo se debe usar.

   3. Escriba instrucciones sobre cómo debe comportarse el agente, incluidas las instrucciones específicas, las acciones que debe realizar o las restricciones que debe seguir.

5. Elija las herramientas a las que su agente personalizado debería tener acceso.

   De forma predeterminada, agentes personalizados tienen acceso a todas las herramientas. Si restringe el acceso de un agente, se agrega una tools especificación al archivo del agente.

6. Reinicie la CLI para cargar el nuevo agente personalizado.

Uso de un agente personalizado

Agentes personalizados se pueden usar de las siguientes maneras:

•         **Comando Slash**
  

  Escriba /agent en modo interactivo y elija de la lista de agentes personalizados disponibles. A continuación, escriba un mensaje que se pasará al agente seleccionado.

  Nota:

  Los agentes predeterminados de la CLI no se incluyen en esta lista. Para obtener más información sobre los agentes predeterminados, consulte Uso de la CLI de GitHub Copilot.

•         **Instrucción explícita**
  

  Dígale a Copilot que use un agente específico. Por ejemplo:

  Use the security-auditor agent on all files in the /src/app directory
  

•         **Por inferencia**
  

  Utilice una solicitud que desencadene el uso de un agente particular basándose en la descripción del archivo del agente. Por ejemplo:

  Check all TypeScript files in or under the src directory for potential security problems
  

  o (donde "seccheck" se define como una palabra de desencadenador en el perfil del agente):

  seccheck /src/app/validator.go
  

  Copilot deducirá automáticamente el agente que quieres usar.

•         **Programáticamente**
  

  Especifique agente personalizado que desea usar con la opción de línea de comandos. Por ejemplo:

  copilot --agent security-auditor --prompt "Check /src/app/validator.go"
  

  Donde security-auditor es el nombre de archivo del perfil agente personalizado sin la extensión .agent.md. Normalmente, pero no necesariamente, esto es lo mismo que el name valor del perfil del agente.

Lectura adicional

•         [AUTOTITLE](/copilot/concepts/agents/copilot-cli/comparing-cli-features)
  

•         [AUTOTITLE](/copilot/reference/custom-agents-configuration)
  

•         [AUTOTITLE](/copilot/tutorials/customization-library/custom-agents): una colección seleccionada de ejemplos