Acerca de los agentes personalizados

Custom agents mejora Copilot con asistencia adaptada a tus necesidades.

En este artículo

Acerca de custom agents

Custom agents 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 custom agents utilizando archivos Markdown llamados agent profiles. Estos archivos especifican mensajes, herramientas y servidores MCP. Esto le permite codificar las convenciones, marcos y resultados deseados directamente en Copilot.

agent profile define el comportamiento de custom agent. Al asignar el agente a una tarea o un problema, este crea una instancia de custom agent.

Formato de Agent profile

Agent profiles son archivos Markdown con frontmatter de YAML. En su forma más sencilla, incluyen:

  • Nombre (opcional): nombre para mostrar de custom agent. 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.

Agent profiles también puede incluir configuraciones de servidor MCP mediante la mcp-servers propiedad .

Por ejemplo, agent profile

Este ejemplo es un elemento básico agent profile 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 custom agents

Puede definir agent profiles en distintos niveles:

  • Nivel de repositorio: cree .github/agents/CUSTOM-AGENT-NAME.md en el repositorio para agentes específicos del proyecto.
  • Nivel de organización: cree /agents/CUSTOM-AGENT-NAME.md en el repositorio .github o .github-private de la organización para una mayor disponibilidad dentro de la organización.
  • A nivel de empresa: cree /agents/CUSTOM-AGENT-NAME.md en el repositorio .github-private de una organización que el propietario de la empresa haya designado en la configuración de la empresa para que esté disponible en todos los repositorios de la empresa.

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.

Dónde puede usar custom agents

Nota:

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

Una vez creado custom agents, estarán disponibles para:

  • Copilot cloud agent en GitHub.com: pestaña de agentes y panel, asignación de incidencias y solicitudes de incorporación de cambios
  • Copilot cloud agent en IDEs: Visual Studio Code, IDEs de JetBrains, Eclipse y Xcode
  • GitHub Copilot CLI

Puede usar agent profiles directamente en Visual Studio Code, IDE de JetBrains, Eclipse y Xcode. Algunas propiedades pueden funcionar de forma diferente o omitirse entre entornos.

Para obtener más información sobre el uso custom agents de en Visual Studio Code, vea Custom agents en VS Code.

Pasos siguientes

Para crear su propio custom agents, consulte: