# Seu primeiro arquivo de prompt

Crie seu primeiro arquivo de prompt do Copilot com este exemplo de explicação de código simples que funciona para qualquer linguagem de programação.

> \[!NOTE]
>
> * Os arquivos de prompt do Copilot estão no versão prévia pública e sujeitos a alterações. Os arquivos de prompt só estão disponíveis em VS Code, Visual Studio e IDEs JetBrains. Consulte [Sobre a personalização das respostas do GitHub Copilot](/pt/copilot/concepts/prompting/response-customization#about-prompt-files).
> * Para obter exemplos de arquivos de prompt com contribuição da comunidade para linguagens e cenários específicos, confira o repositório [Personalizações incríveis do GitHub Copilot](https://github.com/github/awesome-copilot/blob/main/docs/README.prompts.md).

## 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. Para obter um exemplo introdutório, consulte [AUTOTITLE](/copilot/tutorials/customization-library/custom-instructions/your-first-custom-instructions).
  ```
* **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.

## Seu primeiro arquivo de prompt

Comece com esse arquivo de prompt simples que ajuda você a escrever explicações de código claras e bem documentadas.

### Prompt de explicação de código

```text copy
---
agent: 'agent'
description: 'Generate a clear code explanation with examples'
---

Explain the following code in a clear, beginner-friendly way:

Code to explain: ${input:code:Paste your code here}
Target audience: ${input:audience:Who is this explanation for? (e.g., beginners, intermediate developers, etc.)}

Please provide:

* A brief overview of what the code does
* A step-by-step breakdown of the main parts
* Explanation of any key concepts or terminology
* A simple example showing how it works
* Common use cases or when you might use this approach

Use clear, simple language and avoid unnecessary jargon.
```

## Teste-o

1. Salve o arquivo de prompt acima como `explain-code.prompt.md` na pasta `.github/prompts`.

2. No Visual Studio Code, abra a exibição do Bate-papo do Copilot e insira `/explain-code`.

   Copilot alternará para o modo de agente, se ainda não estiver selecionado, e solicitará que você insira algum código e um tipo de público-alvo.

3. Digite:

   ```text copy
   The code is `function fibonacci(n) { return n <= 1 ? n : fibonacci(n-1) + fibonacci(n-2); }`. The audience is beginners.
   ```

## Leitura adicional

* [Usar arquivos de prompt no Visual Studio Code](https://code.visualstudio.com/docs/copilot/customization/prompt-files) na documentação do Visual Studio Code – Informações sobre como criar e usar arquivos de prompt
* [Sobre a personalização das respostas do GitHub Copilot](/pt/copilot/concepts/response-customization) – Visão geral da personalização de resposta no GitHub Copilot
* [Personalizações incríveis do GitHub Copilot](https://github.com/github/awesome-copilot/blob/main/docs/README.prompts.md) – repositório de arquivos de prompt personalizados com a contribuição da comunidade e outras personalizações para linguagens e cenários específicos