Usando 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. Esse é 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ê tiver habilitado 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, e 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 com base 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 do modelo 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 de usar o 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 branches 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 intenso 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 sua conta de provedor existente, conectada em Integrações → Provedores de IA. Eles consomem os limites de uso do seu provedor existente e não são limitados pelo Buildprint.

Recomendações

Se você ainda não tiver uma assinatura de provedor de IA, atualmente 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 em nossa experiência, recomendamos as opções a seguir por oferecerem um bom equilíbrio de limites de uso:

Escolher Plan ou Build

Use Plan para investigar e use 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 branches autorizadas do Bubble quando suas permissões no Buildprint e no Bubble permitirem.

Você pode alternar entre Plan e Build durante uma conversa. Verifique as branches 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, skill, página, branch, componente, análise do Radar ou issue do Linear específico.

Clique em + para anexar um arquivo ou selecionar um contexto disponível. Você também pode arrastar arquivos para a caixa de mensagem, colar um texto mais longo 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 feitas pelo Agent antes que ele continue.

• Se o Agent já estiver trabalhando, você pode colocar outra mensagem na fila para a próxima etapa 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 ramificá-la em uma conversa separada. Uma ramificaçã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 um provedor de IA diferente. Conversas longas podem apresentar desempenho reduzido 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.

Ramificação

O Buildprint permite ramificar uma conversa. Nos bastidores, isso irá:

• resumir sua conversa

• trazer 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

Solução de problemas