Creación de agentes personalizados para Agente de programación Copilot

Puede crear agentes especializados con conocimientos personalizados para tareas de desarrollo específicas.

¿Quién puede utilizar esta característica?

Agente de programación Copilot está disponible con los planes GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot para empresas y GitHub Copilot para grandes empresas. El agente está disponible en todos los repositorios almacenados en GitHub, excepto si se ha deshabilitado explícitamente y los repositorios que pertenecen a cuentas de usuario administradas.
Sign up for Copilot

En este artículo

Agentes personalizados le permiten personalizar la experiencia de Copilot para tareas específicas. Para obtener una visión general conceptual acerca de agentes personalizados, consulte Acerca de los agentes personalizados.

Nota:

Agentes personalizados se encuentran en versión preliminar pública para los IDEs de JetBrains, Eclipse y Xcode y pueden estar sujetos a cambios.

Creación de un perfil de agente personalizado en un repositorio en GitHub

  1. Vaya a la pestaña agentes en https://github.com/copilot/agents.

  2. Con el menú desplegable del cuadro de solicitud, seleccione el repositorio en el que desea crear el perfil agente personalizado .

    Nota:

    Los propietarios de organizaciones y empresas pueden crear agentes personalizados a nivel de organización y empresa en un repositorio de .github-private, que están disponibles en todos los repositorios de su organización o empresa. Para más información, consulta Preparación para usar agentes personalizados en su empresa y Preparación para usar agentes personalizados en su organización.

  3. Opcionalmente, seleccione la rama en la que desea crear el perfil de agente. El valor predeterminado es la rama principal.

  4. Haga clic en y, a continuación, haga clic en Crear un agente. Se abrirá un perfil de agente de plantilla denominado my-agent.agent.md en el directorio .github/agents del repositorio de destino.

  5. Si está creando un agente personalizado de nivel de organización o empresa , elimine la parte .github/ de la ruta de archivo para mover la plantilla al directorio raíz agents.

  6. Edite el nombre de archivo (el texto anterior a .agent.md), seleccionando un nombre único y descriptivo que identifique el propósito del agente. Tenga en cuenta que el nombre de archivo solo puede contener los siguientes caracteres: ., -, _``a-z, , A-Z, . 0-9

  7. Configure el perfil de agente, incluyendo el nombre, la descripción, las herramientas y las sugerencias. Para obtener más información sobre lo que los datos perfil de agente pueden incluir, consulte Configuración de un perfil de agente.

  8. Confirme el archivo en el repositorio y combítelo en la rama predeterminada. Vuelve a la pestaña de agentes y actualiza la página si es necesario. Su agente personalizado aparecerá ahora en el menú desplegable al hacer clic en en el cuadro de diálogo de solicitudes.

Creación de un perfil de agente personalizado en Visual Studio Code

  1. Abre Chat de GitHub Copilot en Visual Studio Code.
  2. En la lista desplegable de agentes de la parte inferior de la vista de chat, haga clic en Configurar agentes personalizados... y, a continuación, haga clic en Crear nuevo agente personalizado.
  3. Elija la ubicación donde se debe crear el perfil de agente: * Workspace: cree el perfil agente personalizado en la carpeta .github/agents del área de trabajo para que solo la use dentro de esa área de trabajo. * Perfil de usuario: cree el perfil de agente personalizado en la carpeta del perfil de usuario actual para usarlo en todas las áreas de trabajo.
  4. Escriba un nombre de archivo para agente personalizado. Este es el nombre predeterminado que aparece en la lista desplegable de agentes.
  5. Configure el perfil de agente en el archivo recién creado .agent.md, incluida la descripción, las herramientas y las indicaciones. Para obtener más información sobre lo que los datos perfil de agente pueden incluir, consulte Configuración de un perfil de agente.
    • Puede usar el botón Configurar herramientas... en el editor para abrir el cuadro de diálogo "Configurar herramientas", donde puede ver y seleccionar herramientas disponibles, incluidas las herramientas integradas y las herramientas de los servidores MCP. Haga clic en Aceptar para agregar herramientas seleccionadas a perfil de agente.
    • Para establecer el modelo de IA que usa el agente, agregue una model: propiedad y seleccione el modelo preferido en la lista desplegable Autocompletar.

Para actualizar un perfil de agente, seleccione Configurar agentes personalizados en la lista desplegable agentes y, a continuación, haga clic en un agente de la lista para modificarlo. Para obtener más información sobre agentes personalizados en VS Code, consulte Agentes personalizados en VS Code.

Creación de un perfil de agente personalizado en los entornos IDE de JetBrains

  1. Abra la ventana de Chat de GitHub Copilot en el IDE de JetBrains.
  2. En la lista desplegable agentes de la parte inferior de la vista de chat, haga clic en Configurar agentes... y, a continuación, en la ventana de configuración, en "Agentes de chat", haga clic en Área de trabajo.
  3. Escriba un nombre de archivo para agente personalizado. Este es el nombre predeterminado que aparece en la lista desplegable de agentes.
  4. Configure el perfil de agente en el archivo .agent.md recién creado en el directorio .github/agents, incluyendo la descripción, las herramientas y las solicitudes. Para obtener más información sobre lo que los datos perfil de agente pueden incluir, consulte Configuración de un perfil de agente.
    • Puede usar el botón Configurar herramientas... dentro del editor para abrir el cuadro de diálogo herramientas, donde puede ver y seleccionar herramientas disponibles, incluidas las herramientas integradas y las herramientas de los servidores MCP. Haga clic en Aplicar para agregar herramientas seleccionadas a perfil de agente.
    • Para establecer el modelo de IA que usa el agente, agregue una model: propiedad y seleccione el modelo preferido en la lista desplegable Autocompletar.

Para actualizar un perfil de agente, seleccione Configuración de Agentes Personalizados en la lista desplegable de agentes y luego haga clic en el icono junto al agente que desea modificar.

Creación de un perfil de agente personalizado en Eclipse

  1. Abre la ventana Chat de GitHub Copilot en Eclipse.
  2. En la lista desplegable agentes de la parte inferior de la vista de chat, haga clic en Configurar agentes... y, a continuación, haga clic en Agregar....
  3. Escriba un nombre de archivo para agente personalizado. Este es el nombre predeterminado que aparece en la lista desplegable de agentes.
  4. Configure el perfil de agente en el archivo .agent.md recién creado en el directorio .github/agents, incluyendo la descripción, las herramientas y las solicitudes. Para obtener más información sobre lo que los datos perfil de agente pueden incluir, consulte Configuración de un perfil de agente.
    • Puede usar el botón Configurar herramientas... en el editor para abrir el cuadro de diálogo "Configurar herramientas", donde puede ver y seleccionar herramientas disponibles, incluidas las herramientas integradas y las herramientas de los servidores MCP. Haga clic en Aplicar para agregar herramientas seleccionadas a perfil de agente.
    • Para establecer el modelo de IA que usa el agente, agregue una model: propiedad y seleccione el modelo preferido en la lista desplegable Autocompletar.

Para actualizar un perfil de agente, seleccione Configurar agentes... en la lista desplegable agentes y, a continuación, seleccione el agente que desea modificar y haga clic en Editar.

Creación de un perfil de agente personalizado en Xcode

  1. Abra la ventana Chat de GitHub Copilot en Xcode.
  2. En la lista desplegable de agentes en la parte inferior de la vista de chat, haga clic en Crear un agente.
  3. Escriba un nombre de archivo para agente personalizado. Este es el nombre predeterminado que aparece en la lista desplegable de agentes.
  4. Configure el perfil de agente en el archivo .agent.md recién creado en el directorio .github/agents, incluyendo la descripción, las herramientas y las solicitudes. Para obtener más información sobre lo que los datos perfil de agente pueden incluir, consulte Configuración de un perfil de agente.
    • Puede usar el botón Personalizar agente dentro del editor de archivos para abrir un cuadro de diálogo, donde puede seleccionar el modelo de IA para que el agente lo use, seleccionar las herramientas disponibles (incluidas las herramientas integradas y de servidor MCP) y configurar la propiedad para realizar la handoffs transición entre agentes personalizados. Haga clic en Aplicar para agregar opciones seleccionadas a perfil de agente.

Para actualizar un perfil de agente, en la lista desplegable de agentes, haga clic en el icono de lápiz situado junto al agente que desea modificar.

Configuración de perfil de agente

Un perfil de agente es un archivo Markdown con texto preliminar YAML que especifica el nombre, la descripción, las herramientas disponibles y las configuraciones de MCP de agente personalizado. La configuración de un perfil de agente implica definir la identidad, las capacidades, el acceso a herramientas y las instrucciones de comportamiento del agente.

Para obtener información detallada sobre las propiedades YAML, herramientas, alias de herramientas, configuración del servidor MCP, y cómo se procesan agentes personalizados, consulte Configuración de agentes personalizados.

Para configurar su perfil de agente:

  1. De manera opcional, escriba un name para su agente personalizado. Si no se establece, el nombre tendrá como valor predeterminado el nombre de archivo (sin el .md sufijo o .agent.md ).
  2. Escriba un breve description (obligatorio) explicando lo que hace tu agente y sus capacidades específicas o su expertise en el dominio.
  3. En la tools propiedad , defina qué herramientas puede usar el agente. Se trata de una lista de nombres o alias de herramientas, incluidas las herramientas de los servidores MCP configurados en la configuración del repositorio o perfil de agente (por ejemplo, tools: ["read", "edit", "search", "some-mcp-server/tool-1"]). Si omite esta propiedad, el agente tendrá acceso a todas las herramientas disponibles. Consulte "Herramientas" en Configuración de agentes personalizados.
  4. Opcionalmente, en la mcp-servers propiedad , puede configurar servidores MCP que solo estarán disponibles para este agente para ampliar sus funcionalidades. Consulte "Detalles de configuración del servidor MCP" en Configuración de agentes personalizados.
  5. Si está creando y usando perfil de agente en VS Code, IDE de JetBrains, Eclipse o Xcode, también puede usar la propiedad model para controlar qué modelo de IA debe usar el agente.
  6. Opcionalmente, establezca la propiedad target en vscode o github-copilot si solo desea usar el agente en un entorno específico. El agente estará disponible en ambos entornos si omite la propiedad.
  7. Escriba el mensaje del agente. Defina el comportamiento, la experiencia y las instrucciones del agente en el contenido de Markdown debajo del frontmatter de YAML. El mensaje puede tener un máximo de 30 000 caracteres.

Ejemplo perfiles de agente

En los ejemplos siguientes se muestra lo que un perfil de agente podría parecer para las tareas comunes de realizar pruebas o planificar la implementación de un proyecto. Para obtener más inspiración, consulte los ejemplos de Agentes personalizados en la biblioteca de personalización. También puede encontrar ejemplos más específicos en la colección de comunidad awesome-copilot .

Especialista en pruebas

En este ejemplo se habilitan todas las herramientas omitiendo la tools propiedad .

Text
---
name: test-specialist
description: Focuses on test coverage, quality, and testing best practices without modifying production code
---

You are a testing specialist focused on improving code quality through comprehensive testing. Your responsibilities:

- Analyze existing tests and identify coverage gaps
- Write unit tests, integration tests, and end-to-end tests following best practices
- Review test quality and suggest improvements for maintainability
- Ensure tests are isolated, deterministic, and well-documented
- Focus only on test files and avoid modifying production code unless specifically requested

Always include clear test descriptions and use appropriate testing patterns for the language and framework.

Planificador de implementación

En este ejemplo solo se habilita un subconjunto de herramientas.

Text
---
name: implementation-planner
description: Creates detailed implementation plans and technical specifications in markdown format
tools: ["read", "search", "edit"]
---

You are a technical planning specialist focused on creating comprehensive implementation plans. Your responsibilities:

- Analyze requirements and break them down into actionable tasks
- Create detailed technical specifications and architecture documentation
- Generate implementation plans with clear steps, dependencies, and timelines
- Document API designs, data models, and system interactions
- Create markdown files with structured plans that development teams can follow

Always structure your plans with clear headings, task breakdowns, and acceptance criteria. Include considerations for testing, deployment, and potential risks. Focus on creating thorough documentation rather than implementing code.

Uso de agentes personalizados

Una vez que haya creado un agente personalizado, puede usarlo en todos los lugares donde Agente de programación Copilot esté disponible.

  • Al solicitar a Agente de programación Copilot una tarea en GitHub.com, use el menú desplegable en el panel de agentes o la pestaña de agentes para seleccionar su agente personalizado en lugar del agente de codificación predeterminado.
  • Al asignar Agente de programación Copilot a un problema, puede seleccionar su agente personalizado en el menú desplegable para manejar la incidencia con su configuración especializada.
  • Al usar CLI de GitHub Copilot, puede optar por usar un determinado agente personalizado mediante el comando de barra diagonal /agent o haciendo referencia al agente en una solicitud o a través de un argumento de línea de comandos. Para más información, consulta Uso de la CLI de GitHub Copilot.

Cuando Copilot abre solicitudes de incorporación de cambios, observará qué agente personalizado se usó para completar el trabajo en la descripción de la solicitud de incorporación de cambios.

Para obtener más información sobre el uso de Agente de programación Copilot, consulte Pedir a GitHub Copilot que cree una solicitud de incorporación de cambios.

Uso de agentes personalizados en un IDE

También puede usar sus datos personalizados perfiles de agente directamente en los IDE admitidos, incluidos Visual Studio Code, los IDE de JetBrains, Eclipse y Xcode. Puede cambiar entre agentes personalizados usando la lista desplegable del agente en la ventana de chat, lo que le permite acceder a configuraciones especializadas para diferentes tareas, como planificación, edición de código o investigación.

Tenga en cuenta que algunas propiedades pueden funcionar de forma diferente o omitirse entre los entornos GitHub.com y IDE. Para obtener más información sobre las propiedades admitidas, consulte Configuración de agentes personalizados.

Para obtener más información sobre agentes personalizados específicamente en VS Code, consulte Agentes personalizados en VS Code en la documentación de VS Code.

Pasos siguientes