Use agentes integrados e personalizados com GitHub Copilot

O Visual Studio inclui um conjunto de agentes integrados selecionados que se integram profundamente com capacidades do IDE, como depuração, perfilagem e testes. Também pode criar agentes personalizados adaptados ao funcionamento da sua equipa.

Pré-requisitos

• Visual Studio 2026 ou Visual Studio 2022 versão 17.14 (com a versão de atualização mais recente recomendada para as funcionalidades mais atualizadas)
• Uma subscrição GitHub Copilot

Aceder a agentes aduaneiros

Agentes incorporados

Cada agente incorporado foca-se num fluxo de trabalho específico do programador. Estes agentes integram-se com as ferramentas nativas do Visual Studio de formas que um assistente genérico não consegue.

Usa o @profiler agente

O agente @profiler liga-se às ferramentas de perfil da Visual Studio para ajudar a identificar e corrigir problemas de desempenho.

Exemplos de prompts:

• @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 aduaneiros

Os agentes integrados cobrem fluxos de trabalho comuns, mas a sua equipa conhece melhor o seu fluxo de trabalho. Os agentes personalizados permitem-lhe construir os seus próprios agentes usando a mesma base: consciência do espaço de trabalho, compreensão de código, o seu modelo de IA preferido e as suas próprias ferramentas.

Os agentes personalizados tornam-se especialmente poderosos quando combinados com MCP (Model Context Protocol). Podes ligar agentes a fontes externas de conhecimento como documentação interna, sistemas de design, APIs e bases de dados, para que o agente não fique limitado ao que está no teu repositório.

Criar um agente personalizado

Defina agentes personalizados como ficheiros .agent.md na pasta .github/agents/ do repositório.

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

Formato de ficheiro agente

Cada ficheiro agente utiliza um modelo simples com material inicial YAML seguido de instruções 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.

Propriedades do Frontmatter

Especificar ferramentas

As ferramentas estendem o que o seu agente personalizado pode fazer. Podes especificar que ferramentas o agente deve usar no tools array.

Liga-te a fontes externas com MCP

Ao utilizar servidores MCP, os seus agentes personalizados podem aceder a fontes externas de conhecimento tais como:

• Documentação interna e wikis
• Sistemas de conceção e bibliotecas de componentes
• APIs e bases de dados
• Guias de estilo e repositórios ADR

Por exemplo, um agente de revisão de código pode verificar os PRs com as suas convenções reais, ligando-se ao seu guia de estilo através do MCP.

Exemplos de agentes aduaneiros

Agente de revisão 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 planeamento

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

Agente do sistema de projeto

---
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 desenvolvimento full-stack com ferramentas do Visual Studio

O exemplo seguinte utiliza nomes de ferramentas específicas do 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.

Agentes de desenvolvimento .NET

A equipa .NET mantém agentes personalizados curados para desenvolvimento em C# e Windows Forms no repositório awesome-copilot . Para começar:

1. Descarregue CSharpExpert.agent.md e WinFormsExpert.agent.md.
2. Adicione os ficheiros à pasta do .github/agents/ seu repositório.
3. Abre o Copilot Chat em modo agente e seleciona o agente no selecionador de agentes.

Especialista em C#

O agente C# Expert aplica as convenções modernas de C# à geração de código do Copilot:

• Sintaxe e desempenho: Segue as melhores práticas atuais enquanto corresponde às convenções existentes do seu repositório.
• Alterações mínimas: Gera apenas o código necessário, usando async/await com cancelamento adequado e gestão de exceções. Evita interfaces, métodos ou parâmetros não utilizados.
• Testes: Suporta testes unitários orientados pelo comportamento, testes de integração e fluxos de trabalho TDD.

WinForms Expert

O agente WinForms Expert direciona-se para o desenvolvimento do Windows Forms em .NET 8 até .NET 10:

• Proteção do código do designer: Previne .Designer.cs corrupção para que o Windows Forms Designer continue a funcionar após as edições do Copilot.
• Padrões de design de interface: padrões MVVM e MVP, incluindo a ligação de dados Community Toolkit.
• .NET moderno: Sobrecargas corretas InvokeAsync , modo escuro, compatibilidade com alto DPI e tipos de referência anuláveis.
• Layout: TableLayoutPanel e FlowLayoutPanel para layouts responsivos, conscientes do DPI.
• Serialização CodeDOM: [DefaultValue] atributos e ShouldSerialize*() métodos para o tratamento adequado de propriedades projetistas.
• Tratamento de exceções: padrões de gestores de eventos assíncronos e tratamento de exceções ao nível da aplicação.

Configurações comunitárias

O repositório awesome-copilot tem configurações de agentes contribuídas pela comunidade que podes usar como pontos de partida. Quando usar configurações deste repositório, verifique se os nomes das ferramentas funcionam no Visual Studio antes de as implementar na sua equipa.

Limitações e notas

• Se não especificares um modelo, o agente usa o modelo selecionado no selector de modelos.
• Os nomes das ferramentas variam entre GitHub Copilot plataformas. Verifica se os nomes das ferramentas funcionam no Visual Studio antes de implementares na tua equipa.

Partilhar comentários

Partilhe as suas configurações de agentes personalizados no repositório awesome-copilot ou envie feedback através do Visual Studio Developer Community. Os seus fluxos de trabalho ajudam a moldar as funcionalidades futuras.

Conteúdo relacionado

• Inicie-se com o modo agente do GitHub Copilot
• Usar servidores MCP
• Personalize as respostas do chat e defina o contexto
• Teste do GitHub Copilot para .NET
• Visão geral da modernização da aplicação GitHub Copilot