{"meta":{"title":"Suas primeiras instruções personalizadas","intro":"Crie e teste sua primeira instrução personalizada com este exemplo simples.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/tutorials","title":"Tutoriais"},{"href":"/pt/copilot/tutorials/customization-library","title":"Biblioteca de personalização"},{"href":"/pt/copilot/tutorials/customization-library/custom-instructions","title":"Instruções personalizadas"},{"href":"/pt/copilot/tutorials/customization-library/custom-instructions/your-first-custom-instructions","title":"Suas primeiras instruções personalizadas"}],"documentType":"article"},"body":"# Suas primeiras instruções personalizadas\n\nCrie e teste sua primeira instrução personalizada com este exemplo simples.\n\n> \\[!NOTE]\n>\n> * Os exemplos nesta biblioteca são para servir de inspiração. Ajuste-os para serem mais específicos para seus projetos, linguagens e processos de equipe.\n> * Para exemplos de instruções personalizadas com contribuição da comunidade para linguagens e cenários específicos, confira o repositório de [Personalizações Incríveis do GitHub Copilot](https://github.com/github/awesome-copilot/blob/main/docs/README.instructions.md).\n> * Você pode aplicar instruções personalizadas em diferentes escopos, dependendo da plataforma ou do IDE em que você está criando. Para obter mais informações, confira \"[Sobre a personalização das respostas do GitHub Copilot](/pt/copilot/concepts/prompting/response-customization)\".\n\n## Sobre personalizações\n\nVocê pode personalizar as respostas do GitHub Copilot usando dois tipos de arquivos:\n\n* As **instruções personalizadas** fornecem diretrizes contínuas para o GitHub Copilot se comportar em todas as suas interações.\n* **Os arquivos de prompt (visualização pública)** definem prompts reutilizáveis para tarefas específicas que você pode invocar quando necessário. Os arquivos de prompt só estão disponíveis em VS Code, Visual Studio e IDEs JetBrains. Para um exemplo introdutório, veja [Seu primeiro arquivo de prompt](/pt/copilot/tutorials/customization-library/prompt-files/your-first-prompt-file).\n\nEmbora 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.\n\nAs 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 GitHub Copilot Chat in GitHub. Você pode criar instruções personalizadas do repositório de duas maneiras:\n\n* **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.\n* **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 do caminho em **Copilot Chat**, Visual Studio Code, Visual Studio e **Copilot cloud agent**.\n\n## Suas primeiras instruções\n\nComece com essas instruções personalizadas básicas que ajudam o GitHub Copilot a entender suas preferências de codificação.\n\n### Instruções para escrever funções\n\n```markdown copy\nWhen writing functions, always:\n- Add descriptive JSDoc comments\n- Include input validation\n- Use early returns for error conditions\n- Add meaningful variable names\n- Include at least one example usage in comments\n```\n\nEssas instruções alterarão como o GitHub Copilot gera funções.\n\n## Teste-o\n\nPara testar rapidamente a diferença que as instruções personalizadas podem fazer, você pode usar instruções personalizadas pessoais em Copilot Chat.\n\n1. Primeiro, vá para [github.com/copilot](https://github.com/copilot?ref_product=copilot\\&ref_type=trial\\&ref_style=text) e insira este prompt:\n\n   `Create a JavaScript function that calculates the area of a circle`\n\n**Sem instruções personalizadas**, você obtém:\n\n````\n```javascript\nfunction areaOfCircle(radius) {\n    if (typeof radius !== 'number' || radius < 0) {\n        throw new Error('Radius must be a non-negative number');\n    }\n    return Math.PI * radius * radius;\n}\n```\n````\n\n1. Agora acesse suas instruções personalizadas clicando na sua imagem de perfil no canto inferior esquerdo da página e, em seguida, clique em **Instruções pessoais**. Cole as instruções acima na caixa de texto e clique em **Salvar**.\n\n   Agora, insira o mesmo prompt que você inseriu anteriormente.\n\n**Com instruções personalizadas**, você obterá algo como:\n\n````\n```javascript\n/**\n * Calculates the area of a circle given its radius.\n * * @param {number} radius - The radius of the circle. Must be a positive number.\n * @returns {number|null} The area of the circle, or null if the input is invalid.\n * * @example\n * // returns 78.53981633974483\n * areaOfCircle(5);\n * * @example\n * // returns null (invalid input)\n * areaOfCircle(-2);\n */\nfunction areaOfCircle(radius) {\n  if (typeof radius !== \"number\" || isNaN(radius) || radius <= 0) {\n    // Invalid input: radius must be a positive number\n    return null;\n  }\n\n  const area = Math.PI * Math.pow(radius, 2);\n  return area;\n}\n\n// Example usage:\nconsole.log(areaOfCircle(5));   // 78.53981633974483\nconsole.log(areaOfCircle(-2));  // null\n```\n````\n\n## Leitura adicional\n\n* [Sobre a personalização das respostas do GitHub Copilot](/pt/copilot/concepts/prompting/response-customization) – Visão geral da personalização de resposta no GitHub Copilot\n* [Adicionar instruções personalizadas para Copilot](/pt/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions): como configurar instruções personalizadas\n* [Personalizações incríveis do GitHub Copilot](https://github.com/github/awesome-copilot/blob/main/README.md) – repositório de instruções personalizadas com a contribuição da comunidade e outras personalizações para linguagens e cenários específicos"}