Acerca de los agentes personalizados

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.

          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.

Dónde puede usar 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.

Una vez creado agentes personalizados, 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

CLI de GitHub Copilot

Puede usar perfiles de agente 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 agentes personalizados de en Visual Studio Code, vea Agentes personalizados en VS Code.

Pasos siguientes

Para crear su propio agentes personalizados, consulte:

        [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents)

        [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)

        [AUTOTITLE](/copilot/reference/customization-cheat-sheet)