clientflow_backend/RELEASE_NOTES_v4928_1_5_7.md

ClientFlow v4928.1.5.7 — Email Reply Agent readability format

Objetivo

Melhorar a legibilidade comercial das respostas geradas pelo agente de email OpenAI/file_search, mantendo a Fase 1 em modo seguro: rascunho editável, sem envio automático.

Alterações

• Reforço do prompt para gerar respostas com parágrafos curtos e estrutura visual mais clara.
• Pedidos de preço/proposta passam a seguir uma estrutura comercial quando aplicável:
  • cumprimento/agradecimento;
  • proposta/equipamento solicitado;
  • preço s/IVA;
  • funcionalidades incluídas;
  • prazo de entrega;
  • próximo passo;
  • assinatura Com os melhores cumprimentos, Sérgio Araújo, Blif.
• O agente só deve usar nome, Sr./Sra. ou referência de terceiros quando essa informação estiver disponível no email ou no contexto ClientFlow.
• A descrição JSON de resposta_sugerida foi afinada para pedir respostas com listas e melhor leitura.
• prompt_version atualizado para blif-email-agent-phase1-readability-20260613.

Segurança preservada

• O agente continua a gerar apenas rascunhos.
• Não há envio automático.
• Casos de desconto, pagamento, encomenda, reclamação, exceção comercial, stock/envio e condições especiais continuam a poder ser marcados para revisão humana.
• O fluxo antigo continua disponível se CLIENTFLOW_EMAIL_REPLY_AGENT_ENABLED=false.

Deploy recomendado

Este pacote deve ser aplicado sobre a raiz atual do backend, evitando criar uma pasta nested.

cd /mnt/ssd/home/plx/clientflow_backend
mkdir -p /tmp/clientflow_v4928_1_5_7
unzip -q /caminho/clientflow_backend_v4928_1_5_7_email_reply_agent_readability.zip -d /tmp/clientflow_v4928_1_5_7
rsync -a /tmp/clientflow_v4928_1_5_7/ /mnt/ssd/home/plx/clientflow_backend/

PYTHONPATH=. python -m compileall app scripts tests
PYTHONPATH=. pytest -q

sudo systemctl restart clientflow-api
curl -i http://127.0.0.1:8020/health
sudo nginx -t
sudo systemctl reload nginx