Solução de Problemas e Perguntas Frequentes
Problemas comuns que você pode encontrar ao usar agentes Buildprint e como resolvê-los.
O Buildprint não construiu o que eu queria
Se o agente fez alterações que não correspondem ao que você tinha em mente, a correção mais rápida é recomeçar com um prompt mais claro:
Restaure para o seu último savepoint para desfazer as alterações do agente.
Pense no que não estava claro — o prompt foi muito vago? Deixou margem para interpretação?
Inicie uma nova conversa com um prompt mais específico que descreva exatamente o que você deseja.
Tentar fazer com que o agente corrija os próprios erros na mesma conversa geralmente leva a mais problemas. Um novo começo com um prompt melhor é quase sempre mais eficaz.
O Buildprint criou problemas no editor
O Buildprint não consegue ver o verificador de problemas do Bubble, portanto, pode introduzir erros que desconhece. Para problemas pequenos e isolados, a correção mais fácil é corrigi-los você mesmo no editor do Bubble e pedir ao Buildprint para sincronizar novamente (resync) para que ele possa ver suas alterações.
Se os problemas forem significativos e abrangentes — afetando múltiplos fluxos de trabalho ou tipos de dados — é melhor restaurar para um savepoint e começar de novo com um prompt mais restrito. Tentar corrigir muitos problemas espalhados geralmente leva mais tempo do que apenas refazer o trabalho de forma limpa.
O Buildprint, como qualquer outro desenvolvedor humano, não é perfeito. Erros serão criados às vezes, e é por isso que é importante revisar o trabalho dele com cuidado.
O agente não consegue acessar as ferramentas MCP / usar o Buildprint / não consegue conectar
Estamos cientes de um bug que impede algumas sessões do Claude de se conectarem ao servidor Buildprint para realizar ações no seu app Bubble. Enquanto isso, você pode simplesmente iniciar uma nova conversa e tentar novamente.
O Buildprint não consegue ver minhas alterações
O Buildprint só consegue ver as alterações que ele mesmo faz. Se você fizer alterações diretamente no editor do Bubble na mesma branch em que o agente está trabalhando, ele não terá conhecimento delas.
Para corrigir isso, peça ao agente para fazer um resync. Isso diz a ele para atualizar a visão do app para que possa ver suas alterações manuais. Sem a sincronização, o agente pode sobrescrever seu trabalho ou tomar decisões com base em uma visão desatualizada do app.
O Buildprint para de rodar inesperadamente
Primeiro, tente novamente enviando uma mensagem de acompanhamento. Se ele falhar persistentemente em responder às consultas, inicie uma nova conversa, pois a conversa pode estar corrompida ou pode haver um problema com o provedor do modelo (ex: OpenAI/Anthropic). Você pode, opcionalmente, copiar o histórico da conversa para trazer seu contexto.
O Buildprint está lento
O Buildprint não foi projetado para ser algo que você fica sentado assistindo. O Buildprint foi desenhado para levar o tempo necessário para fazer o que é certo, e para que você possa tomar um café ou dar um passeio.
Alguns modelos são mais lentos que outros. Modelos Gemini são particularmente lentos quando o raciocínio está ativado.
Estamos trabalhando ativamente para acelerar a velocidade com que o Buildprint explora e edita seu app, especialmente para apps grandes, mas geralmente estamos priorizando a qualidade em vez da velocidade por enquanto.
O Buildprint permite que você trabalhe em várias tarefas ao mesmo tempo - aproveite isso e você poderá melhorar significativamente sua produtividade no desenvolvimento com Bubble.
Além disso, o Buildprint às vezes será mais lento do que fazer manualmente. Se ele implementar algo e você precisar fazer uma pequena alteração - basta fazer você mesmo! Esse é o poder do Bubble, e saber quando atualizar as coisas por conta própria e quando delegar ao Buildprint é uma habilidade importante.
Limite de uso atingido
Se você vir um erro de limite de uso ou estiver atingindo rate limits, isso vem do seu provedor de IA (ChatGPT ou Claude), não do Buildprint. Os rate limits do seu provedor se aplicam a todo o uso na plataforma deles, não apenas ao Buildprint.
Para resolver isso:
Faça o upgrade do seu plano com seu provedor de IA para obter limites de taxa mais altos.
Inicie uma nova conversa após o upgrade. Pode levar algum tempo para que os novos limites entrem em vigor devido ao cache dos provedores.
Aguarde a janela de rate limit resetar, caso não queira fazer o upgrade.
O Buildprint exige modelos inteligentes e muitos tokens. Os planos da Anthropic, em particular, têm rate limits baixos. Não espere conseguir usar o Buildprint o dia todo, todos os dias, no plano de US$ 20/mês deles.
O melhor custo-benefício e os planos recomendados
são os planos de US$ 20/mês e US$ 200/mês do ChatGPT.
Não vejo as alterações do Buildprint no editor
Primeiro, certifique-se de que está verificando a mesma branch das edições do Buildprint. Algumas edições podem exigir a atualização do editor do Bubble para ficarem visíveis (ex: criação de páginas).
O Buildprint recusa-se a fazer as alterações
Se o modo de edição estiver ativado e o Buildprint disser que não consegue fazer as alterações, é provável que nosso verificador de problemas tenha sido acionado. Validamos automaticamente quaisquer alterações no seu app Bubble para diminuir a probabilidade de problemas incomuns passarem. Nosso verificador de problemas pode estar retornando um falso positivo que impede a edição. Nesse caso, você pode perguntar ao Buildprint o que ele deseja fazer e, em seguida, executar essa alteração específica você mesmo. Para nos reportar o problema, peça ao Buildprint para enviar um bug report e poderemos analisá-lo.
Preciso reconectar o Buildprint ao migrar para um servidor dedicado?
Se você estiver migrando de um app Bubble em cluster compartilhado para um servidor dedicado, é possível migrarmos sua conexão do Buildprint sem perder os dados e logs do seu projeto. Entre em contato conosco para lidarmos com isso para você, com os detalhes do seu app atual, e poderemos realizar essa migração. Alternativamente (mas não recomendado), você pode criar um novo projeto Buildprint para o seu novo app dedicado e excluir o projeto antigo.
Como posso renomear minha conversa?
Passe o mouse sobre a conversa na barra lateral, clique nos três pontos no card e clique em "Renomear". Apenas os proprietários da conversa podem renomeá-las.
O Buildprint suporta mobile nativo?
Estamos lançando o suporte para mobile nativo. Por enquanto, o Buildprint deve ser majoritariamente preciso com seu trabalho em mobile nativo, mas você deve monitorá-lo. Pode ser que ele precise de mais orientação do que em apps web.
Como posso visualizar as faturas das compras?
Navegue até Workspace Settings clicando no seletor de workspace no canto superior esquerdo da barra lateral, passando o mouse sobre seu workspace e clicando em Settings.
Mude para a aba Billing.
Clique em Manage billing.
Você pode baixar faturas / atualizar o método de pagamento aqui.