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, nos bastidores, o próprio harness de agente do provedor selecionado. Por exemplo, um modelo Codex é executado pelo harness do 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 em sandbox criado especificamente para aquela conversa do Agent.

A máquina virtual inclui:

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

• O harness de agente nativo do provedor de IA selecionado.

• Todas as conexões MCP personalizadas que você habilitou 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.

Runtime do Agent

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

O runtime inclui o tempo que o Agent passa pensando, lendo arquivos, usando ferramentas do Buildprint ou do 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 runtime adicional, pois são executados no ambiente do agente principal.

Seu plano inclui uma quantidade de runtime do Agent. Se você usar mais do que a quantidade incluída, o runtime 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 runtime do Agent é separado do uso de 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 runtime do Agent.

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 Integrations → AI Providers. Eles consomem os limites de taxa do seu provedor atual 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 ocorre 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 branches 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 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, verificação 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 a próxima etapa ou orientá-lo enviando-a 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 um fork em uma conversa separada. Um fork 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 reduzido e alucinações.

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

Solução de problemas