Uso de agentes integrados y personalizados con GitHub Copilot

Visual Studio incluye un conjunto de agentes integrados mantenidos que se integran profundamente con las funcionalidades del IDE, como la depuración, la generación de perfiles y las pruebas. También puede crear agentes personalizados adaptados a cómo funciona el equipo.

Prerrequisitos

• Visual Studio 2022 version 17.14 o posterior
• Una suscripción GitHub Copilot

Acceso a agentes personalizados

Agentes integrados

Cada agente integrado está diseñado en torno a un flujo de trabajo de desarrollador específico e se integra con las herramientas nativas de Visual Studio de manera que un asistente genérico no pueda.

Utilice el agente

El agente de @profiler se conecta a las herramientas de generación de perfiles de Visual Studio para ayudar a identificar y corregir problemas de rendimiento.

Indicaciones de ejemplo:

• @profiler Find the performance bottlenecks in my application
• @profiler Why is this method taking so long to execute?
• @profiler Suggest optimizations for the hot path

Agentes personalizados

Los agentes integrados cubren flujos de trabajo comunes, pero el equipo conoce mejor el flujo de trabajo. Los agentes personalizados le permiten crear su propio con la misma base: reconocimiento del área de trabajo, comprensión del código, su modelo de IA preferido y sus propias herramientas.

Los agentes personalizados se vuelven especialmente eficaces cuando se combinan con MCP (Protocolo de contexto de modelo). Puede conectar agentes a orígenes de conocimiento externos, como documentación interna, sistemas de diseño, API y bases de datos, por lo que el agente no se limita a lo que se encuentra en el repositorio.

Creación de un agente personalizado

Los agentes personalizados se definen como archivos en la carpeta del repositorio:

your-repo/
└── .github/
    └── agents/
        └── code-reviewer.agent.md

Formato de archivo del agente

Cada archivo de agente usa una plantilla sencilla con la frontmatter de YAML seguida de las instrucciones de Markdown:

---
name: Code Reviewer
description: Reviews PRs against our team's coding standards
model: claude-opus-4-6
tools: ["code_search", "readfile", "find_references"]
---

You are a code reviewer for our team. When reviewing changes, check for:

- Naming conventions: PascalCase for public methods, camelCase for private
- Error handling: all async calls must have try/catch with structured logging
- Test coverage: every public method needs at least one unit test

Flag violations clearly and suggest fixes inline.

Propiedades de frontmatter

Especificar herramientas

Las herramientas amplían lo que el agente personalizado puede hacer. Puede especificar qué herramientas debe usar el agente en la matriz.

Conexión a orígenes externos con MCP

Con los servidores MCP, los agentes personalizados pueden acceder a orígenes de conocimiento externos:

• Documentación interna y wikis
• Diseñar sistemas y bibliotecas de componentes
• API y bases de datos
• Guías de estilo y repositorios de ADR

Por ejemplo, un agente de revisión de código puede comprobar las solicitudes de incorporación de cambios contra tus convenciones reales conectándose a tu guía de estilo a través de MCP.

Agentes personalizados de ejemplo

Agente de revisión de código

---
name: Code Reviewer
description: Reviews code against our team's coding standards
tools: ["code_search", "readfile"]
---

You are a code reviewer for our team. Review changes for:

1. **Naming conventions**: PascalCase for public methods, camelCase for private fields
2. **Error handling**: All async calls must have try/catch with structured logging
3. **Test coverage**: Every public method needs at least one unit test
4. **Documentation**: Public APIs must have XML documentation comments

Flag violations clearly and suggest fixes inline.

Agente de planificación

---
name: Feature Planner
description: Helps plan features before writing code
tools: ["code_search", "readfile", "find_references"]
---

You are a planning assistant. When asked about a feature:

1. Gather requirements by asking clarifying questions
2. Identify affected files and components in the codebase
3. Break down the work into discrete tasks
4. Flag potential risks or dependencies
5. Create a structured plan that can be handed off for implementation

Focus on understanding scope before suggesting solutions.

Diseño del agente del sistema

---
name: Design System
description: Enforces UI design patterns and component usage
tools: ["code_search", "readfile"]
---

You are a design system expert. When reviewing UI code:

1. Check that standard components are used instead of custom implementations
2. Verify spacing and layout follow the design token system
3. Ensure accessibility requirements are met (ARIA labels, keyboard navigation)
4. Flag any UI drift from established patterns

Reference the component library documentation when suggesting fixes.

Agente de desarrollo integral con herramientas de Visual Studio

En el ejemplo siguiente se usan nombres de herramientas específicos de Visual Studio:

---
name: Full Stack Dev
description: Full-stack development assistant with search, file editing, and terminal access
tools: ["code_search", "readfile", "editfiles", "find_references", "runcommandinterminal", "getwebpages"]
---

You are a full-stack development assistant. Help with:

1. Searching the codebase to understand existing patterns
2. Reading and editing files to implement changes
3. Running build and test commands to verify your work
4. Looking up documentation when needed

Always check existing code conventions before making changes.

Configuraciones de la comunidad

El repositorio awesome-copilot tiene configuraciones de agente con contribución de la comunidad que puede usar como puntos de partida. Al usar configuraciones de este repositorio, compruebe que los nombres de herramientas funcionan en Visual Studio antes de realizar la implementación en el equipo.

Limitaciones y notas

• Si no especifica un modelo, el agente usa el modelo seleccionado en el selector de modelos.
• Los nombres de herramientas varían en las plataformas de GitHub Copilot. Compruebe que los nombres de herramientas funcionan en Visual Studio antes de realizar la implementación en el equipo.

Compartir comentarios

Comparta las configuraciones del agente personalizado en el repositorio awesome-copilot o envíe comentarios a través de Visual Studio Developer Community. Los flujos de trabajo ayudan a dar forma a las características futuras.

Contenido relacionado

• Introducción al modo de agente de GitHub Copilot
• Uso de servidores MCP
• Personalización de respuestas de chat y establecimiento de contexto
• Pruebas de GitHub Copilot para .NET