Atoms
Project chat

Guia de Prompt

Decida antes de digitar, construa em partes, use conteúdo real e coloque cada solicitação diante do agente certo. Esses hábitos transformam ideias de uma linha em resultados finalizados.

Decida antes de digitar, construa em partes, use conteúdo real e coloque cada solicitação diante do agente certo. Esses hábitos transformam ideias de uma linha em resultados finalizados.

Comece no chat do projeto. Abra o chat do projeto que você quer alterar e, em seguida, escolha ou direcione a solicitação ao agente cuja função corresponda ao trabalho. Se você não tiver certeza de qual agente é o mais adequado, peça à equipe que esclareça antes de começar a construir.

Este guia reúne as técnicas que consistentemente geram melhores resultados da sua equipe de agentes. Nenhuma delas exige habilidade especial. Elas dizem respeito ao que você diz, não a como você formata. Esteja você escrevendo sua primeira solicitação ou refinando um projeto maduro, os mesmos princípios se aplicam: pensamento claro entra, resultados claros saem.

Deixe a equipe perguntar antes de construir

Uma das maneiras mais eficazes de obter um resultado melhor: quando uma solicitação é grande ou vaga, convide perguntas em vez de esperar que a equipe adivinhe corretamente. Diga o que você quer e depois adicione uma linha no final:

Pergunte tudo o que você precisar para entender completamente o que eu quero antes de começar.

Muitas vezes você receberá perguntas que não teria pensado em responder por conta própria, seja sobre casos extremos, públicos ou trade-offs. Resolver isso logo no início custa um minuto; descobrir depois da construção custa retrabalho. O resultado fica muito mais próximo da sua intenção já na primeira tentativa.

Etapa 1: Decida antes de digitar

Saiba o que você está construindo

Alguns minutos de reflexão no início podem economizar muito retrabalho com prompts depois. Antes de começar, certifique-se de que consegue responder a quatro perguntas simples: o que você está construindo, para quem é, por que essa pessoa usaria isso e qual é a principal ação que você quer que ela realize.

Essa ação principal costuma ser chamada de CTA, sigla para call to action. É o botão, link ou próximo passo que você mais quer que os usuários escolham, como Cadastre-se, Agende uma Demo, Comece Grátis ou Compre Agora.

Você não precisa escrever uma especificação completa. O objetivo é simplesmente dar ao projeto uma direção clara. Quanto mais específico for o seu ponto de partida, mais fácil será gerar um resultado que corresponda ao que você tem em mente.

Crie um site de uma página para um app de orçamento voltado para freelancers. O CTA principal é “Comece a Economizar com Mais Inteligência.” Use um visual ousado e expressivo, com tipografia grande e cores vibrantes.

Esboce a jornada, não apenas as telas

Um bom design vive tanto entre as telas quanto nelas. Percorra o caminho que seu usuário segue: o que ele vê primeiro, o que gera confiança, o que lhe dá segurança para agir e aonde essa ação leva? Mesmo um esboço de três etapas — hero, prova, call to action — torna suas solicitações dramaticamente mais eficazes, porque agora cada seção tem um motivo para existir e um motivo para levar à próxima.

Defina a direção visual cedo

É muito mais fácil estabelecer o estilo do que adaptá-lo depois. Escolha uma direção: calma e elegante, ousada e disruptiva, premium e sofisticada, e declare isso na sua primeira solicitação usando palavras de tom que a equipe possa aplicar: minimalista, lúdico, cinematográfico, focado em desenvolvedores. Essas palavras são mais do que decoração: elas moldam tipografia, espaçamento, cor, sombra e raio dos cantos desde o primeiro componente. Reutilize a mesma linha de estilo em solicitações posteriores para manter tudo coeso.

Use um design calmo, inspirado em bem-estar: gradientes suaves, tons terrosos discretos, cantos arredondados, espaçamento interno generoso. Tom geral gentil e tranquilizador.

Etapa 2: Escreva solicitações que funcionam

Descreva resultados, não implementações

Descreva o resultado que você quer, não as etapas para construí-lo. Por exemplo, “Adicione uma seção de preços com três opções e faça a do meio se destacar” é mais útil do que explicar exatamente como a página deve ser construída. Foque no que deve aparecer e por que isso importa; a equipe pode decidir como construir.

Trabalhe em partes, não em páginas

Solicitações com escopo de um único componente — um hero, uma grade de recursos, uma linha de depoimentos, uma tabela de preços — dão clareza e controle. Se uma parte não atingir o objetivo, você ajusta essa parte em vez de regenerar tudo ao redor. Construa um bloco, revise, refine e depois passe para o próximo. Uma solicitação de página inteira produz ruído; uma solicitação de componente produz sinal.

Crie uma seção de recursos: título centralizado e, em seguida, três cards lado a lado, cada um com um ícone, um título e uma linha de descrição. Sombras suaves, leve elevação no hover.

Use palavras reais

Texto de placeholder esconde problemas; texto real os revela. Um título real pode precisar de duas linhas; um CTA real pode funcionar melhor como verbo. Escreva o que um usuário realmente leria, mesmo que seja um rascunho; layouts, espaçamento e decisões de design melhoram quando o conteúdo é real.

Título do hero: “Projete com Calma.” Subtexto: “Transforme estresse em estrutura.” CTA: “Comece a Construir Grátis.” Layout centrado no texto com espaçamento vertical generoso.

Dê nome aos elementos reais

Use palavras claras e específicas para descrever o que você quer na página. Você não precisa conhecer terminologia de design — basta nomear as coisas que os usuários devem ver ou com as quais devem interagir, como um card de perfil, um botão ou um formulário.

Solicitações específicas são mais fáceis de construir do que solicitações amplas. Comece com o elemento básico de que você precisa e depois adicione detalhes um de cada vez.

Crie um card de perfil com foto, nome e botão de seguir. Adicione um pequeno rótulo “Verificado” ao lado do nome e mostre uma breve explicação quando alguém passar o mouse sobre ele.

Etapa 3: Altere com precisão

Defina o escopo de cada alteração: o que muda, o que fica

Ao ajustar um trabalho existente, seja explícito dos dois lados: o que deve mudar e o que não pode mudar. Use palavras de direção como “substitua”, “atualize” e “ajuste” em vez de “melhore isso”, e delimite as partes de que você gosta. A precisão aqui é o que impede que a iteração se torne regressão.

Altere o texto do CTA para “Começar” e aumente seu padding horizontal. Mantenha as cores atuais, a fonte e todo o restante desta seção inalterados.

Uma alteração significativa por vez

Atualize o texto, depois o layout, depois as interações, e verifique cada resultado antes da próxima solicitação. Pequenos passos deliberados se acumulam em um produto refinado; dez alterações em uma mensagem se acumulam em ambiguidade e, quando algo dá errado, você não saberá qual alteração causou isso.

As correções durante a tarefa acontecem no chat. Quando a fila de Prompts estiver disponível no seu chat e o trabalho do Agente estiver ativo, as mensagens de acompanhamento entram na fila atrás do trabalho em execução. Confirme que sua mensagem aparece na fila antes de enviar outra cópia. Se os controles da fila não estiverem visíveis, não reenvie: espere o trabalho atual terminar ou use um controle de interrupção, se o seu chat oferecer um, e então confirme o status da tarefa antes de enviar uma mensagem de acompanhamento. Veja chat do projeto para mais detalhes.

Pense um passo à frente da UI

Se o seu projeto precisa fazer mais do que parecer refinado, defina o comportamento junto com a aparência. Especifique o que os usuários veem quando estão conectados ou desconectados, de onde vem o conteúdo dinâmico e como a interface lida com estados vazios, de carregamento e de erro. Você não precisa de um backend funcional para projetar em torno desses cenários — planejar isso cedo ajuda a evitar grandes retrabalhos de UI depois.

Se o usuário estiver conectado, mostre seu avatar e nome no canto superior direito. Caso contrário, mostre um botão “Entrar” que direcione para a tela de autenticação.

Perguntas frequentes

Como escrevo um prompt eficaz para o agente de IA?

Estruture seu prompt com estes elementos principais:

1. Contexto — Defina o cenário. Explique o que você está construindo e em que ponto as coisas estão atualmente.

2. Objetivo — Seja específico sobre o resultado exato ou recurso que você deseja.

3. Requisitos & Restrições — Liste claramente o que deve mudar e o que deve permanecer intocado.

4. Resultado Esperado — Defina como é o sucesso (por exemplo, comportamento da UI, tratamento de erros, persistência de estado).

5. Referências — Anexe capturas de tela, links, etapas do fluxo de trabalho ou exemplos de código sempre que possível. Remova senhas, códigos de verificação, chaves de API, cookies, dados pessoais e detalhes de pagamento antes de compartilhar.

Exemplo: "Estou construindo um dashboard com uma barra lateral. Adicione um botão de logout na parte inferior da barra lateral. Ele deve limpar a sessão e redirecionar para /login. Não altere o layout da barra lateral nem os links de navegação. Após clicar, o usuário deve ver a página de login em até 1 segundo."

Como devo lidar com solicitações complexas que envolvem vários recursos?

Para solicitações complexas, divida-as em tarefas menores:

1. Informe o problema atual e o objetivo final.

2. Liste cada subtarefa separadamente (tarefa 1, tarefa 2, tarefa 3).

3. Verifique cada tarefa antes de passar para a próxima.

4. Teste o fluxo completo ao final.

Essa abordagem reduz alterações inesperadas ao pedir que o Agente faça coisas demais de uma só vez. Cada prompt deve se concentrar em um único resultado verificável.

Como escrevo um prompt para corrigir um bug?

Um prompt útil para correção de bug deve incluir:

  • A página, o recurso, o ambiente e os usuários afetados
  • Etapas exatas para reproduzir o problema
  • Comportamento atual e comportamento esperado
  • O texto completo do erro e quando ele ocorreu
  • Capturas de tela ou logs relevantes, com senhas, tokens, cookies, dados pessoais e detalhes de pagamento removidos
  • O que deve permanecer inalterado
  • Como verificar a correção e quais verificações de regressão executar

Exemplo: “Na página de checkout em Preview, selecionar Enviar retorna um erro 500. Esperado: o pedido é confirmado e o usuário chega à página de agradecimento. Reprodução: [etapas]. Corrija a causa sem alterar os totais do carrinho nem o fluxo de pagamento e, em seguida, verifique um caso de pagamento bem-sucedido e um de pagamento recusado. Removi todos os valores secretos do log anexado.”

Como escrevo um prompt para modificar o layout ou o estilo da página?

Ao solicitar modificações na página, inclua:

1. A página, o módulo e o elemento específicos a serem modificados.

2. Estado atual e resultado desejado.

3. Links de referência ou capturas de tela.

4. Recursos que devem permanecer inalterados.

5. Critérios de aceitação (por exemplo, deve funcionar tanto em desktop quanto em mobile).

Exemplo: "Na página /pricing, altere a grade de cards de planos de 2 colunas para 3 colunas no desktop. Mantenha o layout mobile como uma única coluna. Use esta captura de tela como referência [anexar]. Não altere o conteúdo dos cards nem os estilos dos botões."

O que devo fazer quando o agente continua fazendo as alterações erradas apesar das correções?

Quando o Agente erra repetidamente, adicionar mais instruções às vezes pode causar ainda mais confusão. Em vez disso:

1. Preserve o estado atual — Pare de enviar correções sobrepostas. Se o seu chat mostrar um controle de Reverter, leia o texto de confirmação antes de usá-lo, anote quaisquer alterações posteriores que você precise manter e verifique o projeto depois. Se o escopo não estiver claro, não continue; use as orientações do chat do projeto ou entre em contato com o Suporte com um link do chat com informações sensíveis removidas e uma captura de tela.

2. Elimine o ruído — Em vez de adicionar instruções extras por cima, reafirme claramente o problema central do zero.

3. Uma tarefa por vez — Foque em corrigir um único problema antes de seguir em frente.

Dar um passo atrás e lidar com as alterações de forma incremental geralmente resolve os problemas muito mais rápido do que tentar corrigir vários problemas sobrepostos em um único prompt.

Esta página foi útil?

Artigos relacionados