Práticas recomendadas
O Agent oferece resultados melhores quando você fornece um objetivo claro, contexto útil e um resultado que possa ser verificado.
Escreva uma solicitação clara
Diga ao Agent o que deve mudar, onde a mudança deve ocorrer e como é um resultado correto.
Inclua os detalhes que afetam o trabalho:
A página, o elemento reutilizável, o workflow, o tipo de dado ou a configuração envolvidos.
O comportamento atual e o comportamento desejado.
A ramificação do Bubble a ser usada.
Limites ou casos importantes que o Agent precisa tratar.
Tudo o que o Agent não deve alterar.
Uma solicitação útil seria assim:
Na ramificação de teste, atualize a página de cadastro para que os usuários vejam um erro quando o código de convite for inválido. Primeiro, inspecione o workflow atual. Não altere o workflow de login.
Peça um resultado que você possa verificar
Um resultado específico é mais fácil para o Agent desenvolver e para você revisar.
Evite:
Melhorar a integração de novos usuários.
Use:
Na ramificação de teste, redirecione os novos usuários para a página de configuração depois que verificarem o e-mail. Mantenha os usuários que retornam no painel. Teste os dois caminhos no Preview.
Mantenha o foco na tarefa
O Agent funciona melhor em uma única parte relacionada do trabalho por vez.
Não combine alterações sem relação, como reformular o design de uma página, alterar pagamentos e atualizar regras de privacidade, em uma única solicitação.
Para um recurso maior, use etapas claras:
Peça ao Agent para inspecionar o app atual.
Revise o plano dele.
Deixe o Agent fazer a alteração em uma ramificação de desenvolvimento.
Peça ao Agent para testar o resultado.
Revise o trabalho antes de fazer merge ou implantar.
Use o Plan antes do Build
Comece no modo Plan quando a tarefa for grande, pouco clara ou arriscada.
Peça ao Agent para explicar o comportamento atual, propor uma abordagem e identificar o que pode dar errado. Mude para o Build quando o plano estiver específico o suficiente para prosseguir.
Forneça o contexto adequado ao Agent
Anexe informações que o Agent não consegue obter do próprio projeto do Bubble. Opcionalmente, conecte um MCP personalizado na página Integrações para permitir que o Buildprint acesse essas informações por conta própria.
Isso pode incluir um design, uma mensagem de erro, um relato de cliente, uma especificação ou dados de exemplo. Use uma Skill quando quiser que o Agent siga as mesmas instruções em várias tarefas.
Não adicione arquivos sem relação ou anotações longas de contexto. Mais contexto só é útil quando afeta a tarefa.
Revise e teste o resultado
Não considere uma interação concluída do Agent como prova de que a alteração está correta.
Leia o resumo do que foi alterado.
Verifique as páginas e os workflows afetados no Bubble.
Teste o caminho normal e os caminhos de falha importantes.
Revise com atenção redobrada as alterações que envolvam privacidade, permissões, pagamentos, autenticação, APIs ou estrutura de dados.
Comece novamente quando o contexto estiver confuso
Inicie uma nova conversa se o Agent não entender a tarefa, repetir o que já fez ou misturar trabalhos sem relação.
Na nova conversa, inclua o objetivo, a ramificação, o trabalho anterior relevante e a próxima etapa exata. Um resumo claro geralmente é melhor do que adicionar mais correções a uma conversa confusa.