Suas primeiras instruções personalizadas

Sobre personalizações

Você pode personalizar as respostas do GitHub Copilot usando dois tipos de arquivos:

• As instruções personalizadas fornecem diretrizes contínuas para o GitHub Copilot se comportar em todas as suas interações.
• Os arquivos de prompt (visualização pública) definem prompts reutilizáveis para tarefas específicas que você pode invocar quando necessário. Arquivos de prompt estão disponíveis somente no VS Code. Para obter um exemplo introdutório, consulte Seu primeiro arquivo de prompt.

Embora instruções personalizadas ajudem a adicionar contexto a cada fluxo de trabalho de IA, os arquivos de prompt permitem adicionar instruções a uma interação de chat específica.

As instruções personalizadas do repositório são as mais comumente usadas e aceitas, mas você também pode definir instruções personalizadas pessoais e da organização, somente para Chat do GitHub Copilot no GitHub. Você pode criar instruções personalizadas do repositório de duas maneiras:

• Instruções em todo o repositório: crie um único arquivo copilot-instructions.md na raiz do repositório que se aplica a todos os arquivos no repositório.
• Instruções específicas do caminho: crie um ou mais arquivos .instructions.md com um campo applyTo que se aplique apenas a arquivos ou diretórios específicos. No momento, há suporte para instruções específicas de caminho para Copilot Chat no agente de codificação do Visual Studio Code e do GitHub Copilot.

Suas primeiras instruções

Comece com essas instruções personalizadas básicas que ajudam o GitHub Copilot a entender suas preferências de codificação.

Instruções para escrever funções

When writing functions, always:
- Add descriptive JSDoc comments
- Include input validation
- Use early returns for error conditions
- Add meaningful variable names
- Include at least one example usage in comments

When writing functions, always:
- Add descriptive JSDoc comments
- Include input validation
- Use early returns for error conditions
- Add meaningful variable names
- Include at least one example usage in comments

Essas instruções alterarão como o GitHub Copilot gera funções.

Teste-o

Para testar rapidamente a diferença que as instruções personalizadas podem fazer, use instruções personalizadas pessoais na exibição imersiva do Copilot Chat.

1. Primeiro, acesse o github.com/copilot e insira este prompt:

   Create a JavaScript function that calculates the area of a circle

   Sem instruções personalizadas, você obtém:

   function areaOfCircle(radius) {
       if (typeof radius !== 'number' || radius < 0) {
           throw new Error('Radius must be a non-negative number');
       }
       return Math.PI * radius * radius;
   }
   

2. Agora, acesse suas instruções personalizadas pessoais clicando na sua imagem de perfil na parte inferior esquerda da página e, em seguida, clique em Instruções pessoais. Cole as instruções acima na caixa de texto e clique em Salvar.

   Agora, insira o mesmo prompt que você inseriu anteriormente.

   Com instruções personalizadas, você obterá algo como:

   /**
    * Calculates the area of a circle given its radius.
    *
    * @param {number} radius - The radius of the circle. Must be a positive number.
    * @returns {number|null} The area of the circle, or null if the input is invalid.
    *
    * @example
    * // returns 78.53981633974483
    * areaOfCircle(5);
    *
    * @example
    * // returns null (invalid input)
    * areaOfCircle(-2);
    */
   function areaOfCircle(radius) {
     if (typeof radius !== "number" || isNaN(radius) || radius <= 0) {
       // Invalid input: radius must be a positive number
       return null;
     }
   
     const area = Math.PI * Math.pow(radius, 2);
     return area;
   }
   
   // Example usage:
   console.log(areaOfCircle(5));   // 78.53981633974483
   console.log(areaOfCircle(-2));  // null
   

Leitura adicional

• Sobre como personalizar as respostas do GitHub Copilot Chat – Visão geral da personalização de resposta no GitHub Copilot
• Configurar instruções personalizadas no GitHub Copilot: como configurar instruções personalizadas
• Personalizações incríveis do GitHub Copilot – repositório de instruções personalizadas com a contribuição da comunidade e outras personalizações para linguagens e cenários específicos