Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Você pode solicitar ao GitHub Copilot Chat que forneça sugestões de código, explique o código, gere testes unitários e sugira correções para o código. O chat no Visual Studio pode fornecer respostas e gerar código que corresponda às práticas de codificação e aos requisitos de projeto, se você fornecer o contexto certo. Em vez de adicionar repetidamente essas informações em cada prompt de chat, você pode armazenar esse contexto em arquivos e incluí-lo automaticamente em cada solicitação de chat.
Para fornecer contexto relevante e adaptar Copilot Chat respostas, você pode realizar as seguintes tarefas:
- Use comandos de barra para especificar rapidamente tarefas comuns, como
/savePrompt, ou invocar seus prompts personalizados diretamente - Usar a experiência de chat guiada para refinar o contexto
- Usar instruções personalizadas e arquivos de prompt para personalizar respostas
- Use comandos de barra para especificar rapidamente tarefas comuns, como
/explainobter explicações de código - Usar a experiência de chat guiada para refinar o contexto
- Usar instruções personalizadas e arquivos de prompt para personalizar respostas
Saiba mais sobre desenvolvimento assistido por IA no Visual Studio e como usar o Copilot Chat no Visual Studio.
Pré-requisitos
Antes de começar, verifique se você atende aos pré-requisitos a seguir.
| Prerequisite | Detalhes |
|---|---|
| Visual Studio | Visual Studio 2022 versão 17.10 ou posterior. |
| Conta do GitHub | Entrar no Visual Studio usando uma conta do GitHub com Acesso ao Copilot. Você pode se inscrever no GitHub Copilot Gratuito. |
Note
A partir de 20 de abril de 2026, as avaliações do GitHub Copilot Pro estão pausadas. Se estiver em um período de teste, mude para Copilot Gratuito ou atualize para um plano pago. Para obter suporte, consulte https://docs.github.com/en/copilot/get-started/plans.
Para obter suporte do GitHub Copilot Chat, entre em contato com o GitHub em https://support.github.com.
Diretrizes de prompting
A experiência de chat guiada no Visual Studio 17.12 e posterior ajuda a refinar seus prompts para esclarecer o contexto para obter melhores respostas. O GitHub Copilot Chat agora orienta você com perguntas esclarecedoras quando o contexto não está claro.
Use instruções personalizadas
Usando o recurso de instruções personalizadas, você pode adicionar automaticamente detalhes contextuais pré-especificados às suas perguntas de chat. Copilot Chat usa essas instruções para gerar respostas que refletem seu contexto específico, como a maneira como sua equipe funciona, as ferramentas que você usa ou as especificidades do seu projeto.
Usar um arquivo .github/copilot-instructions.md
Para usar um .github/copilot-instructions.md arquivo:
-
Crie ou adicione um arquivo
.github/copilot-instructions.mdde instruções personalizado na raiz do repositório.
- Habilite o recurso no Visual Studio no painelOpções de >. Expanda a seção All Settings>GitHub>Copilot>Copilot Chat e marque a caixa de seleção Habilitar instruções personalizadas a serem carregadas dos arquivos .github/copilot-instructions.md e adicionadas às solicitações.
- Habilite o recurso no Visual Studio na caixa de diálogoOpções de >. Expanda a seção GitHub>Copilot e marque a caixa de seleção Habilitar instruções personalizadas para serem carregadas de arquivos .github/copilot-instructions.md e adicionadas às solicitações no grupo Copilot Chat.
O conteúdo das instruções personalizadas não aparece no modo de exibição do Chat nem no chat embutido. No entanto, quando Copilot usa o .github/copilot-instructions.md arquivo, ele lista o arquivo na lista Referências para a resposta.
As memórias do copilot podem detectar automaticamente suas preferências durante o chat e adicioná-las aos seus arquivos de instrução, para que você não precise gravá-las manualmente.
Usar instruções personalizadas no nível da organização
Com instruções personalizadas no nível da organização, os proprietários da organização no GitHub podem fornecer orientações compartilhadas que personalizam as respostas do Copilot em todos os repositórios da organização. As equipes podem usar estas instruções para estabelecer preferências e convenções de trabalho em comum.
Note
As instruções personalizadas no nível da organização se aplicam somente a repositórios que pertencem a uma organização de GitHub. Essas instruções expressam preferências e não impõem políticas organizacionais.
Adicionar instruções personalizadas no nível da organização
Os proprietários da organização podem adicionar instruções personalizadas da organização em GitHub.
Revisar as instruções aplicadas
Quando você trabalha em um repositório que pertence à sua organização, Copilot aplica automaticamente as instruções personalizadas da organização. As instruções aplicadas aparecem na lista Referências durante interações Copilot. Selecione a referência para abrir as instruções completas.
Desabilitar instruções personalizadas no nível da organização
Desabilite as instruções no nível da organização se você não quiser usá-las ou se elas entrarem em conflito com suas preferências no nível do usuário:
- SelecioneOpções> de Ferramentas>GitHub>Copilot>Copilot Chat.
- Desmarque Ativar instruções personalizadas da organização.
Usar preferências no nível do usuário
Além das instruções personalizadas no nível do repositório, você pode definir preferências no nível do usuário que se aplicam a todas as sessões do Copilot em projetos. O %USERPROFILE%/copilot-instructions.md arquivo armazena essas preferências.
Use preferências de nível de usuário para padrões de codificação pessoal, padrões preferenciais ou convenções de fluxo de trabalho que você deseja que o Copilot siga, independentemente do repositório em que você está trabalhando. As instruções em nível de repositório em .github/copilot-instructions.md continuam valendo juntamente com suas preferências em nível de usuário; assim, o Copilot também respeita os padrões compartilhados pela sua equipe.
Você pode adicionar preferências a esse arquivo manualmente ou permitir que as memórias do Copilot detectem e salvem-nas automaticamente durante o chat.
Usar arquivos .instructions.md
Em vez de usar um único arquivo de instruções que se aplica a todas as solicitações de chat, você pode criar vários *.instructions.md arquivos que se aplicam a tipos de arquivo ou tarefas específicas. Por exemplo, você pode criar arquivos de instruções para diferentes linguagens de programação, estruturas ou tipos de projeto.
Para usar um .github/instructions/*.instructions.md arquivo:
Crie o diretório
.github/instructionsse ele ainda não existir.Adicione um ou mais
.github/instructions/*.instructions.mdarquivos.Adicione a propriedade
applyTona seção de frontmatter do arquivo de instruções. Use a sintaxe glob para especificar a quais arquivos ou pastas as instruções se aplicam.Habilite o recurso no Visual Studio.
No painel Ferramentas>Opções, expanda a seção Todas as Configurações>GitHub>Copilot>Copilot Chat e selecione a caixa de seleção Habilitar instruções personalizadas a serem carregadas dos arquivos .github/copilot-instructions.md e adicionadas às requisições.
Na caixa de diálogoOpções de >, expanda a seção GitHub>Copilot. No grupo Chat do Copilot, selecione a caixa de seleção Habilitar instruções personalizadas a serem carregadas de arquivos .github/copilot-instructions.md e adicionadas às requisições.
Formato de arquivo de instruções
Os arquivos de instrução de destino usam a .instructions.md extensão e têm esta estrutura:
-
Cabeçalho (opcional): metadados iniciais YAML
-
description: descrição que aparece quando você passa o mouse sobre o arquivo no modo de exibição chat -
applyTo: padrão Glob que corresponde aos arquivos ou pastas aos quais você deseja aplicar as instruções
-
- Corpo: Instruções no formato Markdown
Example
Aqui está um exemplo de instrução personalizada em C#:
## C# Instructions
---
applyTo: `**/*.cs`
---
- Write clear and concise comments for each function.
- Use PascalCase for component names, method names, and public members.
- Use camelCase for private fields and local variables.
- Add a newline before the opening curly brace of any code block
(such as after `if`, `for`, `while`, `foreach`, `using`, `try`, etc.).
- Ensure that the final `return` statement of a method is on its own line.
Copie estas instruções para seu arquivo .github/instructions/*.instructions.md para usar e aplicar automaticamente ao comportamento do Copilot.
Para obter mais exemplos de instruções personalizadas, consulte a lista de exemplos de instruções no GitHub.
Como funcionam os arquivos de instrução
Quando você começa a trabalhar com o Copilot, ele detecta automaticamente quais arquivos de instrução são relevantes para o contexto atual e os anexa como referências. Esse recurso garante que as sugestões de Copilot sempre se alinhem com as regras do projeto, independentemente de onde você esteja trabalhando na base de código.
Copilot lista os arquivos de instrução usados na lista referências da resposta.
Usar arquivos de prompt
Agora você pode criar arquivos de prompt reutilizáveis em seu repositório para executar ou compartilhar seus prompts usados com frequência.
Para criar um arquivo de prompt:
- Escreva seus prompts normalmente na caixa de prompt, usando referências
#para incluir informações específicas de sua solução, como métodos, classes e arquivos. Você pode até mesmo referenciar outros arquivos de prompt para obter instruções compartilhadas. - Copie o prompt em um arquivo markdown e salve-o com a extensão
.prompt.mdna pasta.github/promptsna raiz do seu repositório.
Para usar um arquivo de prompt:
- Digite
#prompt:no campo de chat para fazer referência a qualquer arquivo de prompt da pasta.github/promptsou selecione o ícone ➕ no campo de chat para adicioná-los como contexto. - Adicione detalhes adicionais ou simplesmente insira o prompt como está.
Depois de criar arquivos de prompt, você pode invocá-los rapidamente digitando / na entrada do chat.
Invocar prompts personalizados com comandos de barra
Você pode invocar rapidamente seus prompts personalizados favoritos diretamente da caixa de entrada de chat usando comandos de barra.
Acesse prompts customizados com /
Digite / no campo de entrada do chat para ver seus prompts personalizados no topo da lista do IntelliSense.
- Comandos personalizados aparecem no topo da lista com um ícone de marcador.
-
Os comandos do sistema (como
/help,/savePrompt) aparecem abaixo sem um ícone.
Criar instruções personalizadas com /generateInstructions
Use o /generateInstructions comando para gerar automaticamente instruções personalizadas no nível do repositório para seu projeto. Este comando analisa a estrutura do projeto e os padrões de codificação para criar um arquivo específico copilot-instructions.md do repositório.
Para usar /generateInstructions:
- Abra o Copilot Chat no Visual Studio.
- Digite
/generateInstructionsa entrada de chat e pressione Enter. - O Copilot analisa a estrutura do projeto e os padrões de codificação.
- Copilot gera um
copilot-instructions.mdarquivo em sua.githubpasta.
Esse comando aproveita a inteligência do projeto para detectar estilos e preferências de codificação, facilitando a configuração de instruções personalizadas sem criar manualmente o arquivo.
Salvar os comandos com /savePrompt
Use o /savePrompt comando para extrair um prompt reutilizável da conversa atual e salvá-lo para uso futuro.
Para usar /savePrompt:
- Digite um prompt no Copilot Chat que você deseja reutilizar.
- Depois que o Copilot responder, digite
/savePromptno campo de entrada do chat e selecione Enter. - Escolha um nome para o arquivo de prompt.
-
/savePromptsalva o prompt em.github/prompts/[name].prompt.md.
Em seguida, você pode acessar rapidamente o prompt digitando / e selecionando-o na lista do IntelliSense.
Usar comandos de barra para definir o contexto para tarefas comuns
Os comandos de barra no Copilot Chat ajudam você a definir a intenção rapidamente para tarefas comuns de desenvolvimento. Usando comandos de barra específicos para formar sua pergunta, você pode obter respostas melhores sem precisar escrever perguntas longas.
Você pode usar comandos de barra em uma janela de chat ou diretamente embutidos no código que você está procurando modificar, usando a assistência de código embutido. Os comandos que ajudam a modificar ou adicionar ao arquivo de código que você abriu no editor funcionam tanto no assistente de código embutido quanto nas janelas de chat, enquanto os comandos para perguntas de codificação mais gerais funcionam apenas no painel de chat.
| Comando | Uso | janela de chat | Chat embutido |
|---|---|---|---|
| /doc | Adicione comentários para o código especificado ou selecionado. Exemplos: - /doc DeleteBasketAsync method in BasketService.cs
- selecione o código desejado e insira /doc |
Sim | Sim |
| /explicar | Obtenha explicações de código. Exemplos: - /explain the AddItemToBasket method in BasketService.cs
- selecione o código desejado e insira /explain |
Sim | Sim |
| /consertar | Propor uma correção para problemas no código selecionado. Exemplos: - /fix the SetQuantities method in BasketService.cs
- selecione o código desejado e insira /fix |
Sim | Sim |
| /gerar | Gere código para responder à pergunta especificada. Exemplo: /generate code to add two numbers in Calculator.cs |
Sim | Sim |
| /generateInstructions | Gere instruções personalizadas no nível do repositório (copilot-instructions.md) que refletem os padrões de codificação e a estrutura do projeto. |
Sim | Não |
| /Ajuda | Obtenha ajuda sobre como usar o Copilot Chat. Exemplo: /help |
Sim | Sim |
| /otimizar | Analise e melhore o tempo de execução do código selecionado. Exemplos: - /optimize the AddItemToBasket method in BasketService.cs
- selecione o código desejado e insira /optimize |
Sim | Sim |
| /savePrompt | Salve um prompt reutilizável do thread de conversa atual em um .prompt.md arquivo em sua .github/prompts pasta. |
Sim | Não |
| /tests | Crie testes de unidade para o código selecionado. Exemplo: selecione o código desejado e insira /tests using XUnit FrameworkPara o .NET, recomendamos o Teste de Copilot do GitHub para .NET |
Sim | Sim |
| Comando | Uso | janela de chat | Chat embutido |
|---|---|---|---|
| /doc | Adicione comentários para o código especificado ou selecionado. Exemplos: - /doc DeleteBasketAsync method in BasketService.cs
- selecione o código desejado e insira /doc |
Sim | Sim |
| /explicar | Obtenha explicações de código. Exemplos: - /explain the AddItemToBasket method in BasketService.cs
- selecione o código desejado e insira /explain |
Sim | Sim |
| /consertar | Propor uma correção para problemas no código selecionado. Exemplos: - /fix the SetQuantities method in BasketService.cs
- selecione o código desejado e insira /fix |
Sim | Sim |
| /gerar | Gere código para responder à pergunta especificada. Exemplo: /generate code to add two numbers in Calculator.cs |
Sim | Sim |
| /Ajuda | Obtenha ajuda sobre como usar o Copilot Chat. Exemplo: /help |
Sim | Sim |
| /otimizar | Analise e melhore o tempo de execução do código selecionado. Exemplos: - /optimize the AddItemToBasket method in BasketService.cs
- selecione o código desejado e insira /optimize |
Sim | Sim |
| /tests | Crie testes de unidade para o código selecionado. Exemplo: selecione o código desejado e insira /tests using XUnit FrameworkPara o .NET, recomendamos o Teste de Copilot do GitHub para .NET |
Sim | Sim |
Com o Visual Studio 2022 versão 17.13, conforme o usuário digita um comando de barra, o comando expande o prompt em linguagem natural para exibir o contexto do comando.
Usar ações do Copilot
Use as ações do Copilot no menu de contexto para acessar rapidamente prompts predefinidos e comandos com barra para tarefas comuns de desenvolvimento.
O comportamento de cada ação depende se você seleciona o código ao abrir o menu de contexto:
| Ação | Com o código selecionado | Sem código selecionado |
|---|---|---|
| Explicar | Explica o código selecionado | Explica o código próximo à posição do cursor |
| Otimizar Seleção | Otimiza o código selecionado para desempenho, manutenção, confiabilidade e arquitetura | Não aplicável |
| Gerar comentários | Gera comentários para o código selecionado | Gerar comentários para código próximo à posição do cursor |
| Gerar testes | Gera testes para o código selecionado | Gerar testes para código próximo à posição do cursor |
| Adicionar ao Chat | Adiciona o código selecionado ao Chat como referência | Adicionar o arquivo inteiro ao Chat como referência |
Quando você seleciona qualquer ação, exceto Otimizar Seleção, a janela de chat é aberta automaticamente e envia um comando de barra para Copilot com o contexto de escopo apropriado. Em seguida, você pode examinar e interagir com a resposta do Copilot na janela de chat.
Usar a opção Otimizar Seleção para obter um código melhor
Selecione uma seção específica do código e escolha Otimizar Seleção para que o Copilot analise e melhore apenas essa seção, em vez de um arquivo inteiro.
Copilot examina o código selecionado e seu contexto ao redor para fornecer sugestões significativas e com reconhecimento de contexto. A otimização preserva seu estilo de código, estrutura e funcionalidade existentes, mantendo sua base de código organizada e consistente. Ao contrário de outras ações que usam o painel de chat, Otimizar Seleção apresenta sugestões como uma diferença inline que você pode analisar, aceitar ou rejeitar diretamente.
O Copilot fornece sugestões de otimização entre estas áreas:
- Desempenho: Algoritmos mais rápidos, uso reduzido de memória, padrões assíncronos
- Manutenibilidade: Lógica simplificada, estrutura mais clara, melhor nomenclatura
- Fiabilidade: Tratamento de erros, limpeza de recursos, segurança de thread
- Arquitetura: Injeção de dependência, interfaces melhores, design modular
Usar ações do Copilot
Use as ações do Copilot no menu de contexto para acessar rapidamente prompts pré-configurados e comandos de barra para tarefas comuns de desenvolvimento.
O comportamento de cada ação depende se você seleciona o código ao abrir o menu de contexto:
| Ação | Com o código selecionado | Sem código selecionado |
|---|---|---|
| Explicar | Explica o código selecionado | Explica o código próximo à posição do cursor |
| Otimizar Seleção | Otimiza o código selecionado para desempenho, manutenção, confiabilidade e arquitetura | Não aplicável |
| Gerar comentários | Gera comentários para o código selecionado | Gerar comentários para código próximo à posição do cursor |
| Gerar testes | Gera testes para o código selecionado | Gerar testes para código próximo à posição do cursor |
| Adicionar ao Chat | Adiciona o código selecionado ao Chat como referência | Adicionar o arquivo inteiro ao Chat como referência |
Quando você seleciona qualquer ação, exceto Otimizar Seleção, a janela de chat é aberta automaticamente e envia um comando de barra para Copilot com o contexto de escopo apropriado. Em seguida, você pode examinar e interagir com a resposta do Copilot na janela de chat.
Usar a opção Otimizar Seleção para obter um código melhor
Selecione uma seção específica do código e escolha Otimizar Seleção para que o Copilot analise e melhore apenas essa seção, em vez de um arquivo inteiro.
Copilot examina o código selecionado e seu contexto ao redor para fornecer sugestões significativas e com reconhecimento de contexto. A otimização preserva seu estilo de código, estrutura e funcionalidade existentes, mantendo sua base de código organizada e consistente. Ao contrário de outras ações que usam o painel de chat, Otimizar Seleção apresenta sugestões como uma diferença inline que você pode analisar, aceitar ou rejeitar diretamente.
O Copilot fornece sugestões de otimização entre estas áreas:
- Desempenho: Algoritmos mais rápidos, uso reduzido de memória, padrões assíncronos
- Manutenibilidade: Lógica simplificada, estrutura mais clara, melhor nomenclatura
- Fiabilidade: Tratamento de erros, limpeza de recursos, segurança de thread
- Arquitetura: Injeção de dependência, interfaces melhores, design modular