Para a equipe técnica¶

Recursos voltados à equipe interna (linha de comando), úteis para suporte e qualidade. Não fazem parte do uso do dia a dia do cliente.

Clonar a configuração do bot entre workspaces¶

Copia persona, prompts, base de conhecimento, regras de ação e módulos de um workspace para outro — útil para reproduzir um cenário de cliente em ambiente de teste.

cd backend
npm run clone-workspace -- --from=<workspace-origem> --to=<workspace-destino>
# --keep  → não limpa o destino antes de copiar

Gerar testes automáticos a partir de conversas¶

Gera um teste de regressão a partir de uma conversa problemática do bot + a descrição do comportamento esperado. O teste reencena os turnos pelo simulador.

cd backend && bash scripts/build-automation-test.sh   # 1ª vez
npm run generate-regression -- \
  --conversation=<id-da-conversa> \
  --name=nome-do-bug \
  --description="o que deveria ter acontecido" \
  --final-contains="agendar" \
  --final-not-contains="preocupado"

O arquivo é gravado em tests/auto-regression/ e roda com node tests/auto-regression/<nome>.spec.js.

Publicar esta documentação¶

Esta documentação é gerada com MkDocs Material.

# pré-requisito (uma vez)
pip3 install --user mkdocs-material

# pré-visualizar localmente (http://localhost:8000)
python3 -m mkdocs serve

# gerar o site estático (pasta site/)
python3 -m mkdocs build

O conteúdo da pasta site/ é estático (HTML/CSS/JS) e pode ser servido em qualquer lugar — VPS própria (nginx), Cloudflare Pages, Netlify, etc. Veja o passo a passo de deploy no README do repositório.