Saltar para o conteúdo principal

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 começam com o resultado que você quer. Guie o Agent com solicitações claras e simples, e você irá de ideia a aplicativo mais rapidamente.

​
Exemplos rápidos

Veja a diferença entre prompts vagos e eficazes:
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.
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.
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.
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.
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.

​
Princípios fundamentais

Dez dicas para prompts eficazes com o Replit Agent

​
Planeje primeiro

Antes de criar um prompt, decida como é o sucesso. Um plano simples leva a prompts melhores.
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 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].”
Inicie um novo chat ao mudar para tarefas não relacionadas. Isso evita confusão por contexto acumulado.

​
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

Mude para o modo Planejamento para explorar opções antes de construir. Pergunte ao Agent sobre bibliotecas, abordagens e trade-offs.
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.