Creación de agentes personalizados para agente en la nube de Copilot

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

¿Quién puede utilizar esta característica?

agente en la nube de Copilot está disponible con los planes Copilot Pro de GitHub, 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 los repositorios propiedad de cuentas de usuario administradas y donde se ha deshabilitado explícitamente.
Sign up for Copilot

En este artículo

          Agentes personalizados le permiten adaptar la experiencia de Copilot a tareas específicas. Para obtener información general conceptual sobre agentes personalizados, consulte [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-custom-agents).

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 en un repositorio en agente personalizado

  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 agente personalizado perfil.

    Nota:

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

  3. De forma opcional, seleccione la rama en la cual 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 una organización o una empresa de nivel agente personalizado empresarial, elimine la parte .github/ de la ruta de acceso del archivo para mover su 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, incluido el nombre, la descripción, las herramientas y las indicaciones. Para obtener más información sobre lo que perfil de agente puede incluir, vea Configuración de un perfil de agente.

  8. Confirme el archivo en el repositorio y combítelo en la rama predeterminada. Vuelva a la pestaña agentes y actualice la página si es necesario. Ahora agente personalizado aparecerá en la lista desplegable al hacer clic en el cuadro de diálogo.

Configuración de un perfil de agente

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

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

Para configurar perfil de agente:

  1. Opcionalmente, escriba un name para 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 en 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 van a crear y usar perfil de agente en VS Code, los IDEs de JetBrains, Eclipse o Xcode, también pueden 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.

Por 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.

Usar agentes personalizados

Una vez que haya creado un agente personalizado, puede usarlo donde agente en la nube de Copilot esté disponible.

  • Al asignar una tarea a agente en la nube de Copilot en GitHub.com, seleccione agente personalizado en el menú desplegable del panel de agentes o en la pestaña de agentes en lugar del valor predeterminado agente de nube.
  • Al asignar agente en la nube de Copilot a un problema, puede seleccionar agente personalizado del menú desplegable para gestionar el problema con su configuración especializada.
  • Al usar CLI de GitHub Copilot, puede optar por usar un determinado agente personalizado mediante el comando de barra /agent o haciendo referencia al agente en un indicador del sistema o a través de un argumento de línea de comandos. Para obtener más información, vea Uso de la CLI de GitHub Copilot.

Cuando Copilot crea solicitudes de pull, anotará cuál agente personalizado se utilizó para completar el trabajo en la descripción de la solicitud de pull.

Para más información sobre el uso de agente en la nube de Copilot, consulta Pedirle a GitHub Copilot que cree un pull request.

Pasos siguientes