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

Introducción

          Agentes personalizados le permiten adaptar la experiencia de Copilot a tareas específicas.

Cuando se le solicita a Copilot que realice una tarea, puede optar por usar uno de tus agentes personalizados, si Copilot determina que la pericia 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. Así, especialmente para tareas más grandes, partes del trabajo se pueden delegar en 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.

Crear un agente personalizado

Cada agente personalizado se define mediante un archivo Markdown con extensiones .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. Elija entre las opciones para crear el agente personalizado en el repositorio o en su directorio personal.

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

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

   Nota:

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

4. Elija si quiere que Copilot, cree el archivo agente personalizado o créelo 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 introduce y la usará para escribir un perfil de agente para usted.

   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.
   

   Una vez Copilot finalizada la generación del perfil inicial del agente, se muestran 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 elemento agente personalizado mediante programación, se recomienda elegir un nombre que consta 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 agente personalizado a las que debe tener acceso.

   De forma predeterminada, agentes personalizados tiene 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 puede 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.

•         **Instrucción explícita**
  

  Indica 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 desea usar.
  

•         **Programáticamente**
  

  Especifique el 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 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/reference/copilot-cli-reference/cli-command-reference#custom-agents-reference)
  

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