Confira se há um projeto selecionado e se a configuração dele foi concluída. Aguarde o fim do envio dos anexos ou remova os que apresentarem falha.
Usar Agent
Use o Agent para entender seu projeto Bubble, planejar o trabalho e fazer alterações por meio de uma conversa.
Como o Agent funciona
O Buildprint executa, em segundo plano, o ambiente de agente próprio do provedor selecionado. Por exemplo, um modelo Codex é executado pelo ambiente Codex, enquanto um modelo Claude é executado pelo Claude Code.
Cada conversa é executada em sua própria máquina virtual. Esse é um ambiente de nuvem isolado, criado especificamente para aquela conversa com o Agent.
A máquina virtual inclui:
Ferramentas do Buildprint para ler e trabalhar no seu projeto Bubble autorizado.
O ambiente de agente nativo do provedor de IA selecionado.
Todas as conexões MCP personalizadas que você ativou para esse espaço de trabalho.
Um sistema de arquivos privado onde o Agent pode criar e trabalhar com arquivos durante a conversa.
Essa configuração oferece ao Agent mais do que uma janela de chat. Ele pode inspecionar arquivos, usar ferramentas, executar comandos e concluir tarefas com várias etapas enquanto a conversa estiver ativa.
Tempo de execução do Agent
O tempo que o Agent passa em execução nessa máquina virtual é chamado de tempo de execução da máquina.
As máquinas são executadas enquanto o agente trabalha e também por algum tempo depois (configurável nas configurações do projeto) para garantir que seja possível retomar rapidamente.
Os subagentes não acrescentam tempo de execução, pois são executados no ambiente do agente principal.
Seu plano inclui uma determinada quantidade de tempo de execução da máquina. Se você ultrapassar esse limite, o tempo adicional será cobrado conforme o uso. Você pode consultar o limite incluído, o uso atual e os detalhes do excedente nas configurações de cobrança do espaço de trabalho.
O tempo de execução da máquina é separado do uso de modelos de IA. Os modelos do Buildprint usam créditos de IA do espaço de trabalho, enquanto os provedores conectados usam os limites e a cobrança da conta do seu provedor. Se você usar apenas provedores conectados, como Claude, Codex e Cursor, o único custo do uso do Agent será o tempo de execução da máquina.
Iniciar uma conversa
Selecione o projeto Bubble com o qual você quer que o Agent trabalhe antes de enviar uma mensagem.
Abra o Agent.
Selecione o projeto exibido acima da caixa de mensagem.
Escolha um modelo de IA e o nível de raciocínio.
Selecione Planejar ou Construir.
Escolha quais branches do Bubble o Agent pode usar.
Descreva o que você quer que o Agent faça e envie a mensagem.
Escolher um modelo
Selecione o modelo de acordo com a tarefa e os provedores de IA conectados à sua conta.
A configuração de raciocínio controla quanto o modelo pensa. Um nível de raciocínio mais alto pode ajudar em tarefas difíceis, mas pode levar mais tempo e custar mais.
Os modelos do Buildprint usam créditos de IA do espaço de trabalho. Os modelos de outros provedores usam a conta do provedor que você já conectou em Integrações → Provedores de IA. Eles consomem os limites de uso do seu provedor e não são limitados pelo Buildprint.
Recomendações
Se você ainda não tem uma assinatura de provedor de IA, no momento recomendamos o plano de US$ 20/mês ou de US$ 100/mês do ChatGPT (em 12 de agosto de 2026). Isso porque ele oferece a melhor relação custo-benefício em termos de qualidade e limites de uso.
Com base na nossa experiência, recomendamos as opções a seguir para obter um bom equilíbrio de limites de uso:
Provedor | Planejamento | Construção |
|---|---|---|
Claude | Fable 5 ou Opus 5 | Opus 5 |
Codex | GPT 5.6 Sol | GPT 5.6 Sol ou GPT 5.6 Terra |
Cursor | Grok 4.6 | Grok 4.6 ou Composer |
Depois que a conversa começa, o provedor selecionado fica bloqueado. Inicie uma nova conversa para usar outro provedor.
Escolher Planejar ou Construir
Use Planejar para investigar e Construir quando estiver tudo pronto para o Agent fazer alterações.
O modo Planejar permite que o Agent leia o contexto autorizado do projeto sem alterar o app Bubble.
O modo Construir permite que o Agent altere branches autorizados do Bubble, desde que suas permissões no Buildprint e no Bubble permitam.
Você pode alternar entre Planejar e Construir durante uma conversa. Antes de enviar uma tarefa no modo Construir, confira os branches selecionados.
Adicionar contexto útil
O Agent já tem acesso ao contexto autorizado do projeto selecionado. Adicione mais contexto quando a tarefa depender de um arquivo, habilidade, página, branch, componente, análise do Radar ou issue do Linear específica.
Clique em + para anexar um arquivo ou selecionar o contexto disponível. Você também pode arrastar arquivos para a caixa de mensagem, colar um texto mais longo como anexo ou gravar uma solicitação de voz.
Trabalhar com o Agent
O Agent mostra o progresso na conversa enquanto trabalha.
Responda a todas as perguntas do Agent antes que ele continue.
Se o Agent já estiver trabalhando, você pode colocar outra mensagem na fila para o próximo turno ou orientá-lo enviando a mensagem imediatamente
Revise os anexos e os resultados antes de aceitar o trabalho.
Você pode copiar uma conversa como Markdown, compartilhar um link somente para leitura ou criar uma ramificação em uma conversa separada. Uma ramificação copia o resumo da conversa e os anexos, mas começa em um novo ambiente do Agent.
Quando iniciar uma nova conversa
Inicie uma nova conversa assim que mudar para um trabalho não relacionado ou precisar de outro provedor de IA. Conversas longas podem apresentar desempenho reduzido e alucinações.
Você também deve iniciar uma nova conversa se a atual ficar confusa, se ocorrer um erro no ambiente do Agent ou se o Buildprint informar que a conversa não pode continuar.
Criar uma ramificação
O Buildprint permite criar uma ramificação de uma conversa. Nos bastidores, isso vai:
resumir sua conversa
incluir todos os arquivos anexados
permitir que o agente continue em uma nova conversa, inclusive com um provedor de modelo diferente
Isso não incluirá:
alterações não confirmadas que ainda não foram aplicadas ao Bubble
arquivos gerados pelo agente
Expiração do Agent
As conversas com o Agent expiram 14 dias após o início do último turno. Isso ocorre devido ao custo de mantê-las disponíveis. 99% do trabalho em uma conversa acontece em até 14 dias, então isso não afetará a maioria dos usuários. Retomar um ambiente isolado estende a validade dele por 14 dias. Ainda é possível abrir e pesquisar uma conversa expirada, mas não executar o agente nela.
Solução de problemas
Não consigo enviar uma mensagem
O modo Construir não está disponível
Sua função no Buildprint ou suas permissões de colaborador no Bubble não permitem fazer alterações. Peça a um administrador do projeto para atualizar seu acesso.
O modelo pede para eu me conectar novamente
Conecte novamente o provedor de IA em Integrações → Provedores de IA. O Buildprint informará se você deve tentar enviar a mensagem novamente ou iniciar uma nova conversa.
Não é possível continuar a conversa
Inicie uma nova conversa. Inclua um breve resumo do objetivo, do que já foi feito e da próxima etapa que você quer que o Agent execute.
O ambiente de execução do agente está indisponível
Se ocorrer um erro que impeça o andamento de uma conversa, inicie uma nova conversa. Entre em contato com o suporte apenas se os erros ocorrerem em todas as conversas.
Podem ocorrer erros em ambientes isolados na nuvem e em conversas com agentes de IA.
Ocorreu um erro do BubbleScript (por exemplo, BSP5003)
Se ocorrer um erro que impeça o andamento de uma conversa, peça ao Buildprint para enviar um relatório de bug em seu nome. BubbleScript é a linguagem TypeScript de próxima geração para Bubble e, no momento, os projetos estão inscritos nela. Para cancelar a inscrição enquanto corrigimos o problema e usar a versão antiga do Buildprint, acesse as configurações do projeto e desative a opção BubbleScript em Recursos experimentais. A alteração será aplicada a novas conversas. Você não precisa entrar em contato com o suporte se já pediu ao Buildprint para enviar um relatório de bug.
Ocorreu um erro de autenticação do modelo ou do token de atualização
Se ocorrer um erro como Failed to refresh token: 400 Bad Request: Invalid 'refresh_token', você poderá resolvê-lo desconectando e reconectando sua assinatura do Codex ou do Claude Code na guia Integrações e, em seguida, iniciando uma nova conversa.