Invocación de agentes personalizados

Uso de agentes personalizados

Un agente personalizado es una versión especializada de Copilot. Agentes personalizados ayudan a Copilot a gestionar flujos de trabajo únicos, convenciones de codificación concretas y casos de uso especializados.

CLI de Copilot incluye un grupo predeterminado de agentes personalizados para tareas comunes:

Agente	Descripción
Explorar	Realiza un análisis rápido de código base, lo que le permite formular preguntas sobre el código sin agregar al contexto principal.
Tarea	Ejecuta comandos como pruebas y compilaciones, lo que proporciona resúmenes breves sobre éxito y salida completa en caso de error.
Uso general	Controla tareas complejas y de varios pasos que requieren el conjunto de herramientas completo y el razonamiento de alta calidad, que se ejecutan en un contexto independiente para mantener la conversación principal claramente centrada.
Revisión de código	Revisa los cambios con un enfoque en identificar solo problemas genuinos, minimizando el ruido.

El modelo de inteligencia artificial que utiliza la CLI puede elegir delegar una tarea en un proceso de subagente subsidiario, que opera usando un agente personalizado con conocimientos específicos, si considera que esto haría que el trabajo se realice de manera más eficaz. El modelo puede igualmente optar por gestionar el trabajo directamente en el agente principal.

Puede definir sus propios agentes personalizados con archivos Markdown, denominados perfiles de agente, que especifican qué experiencia debe tener el agente, qué herramientas puede usar y las instrucciones específicas sobre cómo debe responder.

Puede definir agentes personalizados en el nivel de usuario, organización/empresa o repositorio:

Tipo	Ubicación	Ámbito
Nivel de usuario agente personalizado	directorio local ~/.copilot/agents	Todos los proyectos
Nivel de repositorio agente personalizado

          `.github/agents` directorio en los repositorios locales y remotos | Proyecto actual |

| Nivel de organización y empresa agente personalizado | Directorio /agents en el repositorio .github-private de una organización o empresa | Todos los proyectos de su organización y cuenta empresarial |

En el caso de conflictos de nomenclatura, un agente de nivel de sistema invalida un agente de nivel de repositorio y el agente de nivel de repositorio invalidaría un agente de nivel de organización.

Agentes personalizados se pueden usar de tres maneras:

• Usando el comando de barra en la interfaz interactiva de la CLI para seleccionar de la lista de agentes personalizados disponibles:

  /agent
  

• Llamando a agente personalizado directamente en una solicitud:

  Use the refactoring agent to refactor this code block
  

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

• Especificando el agente personalizado que desea utilizar con la opción de línea de comandos. Por ejemplo:

  copilot --agent=refactor-agent --prompt "Refactor this code block"
  

Para más información, consulta Creación de agentes personalizados para Agente de programación Copilot.

Usar capacidades

Puede crear aptitudes para mejorar la capacidad de Copilot para realizar tareas especializadas con instrucciones, scripts y recursos.

Para más información, consulta Creación de aptitudes de agente para CLI de GitHub Copilot.

Agregar un servidor MCP

CLI de Copilot viene con el servidor MCP de GitHub ya configurado. Este servidor MCP te permite interactuar con recursos en GitHub.com, por ejemplo, lo que te permite combinar solicitudes de incorporación de cambios de la CLI.

Para ampliar la funcionalidad disponible en CLI de Copilot, puedes agregar más servidores MCP:

1. Usa el siguiente comando de barra diagonal:

   /mcp add
   

2. Rellena los detalles del servidor MCP que deseas agregar, con la tecla Tab para moverte entre los campos.

3. Pulse Ctrl+S para guardar los detalles.

Los detalles de los servidores MCP configurados se almacenan en el archivo mcp-config.json, que se encuentra, de forma predeterminada, en el directorio ~/.copilot. Esta ubicación se puede cambiar estableciendo la variable de entorno COPILOT_HOME. Para obtener información sobre la estructura JSON de una definición de servidor, consulta Extensión del agente de codificación de GitHub Copilot con el protocolo de contexto de modelo (MCP).

Para obtener información más detallada sobre cómo agregar y administrar servidores MCP en CLI de Copilot, vea Adición de servidores MCP para la CLI de GitHub Copilot.

Pasos siguientes

Para obtener información sobre cómo guiar y refinar el comportamiento del agente durante la ejecución de tareas para seguir el trabajo, consulte Direccionamiento de agentes en CLI de GitHub Copilot.