Melhores práticas para usar agentes
Agentes do Buildprint seguem a mesma regra básica de outros agentes de IA: entra lixo, sai lixo.
Quanto mais claros forem a tarefa, o contexto, o branch e os critérios de sucesso, melhor será o resultado. Prompts vagos costumam produzir resultados vagos.
Entra lixo, sai lixo
Reserve um tempo para instruir o agente de forma eficaz. Use o recurso de voz para gravar seus pensamentos se digitar demorar muito. Se você espera bons resultados, deve garantir que seus prompts tenham instruções claras e critérios de sucesso definidos.
Antes de pedir a um agente para trabalhar, defina:
O branch (a edição no Buildprint deve ser feita em branches diferentes)
A página, elemento reutilizável, workflow, tipo de dado ou configuração envolvida.
O comportamento esperado.
O problema atual.
Quaisquer restrições ou casos extremos.
Se o agente deve planejar primeiro ou começar a construir.
Critérios de sucesso claros
Um bom prompt pode ser assim:
No branch de teste, atualize a página de inscrição para que os usuários vejam um erro mais claro quando o código de convite for inválido. Inspecione o workflow atual primeiro e, em seguida, explique seu plano antes de editar.
Mantenha as tarefas focadas
Agentes funcionam melhor em tarefas pequenas e delimitadas.
Evite combinar trabalhos não relacionados em um único chat. Por exemplo, não peça ao mesmo agente para redesenhar uma página, corrigir um workflow de pagamento, atualizar regras de privacidade de dados e escrever notas de lançamento em uma única tarefa.
Divida trabalhos maiores em etapas separadas:
Investigue o comportamento atual.
Proponha a mudança.
Faça a mudança.
Teste o resultado (ou use
/testpara fazer o Buildprint testar seu próprio trabalho)Revise antes de fazer o merge ou o deploy.
Use o modo Plan antes de tarefas arriscadas
Use o modo Plan quando a tarefa for grande, incerta ou arriscada.
Peça ao agente para inspecionar o app, explicar sua abordagem e identificar qualquer coisa que possa quebrar. Mude para o modo Build apenas quando o plano for específico o suficiente para ser revisado.
Use o modo Build quando estiver pronto para o agente editar o branch selecionado.
Reinicie quando o agente ficar confuso
Se o agente começar a entender a tarefa errado, se repetir ou entrar em círculos, inicie um novo chat.
Não continue adicionando correções a uma conversa confusa esperando que ela se recupere. Isso geralmente piora o contexto.
Comece novamente com:
Um resumo curto do objetivo.
O branch a ser usado.
O que já foi tentado.
O que deve ser ignorado.
O próximo passo exato que você deseja.
Teste antes de fazer o merge
Sempre teste as mudanças do agente em um branch de desenvolvimento antes de fazer o merge ou o deploy, ou peça ao Buildprint para fazer isso por você usando /test.
Revise mudanças importantes
Use as revisões do Buildprint para mudanças que afetam:
Privacidade.
Permissões.
Estrutura de dados.
Workflows de backend.
Pagamentos.
Chamadas do API Connector.
Branches que você planeja fazer merge.
Qualquer coisa da qual os usuários dependam em produção.
Mudanças geradas por IA devem ser revisadas como código. Trate o agente como um assistente rápido, não como uma autoridade.
Seja explícito sobre o que não mudar
Se parte do app deve permanecer intocada, diga isso.
Por exemplo:
Atualize apenas o e-mail de confirmação de checkout. Não altere o workflow de pagamento, chamadas da API do Stripe ou a UI da página de checkout.
Isso reduz edições acidentais e ajuda o agente a manter o trabalho delimitado.
Prefira resultados verificáveis
Peça por resultados que possam ser verificados.
Em vez de:
Melhore o onboarding.
Use:
No branch de teste, atualize o workflow de onboarding para que novos usuários sejam redirecionados para /setup após a verificação do e-mail. Confirme a condição do workflow e teste o redirecionamento no Preview.
Resultados verificáveis facilitam para o agente testar seu trabalho e facilitam para você revisá-lo.