Uso Seguro e Boas Práticas

🧪 Testando em Draft

Antes de publicar, você deve sempre testar suas mudanças usando o Internal Chat.

O que Testar

Respostas do Agente
Execução de Tools
Fluxos de conversa
Casos extremos (edge cases)

Por que Testar É Importante

Até pequenas mudanças podem impactar o comportamento.

Testar garante:

Estabilidade
Previsibilidade
Melhor experiência para o usuário

⚠️ Comportamentos Importantes para Entender

O Deploy é imediato

Assim que você faz o deploy:

Todas as novas mensagens seguem o comportamento atualizado instantaneamente
Não há rollout gradual

O Draft é completamente isolado

Mudanças no Draft NÃO afetam a produção
Você pode testar livremente sem risco

O Rollback substitui o Draft

Ao realizar um rollback:

Seu Draft atual é perdido
Ele é substituído pela versão selecionada

🚨 Erros Comuns a Evitar

Publicar sem validação

Pode causar:

Fluxos quebrados
Tools ausentes
Comportamento inesperado

Pular os testes

Leva a:

Bugs em produção
Má experiência para o usuário

Mudanças grandes sem validação

Evite:

Editar muitas coisas de uma vez
Fazer deploy sem iterar

📌 Boas Práticas

Trabalhe em pequenas iterações

Faça mudanças pequenas
Teste com frequência
Faça o deploy com confiança

Sempre siga este fluxo

Edite no Draft
Teste usando o Internal Chat
Revise as mudanças antes de publicar (use o Diff quando necessário)
Faça o Deploy
Monitore o comportamento

Use o Diff como ferramenta de segurança

O Diff ajuda você a:

Entender o que mudou
Identificar remoções ou adições
Validar atualizações críticas antes do deploy

Use o Diff quando quiser mais confiança antes de publicar.

Use o Rollback como uma rede de segurança

Não como fluxo de trabalho principal
Apenas quando necessário

✅ Resumo

Para usar o Versioning de forma eficaz:

Sempre trabalhe no Draft
Sempre teste antes de publicar
Valide suas mudanças
Faça o deploy com cuidado
Use o rollback apenas quando necessário

Isso garante atualizações seguras, previsíveis e confiáveis para seus Agentes.