> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prompts Eficazes

> Aprenda princípios e veja exemplos para escrever prompts eficazes ao usar o Replit Agent.

export const YouTubeEmbed = ({videoId, title = "YouTube video", startAt}) => {
  if (!videoId) {
    return null;
  }
  let url = "https://www.youtube.com/embed/" + videoId;
  if (startAt) {
    url = url + "?start=" + startAt;
  }
  return <Frame>
      <iframe src={url} title={title} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen></iframe>
    </Frame>;
};

Prompts eficazes começam com o resultado que você quer. Guie o [**Agent**](/core-concepts/agent) com solicitações claras e simples, e você irá de ideia a aplicativo mais rapidamente.

<YouTubeEmbed videoId="7m5SjKZBw6I" title="10 tips for better vibe coding" />

## Exemplos rápidos

Veja a diferença entre prompts vagos e eficazes:

<AccordionGroup>
  <Accordion title="Corrigir código" icon="bug">
    **Vago:** "Corrija meu código."

    **Eficaz:** "O formulário de login falha mesmo com a senha correta. Corrija o fluxo de login."

    Comece com o resultado quebrado. Depois adicione o erro ou arquivo se o Agent precisar de mais contexto.
  </Accordion>

  <Accordion title="Construir funcionalidades" icon="hammer">
    **Vago:** "Crie um site."

    **Eficaz:** "Construa um site de portfólio simples com páginas Início, Sobre e Contato."

    Foque no resultado que você quer, mais os poucos detalhes que mais importam.
  </Accordion>

  <Accordion title="Melhorias de desempenho" icon="gauge-high">
    **Vago:** "Não deixe lento."

    **Eficaz:** "Faça o dashboard carregar mais rápido quando há muitos pedidos."

    Descreva a melhoria que você quer. Deixe o Agent escolher a implementação, a menos que você tenha uma preferência forte.
  </Accordion>

  <Accordion title="Alterações de UI" icon="paintbrush">
    **Vago:** "Adicione animação."

    **Eficaz:** "Adicione um fade-in sutil na imagem hero quando a página carregar."

    Nomeie a parte do aplicativo e o efeito que você quer.
  </Accordion>

  <Accordion title="Sistemas complexos" icon="server">
    **Vago:** "Construa o backend."

    **Eficaz:** "Adicione login, perfis e uma forma de as pessoas salvarem seu progresso."

    Peça o resultado do produto primeiro. Adicione detalhes técnicos apenas se forem importantes.
  </Accordion>
</AccordionGroup>

## Princípios fundamentais

<Frame>
  <img src="https://mintcdn.com/replit/0ixNWaRF232g0Gwn/images/tutorials/10-tips.png?fit=max&auto=format&n=0ixNWaRF232g0Gwn&q=85&s=21e1e7269802faa767fef0187bdb6e3d" alt="Dez dicas para prompts eficazes com o Replit Agent" width="1259" height="1101" data-path="images/tutorials/10-tips.png" />
</Frame>

### Planeje primeiro

<Tip>Antes de criar um prompt, decida como é o sucesso. Um plano simples leva a prompts melhores.</Tip>

Escreva o resultado principal, depois os próximos marcos.

**Em vez de:** "Construa um aplicativo de gerenciamento de tarefas."

**Tente:** "Construa um gerenciador de tarefas simples onde eu possa adicionar, concluir e excluir tarefas."

Depois use prompts de acompanhamento para refiná-lo.

### Construa incrementalmente

Os [**Checkpoints**](/core-concepts/agent/checkpoints-and-rollbacks) acontecem automaticamente enquanto o Agent trabalha. Se algo quebrar, você pode reverter e tentar uma abordagem diferente.

**Em vez de:** "Construa uma plataforma completa de e-commerce."

**Tente:** "Comece com uma loja online simples com login e páginas de produtos." Depois adicione carrinho, checkout e ferramentas administrativas em prompts de acompanhamento.

### Seja específico

Diga o que você quer que aconteça e inclua os detalhes que mudam o resultado.

**Em vez de:** "Adicione um formulário de contato."

**Tente:** "Adicione uma página de contato com campos de nome, e-mail e mensagem. Envie as submissões para meu e-mail."

### Use linguagem positiva

Declare o que você *quer*, não o que evitar.

**Em vez de:** "Não deixe a página de perfil do usuário confusa."

**Tente:** "Deixe a página de perfil limpa e fácil de visualizar. Mostre o nome, e-mail, data de adesão e um botão Editar perfil."

### Mantenha simples

Use linguagem curta e direta. Adicione detalhes de implementação apenas quando fizerem diferença.

**Em vez de:** "Implemente a infraestrutura server-side necessária para facilitar a geração dinâmica e recuperação de artefatos de conteúdo gerado por usuários."

**Tente:** "Deixe as pessoas escrever e publicar posts de blog."

## Trabalhando com contexto

### Forneça arquivos relevantes

Compartilhe apenas os arquivos ou referências que o Agent precisa.

**Em vez de:** (Anexar tudo) "Implemente a página de perfil do usuário com base no nosso design system."

**Tente:** "Crie a página de perfil do usuário e combine com este mockup: \[anexe `profile_mockup.jpg`]. Use as cores do nosso documento de design: \[URL]."

<Tip>Inicie um novo chat ao mudar para tarefas não relacionadas. Isso evita confusão por contexto acumulado.</Tip>

### Mostre exemplos

Reduza ambiguidade com exemplos, capturas de tela ou dados de amostra.

**Em vez de:** "Deixe os cartões de produto com uma aparência melhor."

**Tente:** "Deixe os cartões de produto como nesta captura de tela: imagem, nome, preço e um botão Adicionar ao carrinho."

## Depurando de forma eficaz

Quando algo quebrar, inclua:

* A mensagem de erro **exata**
* Trechos de código relevantes
* Nomes de arquivos onde o erro ocorre
* O que você estava tentando alcançar
* Passos que você já tentou

**Em vez de:** "Minha página de login está quebrada."

**Tente:** "A página de login mostra 'Usuário não encontrado' mesmo com credenciais válidas. Acontece em `/login`. Por favor, corrija."

## Peça orientação

<Tip>Mude para o modo Planejamento para explorar opções antes de construir. Pergunte ao Agent sobre bibliotecas, abordagens e trade-offs.</Tip>

**Em vez de:** "Adicione pagamentos."

**Tente:** "Qual é a forma mais simples de adicionar pagamentos com cartão de crédito ao meu aplicativo no Replit?"

## Itere nos seus prompts

Seu primeiro prompt pode não ser perfeito. Se o resultado não for o certo:

* Adicione mais detalhes
* Forneça um exemplo
* Simplifique a instrução
* Tente uma forma diferente de explicar

**Inicial:** "Adicione um cabeçalho ao meu site."

**Refinado:** "Crie um componente de cabeçalho fixo com o logotipo do site à esquerda e links de navegação (Início, Sobre, Contato) à direita."

## Resumo

Prompts eficazes se resumem a:

* **Planejar** antes de criar o prompt
* **Construir** incrementalmente — checkpoints acontecem automaticamente enquanto o Agent trabalha
* **Descrever resultados** claramente
* **Fornecer contexto** por meio de exemplos e arquivos relevantes
* **Iterar** quando os resultados não estão completamente certos

Mantenha os prompts curtos, focados em resultados e fáceis de seguir, e você construirá mais rápido com o Agent.