Snapshots de versão
Quando um agente do Buildprint trabalha no seu app, ele opera em um snapshot — uma visão de um ponto específico no tempo da lógica do seu app. Entender como os snapshots funcionam ajuda a evitar surpresas ao colaborar com agentes. No Buildprint, chamamos isso de versions.
Como funcionam os snapshots
Quando um agente inicia uma conversa ou sincroniza seu app, ele tira um snapshot do estado atual do seu app no Bubble. Este snapshot inclui o esquema do seu banco de dados, fluxos de trabalho, páginas e configurações naquele exato momento.
A partir desse ponto, o agente trabalha com base neste snapshot. Ele rastreia cada edição que faz sobre ele, para que sempre saiba o estado atual do app — desde que as alterações tenham vindo do próprio agente.
Snapshots não incluem valores privados do conector de API ou segredos de plugins. O Buildprint pode alucinar ao responder a perguntas que questionem sobre estes itens.
O que o agente pode e não pode ver
O agente vê:
O estado inicial do seu app na última sincronização
Cada alteração que ele fez desde essa sincronização
Cada alteração que outros agentes fizeram nesse branch desde essa sincronização
O agente não vê:
Alterações que você faz diretamente no editor do Bubble
Alterações feitas por outros colaboradores ou agentes no mesmo branch
Isso significa que, se você editar algo no Bubble enquanto um agente está trabalhando, o agente não saberá. Ele continuará trabalhando a partir de seu próprio snapshot, o que pode levar a conflitos ou alterações sobrescritas.
Os agentes estão sempre cientes das edições uns dos outros. Isso significa que você pode ter dois agentes desenvolvendo no mesmo branch sem a necessidade de sincronizar novamente (embora eles possam se cruzar se trabalharem na mesma funcionalidade, por isso certifique-se de que estejam focados em lugares diferentes, tal como dois desenvolvedores Bubble fariam).
Mantendo o agente sincronizado
Se você fizer alterações fora do agente e quiser que ele as veja, peça ao agente para sincronizar (sync). Isso atualiza o snapshot dele para que ele reconheça suas edições manuais.
Você deve sincronizar sempre que:
Fizer alterações diretamente no editor do Bubble no mesmo branch
Tiver outro colaborador enviando alterações para o branch
Quiser que o agente trabalhe com a versão mais recente do seu app
Ganhe o hábito de pedir ao agente para sincronizar antes de iniciar um novo trabalho, caso você tenha editado no Bubble entre as conversas.
Nós sincronizamos automaticamente a versão live uma vez por semana. Isso serve para dar suporte a funcionalidades futuras, como changelogs automatizados.
Além disso, sincronizamos automaticamente as versões quando você mescla branches nelas.
Problemas conhecidos
Em apps grandes, sincronizar uma versão pela primeira vez pode levar muito tempo ou falhar inteiramente. Para contexto, não usamos a exportação nativa .bubble fornecida pelo Bubble, pois ela expira em apps grandes e geralmente é lenta. Em vez disso, usamos um método muito mais rápido, mas estamos lutando contra os limites de taxa (rate limits) do Bubble que nos impedem de rodar isso tão rápido quanto poderíamos. Apps grandes podem levar alguns minutos para sincronizar, embora a sincronização só deva ser necessária ao carregar um branch pela primeira vez ou criar um novo. Temos otimizações em vigor para tornar essa exportação o mais rápida possível após a sincronização inicial.
A sincronização de versão exige que seu app Bubble esteja no plano Starter ou superior. O teste gratuito do Starter também é suportado. Se a sincronização de versão falhar com 401 Unauthorized e o colaborador estiver configurado corretamente, este é provavelmente o motivo. Por favor, atualize para o teste do Starter ou um plano pago.