Visão Geral do Versioning

O sistema de Versioning da Zaia Endless permite atualizar seus Agentes e componentes relacionados com segurança, usando um ambiente de Draft, sem afetar o que está rodando em produção no momento.

Isso garante iteração segura, testes adequados e releases controlados.

---

🔄 O que é Versionado

O Versioning se aplica às entidades de configuração — tudo que define como o seu Agente se comporta:

• Agentes
• Squads
• Tools
• MCPs
• Voices
• Components
• Tasks

Esses elementos podem ser editados com segurança no Draft e só afetam a produção após um Deploy.

---

🚫 O que NÃO é Versionado

Algumas partes da plataforma estão sempre ativas e não são afetadas pelo versioning:

Dados Operacionais

• Channels
• Conversas / Chats
• Tickets
• Tags
• Execuções

Dados e Armazenamento

• Knowledge Bases
• Tables / Datagrid

Configuração do Sistema

• Usuários e Workspaces
• Connections
• Providers
• API Keys
• Faturamento / Assinatura

---

📌 Implicação Importante

O Versioning muda o comportamento, não os dados.

Fazer deploy ou rollback NÃO vai modificar:

• Histórico de conversas
• Registros de CRM
• Dados armazenados

---

🔎 Conceitos Fundamentais

Draft

Um ambiente privado onde você pode:

• Editar Agentes e todos os componentes versionados
• Testar mudanças com segurança usando o Internal Chat
• Iterar sem impactar usuários reais

---

Production

A versão atualmente ativa na plataforma.

É usada em:

• Channels (WhatsApp, Instagram, Widget, API)
• Conversas de CRM
• Todas as interações reais com usuários

Somente as mudanças que forem publicadas (deployed) afetam a Production.

---

History

Todas as versões publicadas ficam armazenadas como histórico:

• Identificadas como versões (v1, v2, v3…)
• Usadas para comparação e rollback

---

🧭 Como Usar o Versioning

O fluxo de trabalho recomendado é simples e seguro:

---

✏️ Editando seu Agente

Sempre que quiser fazer mudanças:

1. Trabalhe na versão de Draft
2. Faça todas as atualizações necessárias (Agente, Tools etc.)
3. Teste usando o Internal Chat

Essas mudanças não afetam a produção até que você publique.

---

🚀 Publicando mudanças

Quando estiver satisfeito:

1. Clique em Publish
2. Revise as mudanças (Diff)
3. Confirme o Deploy

Após publicar:

• A nova versão entra no ar
• Todos os canais passam a usar o comportamento atualizado

---

🔄 Revertendo para uma versão anterior

Se necessário:

1. Vá até Version History
2. Selecione uma versão anterior
3. Clique em Edit this version (Rollback)
4. Confirme

O que acontece:

• O Draft atual é substituído
• Você pode revisar a versão
• Depois, publique novamente para aplicá-la à produção

---

🧪 Testando em Draft

Antes de publicar, você pode testar usando o Internal Chat:

• Validar respostas
• Testar tools e fluxos
• Simular interações reais

---

✅ Resumo

O Versioning permite:

• Construir com segurança no Draft
• Testar antes de colocar no ar
• Fazer deploy com confiança
• Reverter mudanças quando necessário

Tudo isso sem impactar seus usuários reais ou os dados.