Acerca de agentes personalizados
Agentes personalizados son versiones especializadas del Copilot agente que puedes adaptar a tus flujos de trabajo, tus convenciones de codificación y casos de uso. Actúan como compañeros de equipo adaptados que siguen sus estándares, usan las herramientas adecuadas e implementan prácticas específicas del equipo. Estos agentes se definen una vez en lugar de proporcionar repetidamente las mismas instrucciones y contexto.
Tú defines agentes personalizados utilizando archivos Markdown llamados perfiles de agente. Estos archivos especifican mensajes, herramientas y servidores MCP. Esto le permite codificar las convenciones, marcos y resultados deseados directamente en Copilot.
perfil de agente define el comportamiento de agente personalizado. Al asignar el agente a una tarea o un problema, este crea una instancia de agente personalizado.
Además de lo agentes personalizados que defina usted mismo, Copilot incluye un conjunto de preconstruidos agentes personalizados. Consulte Agentes integrados.
Formato de Perfil del agente
Perfiles de agente son archivos Markdown con frontmatter de YAML. En su forma más sencilla, incluyen:
* Nombre (opcional): nombre para mostrar de agente personalizado. Si se omite, se utiliza el nombre de archivo del agente como su identificador y nombre para mostrar por defecto. * Descripción: explica el propósito y las funcionalidades del agente. * Solicitud: Instrucciones personalizadas que definen el comportamiento y la experiencia del agente. * Herramientas (opcional): herramientas específicas a las que puede acceder el agente. De forma predeterminada, los agentes pueden acceder a todas las herramientas disponibles, incluidas las herramientas integradas y las herramientas de servidor MCP.
Perfiles de agente también puede incluir configuraciones de servidor MCP mediante la `mcp-servers` propiedad .
Por ejemplo, perfil de agente
Este ejemplo es un elemento básico perfil de agente con el nombre, la descripción, y el indicador configurado.
---
name: readme-creator
description: Agent specializing in creating and improving README files
---
You are a documentation specialist focused on README files. Your scope is limited to README files or other related documentation files only - do not modify or analyze code files.
Focus on the following instructions:
- Create and update README.md files with clear project descriptions
- Structure README sections logically: overview, installation, usage, contributing
- Write scannable content with proper headings and formatting
- Add appropriate badges, links, and navigation elements
- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository
- Make links descriptive and add alt text to images
Dónde puede configurar agentes personalizados
Puede definir perfiles de agente en distintos niveles:
-
**Nivel de repositorio**: cree `.github/agents/CUSTOM-AGENT-NAME.md` en el repositorio para agentes específicos del proyecto. -
**Organización o nivel de empresa**: cree `/agents/CUSTOM-AGENT-NAME.md` en un `.github-private` repositorio para obtener una disponibilidad más amplia.
Para obtener más información, vea Preparación para usar agentes personalizados en su organización y Preparación para usar agentes personalizados en su empresa.
Agentes integrados
Además del agente principal Copilot , que procesa la solicitud al enviar un mensaje, CLI de Copilot incluye los siguientes agentes integrados que el agente principal puede ejecutar como subagentes para ayudar con tareas comunes de desarrollo. Estos agentes están optimizados para mejorar la eficacia y la precisión, aprovechando las funcionalidades de los modelos de lenguaje subyacentes y las herramientas para proporcionar asistencia de alta calidad en sus respectivos dominios.
Copilot usará automáticamente un agente integrado adecuado en función del mensaje y el contexto actual. Por ejemplo, la solicitud `How does authentication work in this codebase?` normalmente desencadenará el agente de exploración, y el uso del `/research` comando slash desencadenará el agente de investigación.
* explore : un agente de exploración de código base rápido y ligero. Usa herramientas de inteligencia de código, grep, glob, view y shell para buscar archivos y comprender la estructura de código. No cambiará ningún archivo, por lo que se puede llamar en paralelo a otros subagentes que ejecuta el agente principal Copilot . Tiene acceso de solo lectura a las herramientas de servidor MCP de GitHub.
-
**task** : un agente de ejecución de comandos que ejecuta comandos de desarrollo (pruebas, compilaciones, linters, formateadores, instalaciones de dependencia) e informa de forma eficaz. Devuelve un breve resumen en caso de éxito y la salida completa en caso de fallo, manteniendo limpio el contexto principal. Tiene acceso a todas las herramientas que el agente primario puede usar (excepto algunos que no son adecuados en un contexto de subagente), con los mismos permisos concedidos o denegados. -
**uso general** : este agente básicamente tiene todas las mismas funcionalidades que el agente principal Copilot . El agente principal puede ejecutar el agente de uso general como un subagente para ayudar con cualquier tarea que requiera una ventana de contexto independiente o ejecutarse en paralelo cuando sea necesario. -
**revisión de código** : revisa los cambios de código con una relación de señal a ruido extremadamente alta. Este agente analiza los cambios preconfigurados o sin etiquetar y las diferencias de rama, y solo muestra problemas que realmente importan: errores, vulnerabilidades de seguridad, condiciones de carrera, pérdidas de memoria y errores lógicos. No se comenta nunca sobre el estilo o el formato. No realizará ningún cambio en los archivos. -
**research** — Este agente opera como ingeniero de software de nivel de personal y especialista en investigación. Proporciona respuestas exhaustivas, minuciosamente investigadas sobre código base, API, bibliotecas y arquitectura de software. Usa GitHub herramientas de búsqueda y exploración, captura/búsqueda web y herramientas locales. A diferencia de los otros agentes, el agente de investigación solo se puede invocar mediante el `/research` comando de barra diagonal. El agente principal no puede desencadenarlo automáticamente.
Ejecución de agentes como subagentes
Una de las ventajas de usar agentes personalizados que ha definido usted mismo (o los agentes integrados) es que el agente principal Copilot puede ejecutarlos como subagentes con una ventana de contexto independiente. Esto significa que el agente personalizado o el agente integrado pueden centrarse en una subtarea específica sin desordenar la ventana de contexto del agente principal.
Cuando proceda, las tareas realizadas por subagentes se pueden ejecutar en paralelo, lo que permite que la tarea general se complete más rápidamente.
Para obtener más información, vea Comparación de las características de personalización de la CLI de GitHub Copilot.
Pasos siguientes
Para crear su propio agentes personalizados, consulte:
-
[AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli) -
[AUTOTITLE](/copilot/reference/customization-cheat-sheet)