Usando o 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 próprio ambiente de execução do agente do provedor selecionado. Por exemplo, um modelo Codex é executado pelo ambiente Codex, enquanto um modelo Claude é executado pelo Claude Code.

Cada conversa é executada dentro de sua própria máquina virtual. Este é um ambiente de nuvem isolado, criado especificamente para essa conversa do Agent.

A máquina virtual inclui:

• Ferramentas do Buildprint para ler e trabalhar com seu projeto Bubble autorizado.

• O ambiente de execução nativo do agente do provedor de IA selecionado.

• Todas as conexões MCP personalizadas que você ativou para esse workspace.

• 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 trabalhos com várias etapas enquanto a conversa estiver ativa.

Tempo de execução do Agent

O tempo que o Agent passa sendo executado dentro dessa máquina virtual é chamado de tempo de execução do Agent.

O tempo de execução inclui o período que o Agent passa pensando, lendo arquivos, usando ferramentas do Buildprint ou MCP e executando comandos. Ele é contabilizado sempre que o Agent está trabalhando ativamente, não apenas quando escreve uma resposta.

Os subagentes não contribuem com tempo de execução adicional, pois são executados no ambiente do agente principal.

Seu plano inclui uma quantidade de tempo de execução do Agent. Se você usar mais do que a quantidade incluída, o tempo adicional será cobrado como excedente baseado no uso. Você pode consultar sua franquia incluída, o uso atual e os detalhes do excedente nas configurações de cobrança do workspace.

O tempo de execução do Agent é separado do uso dos modelos de IA. Os modelos do Buildprint usam créditos de IA do workspace, enquanto os provedores conectados usam os limites e a cobrança da sua conta do 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 do agente.

Iniciar uma conversa

Selecione o projeto Bubble com o qual você quer que o Agent trabalhe antes de enviar uma mensagem.

1. Abra o Agent.

2. Selecione o projeto exibido acima da caixa de mensagem.

3. Escolha um modelo de IA e um nível de raciocínio.

4. Selecione Plan ou Build.

5. Escolha quais ramificações do Bubble o Agent pode usar.

6. Descreva o que você quer que o Agent faça e envie a mensagem.

Escolher um modelo

Selecione o modelo com base na tarefa e nos provedores de IA conectados à sua conta.

A configuração de raciocínio controla quanto o modelo pensa. Um raciocínio mais aprofundado pode ajudar em tarefas difíceis, mas pode levar mais tempo e custar mais.

Os modelos do Buildprint usam créditos de IA do workspace. Os modelos de outros provedores usam a conta do provedor conectada em Integrations → AI Providers. Eles consomem os limites de taxa existentes do seu provedor e não são limitados pelo Buildprint.

Recomendações

Se você ainda não tiver uma assinatura de provedor de IA, recomendamos atualmente 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 taxa.

Com base em nossa experiência, recomendamos as opções a seguir como um bom equilíbrio de limites de taxa:

Escolher Plan ou Build

Use Plan para investigar e Build quando estiver pronto para que o Agent faça alterações.

• Plan permite que o Agent leia o contexto autorizado do projeto sem alterar o aplicativo Bubble.

• Build permite que o Agent altere ramificações autorizadas do Bubble quando suas permissões do Buildprint e do Bubble permitirem.

Você pode alternar entre Plan e Build durante uma conversa. Verifique as ramificações selecionadas antes de enviar um trabalho no modo Build.

Adicionar contexto útil

O Agent já tem acesso ao contexto autorizado do projeto selecionado. Adicione contexto extra quando a tarefa depender de um arquivo, habilidade, página, ramificação, componente, análise do Radar ou issue do Linear específico.

Clique em + para anexar um arquivo ou selecionar o contexto disponível. Você também pode arrastar arquivos para a caixa de mensagem, colar textos mais longos como anexo ou gravar um comando de voz.

Trabalhar com o Agent

O Agent mostra seu progresso dentro da conversa enquanto trabalha.

• Responda a todas as perguntas que o Agent fizer 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 leitura ou bifurcá-la em uma conversa separada. Uma bifurcação copia o resumo e os anexos da conversa, mas começa com 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 degradado e alucinações.

Você também deve começar novamente se a conversa atual tiver ficado confusa, se o ambiente do Agent apresentar um erro ou se o Buildprint informar que a conversa não pode continuar.

Solução de problemas