Personalize as respostas do chat e defina o contexto

Você pode pedir ao GitHub Copilot Chat para fornecer sugestões de código, explicar código, gerar testes de unidade e sugerir correções de código. O bate-papo no Visual Studio pode fornecer respostas e gerar código que corresponda às suas práticas de codificação e 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.

Neste artigo, você aprende como obter melhores respostas fornecendo mais informações ao Copilot Chat:

• Use comandos de barra para especificar rapidamente tarefas comuns, como /explain obter explicações de código
• Use a experiência de bate-papo guiado para refinar o contexto
• Use instruções personalizadas e arquivos de prompt para personalizar as respostas

Saiba mais sobre desenvolvimento assistido por IA no Visual Studio e como usar o Copilot Chat no Visual Studio.

Pré-requisitos

Para começar a usar o GitHub Copilot Chat no Visual Studio, você precisa:

• Visual Studio 2022 versão 17.10 ou posterior
• Entre no Visual Studio usando uma conta do GitHub com acesso ao Copilot
  ^** Você pode se inscrever no GitHub Copilot gratuitamente.

O suporte para o GitHub Copilot Chat é fornecido pelo GitHub e pode ser acessado em https://support.github.com.

Orientação para Prompting

A experiência de bate-papo guiado no Visual Studio 17.12 e posterior ajuda a refinar seus prompts para esclarecer o contexto para melhores respostas. O GitHub Copilot Chat agora orienta você com perguntas esclarecedoras quando o contexto não está claro.

Use instruções personalizadas

O recurso de instruções personalizadas permite que você adicione automaticamente detalhes contextuais pré-especificados às suas perguntas de bate-papo. O Copilot Chat usa essas instruções adaptadas ao seu contexto específico, como a maneira como sua equipe trabalha, as ferramentas que você usa ou as especificidades do seu projeto, ao gerar respostas.

Use um arquivo .github/copilot-instructions.md

Para usar um .github/copilot-instructions.md arquivo:

1. Criar/adicionar um arquivo de instruções personalizado .github/copilot-instructions.md na raiz do repositório.

As instruções personalizadas não são visíveis na vista de Chat ou no chat em linha. No entanto, quando usado pelo Copilot, o arquivo.github/copilot-instructions.md é listado na lista Referências de uma resposta.

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íficos. 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:

1. Crie o .github/instructions diretório se ele ainda não existir.

2. Adicione um ou mais .github/instructions/*.instructions.md ficheiros.

3. Adicione a propriedade applyTo na seção "frontmatter" do arquivo de instruções. Use a sintaxe glob para especificar a quais arquivos ou pastas as instruções se aplicam.

4. Habilite o recurso no Visual Studio.

   No painel Ferramentas>Opções, expanda a seção Todas as Configurações>GitHub>Copilot>Copilot Chat e marque a caixa de seleção Habilitar instruções personalizadas a serem carregadas de arquivos .github/copilot-instructions.md e adicionadas às solicitações.

   Na caixa de diálogo Opções de Ferramentas>, expanda a seção GitHub Copilot>. No grupo Copilot Chat , marque a caixa de seleção Habilitar instruções personalizadas a serem carregadas de arquivos .github/copilot-instructions.md e adicionadas às solicitações .

Formato de ficheiro de instruções

Os arquivos de instruções direcionados usam a .instructions.md extensão e têm esta estrutura:

• Cabeçalho (opcional): YAML frontmatter
  • description: Descrição mostrada ao passar com o rato na visualização de chat
  • applyTo: Padrão de Glob que corresponde aos arquivos ou pastas aos quais você deseja que as instruções sejam aplicadas
• Corpo: Instruções em 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 em seu .github/instructions/*.instructions.md arquivo 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ções

Quando você começa a trabalhar com o Copilot, ele deteta automaticamente quais arquivos de instrução são relevantes para o seu contexto atual e os anexa como referências. Isso garante que as sugestões do Copilot estejam sempre alinhadas com as regras do seu projeto, não importa onde você esteja trabalhando em sua base de código.

Os arquivos de instruções usados pelo Copilot estão listados 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 freqüência.

Para criar um arquivo de prompt:

1. Escreve os teus prompts como farias normalmente na caixa de prompt, usando # referências para incluir informações específicas da tua solução, como métodos, classes e ficheiros. Você pode até mesmo fazer referência a outros arquivos de prompt para obter instruções compartilhadas.
2. Copiar o prompt num ficheiro markdown e guardá-lo com a extensão .prompt.md na pasta .github/prompts na raiz do teu repositório.

Para usar um arquivo de prompt:

1. Digite #prompt: na entrada de bate-papo para referenciar quaisquer arquivos de prompt da sua pasta .github/prompts, ou clique no ícone ➕ na entrada de bate-papo para adicioná-los como contexto.
2. Adicione quaisquer detalhes extras, ou simplesmente digite o prompt como está.

Usar comandos de barra para definir o contexto de tarefas comuns

Os comandos de barra no Copilot Chat ajudam você a definir rapidamente a intenção para tarefas comuns de desenvolvimento. Usando comandos de barra específicos para formar sua pergunta, você pode obter respostas melhores sem ter que escrever perguntas longas.

Você pode usar comandos de barra numa janela de bate-papo ou diretamente no código que deseja modificar, usando assistência de código inline . Os comandos que ajudam a modificar ou adicionar ao arquivo de código aberto no editor funcionam tanto no assistente de código embutido quanto nas janelas de bate-papo, enquanto os comandos para perguntas de codificação mais gerais funcionam apenas no painel de bate-papo.

Com o Visual Studio 2022 versão 17.13, à medida que o usuário digita um comando de barra, o comando expande o prompt em linguagem natural para exibir o contexto do comando.

Próximos passos

• experiência de copiloto do GitHub para Visual Studio
• Experiência de bate-papo do copiloto do GitHub para Visual Studio
• Central de Confiabilidade do Copilot do GitHub
• Envie-nos sugestões, comentários e problemas
• Suporte para o GitHub Copilot Chat
• Como usar o GitHub Copilot: prompts, dicas e casos de uso