Skip to main content

​
Sync da IA e auditoria de conhecimento

Guia interno (CS / suporte) para separar três perguntas que costumam se misturar:
  1. O cliente salvou no Flow?
  2. A IA já processou (sincronizou)?
  3. O agente está usando aquele conteúdo no prompt?

​
Duas telas, duas perguntas

A auditoria avisa: estar na lista não prova uso em uma mensagem específica — use o chat de teste para telemetria por resposta.

​
Como saber se está sincronizado

  1. Abra Sincronização da IA com o mesmo agente do funil.
  2. Na card Saúde da sincronização, veja o badge agregado e o mapa por categoria.
  3. Para Estilo de comunicação, a categoria no backend é communication_identity.
  4. Interpretação rápida:
    • ready: treinamento disponível para o agente.
    • saved / queued / syncing / processing: salvo no Flow, pipeline ainda rodando — use Atualizar agora ou aguarde.
    • failed / retained / stalled: salvo no Flow, agente não tem a versão nova.
    • no_agent / skipped_shared: dados ok no workspace, mas este agente não recebeu o update.
No catálogo, falhas são por item; o grupo pode mostrar “10 falha · 20 sincronizado”.

​
Como saber se o cliente preencheu

  1. Fonte de verdade do formulário: ConnectIA → Estilo de Comunicação / Linguagem da equipe (/ai-tone).
  2. Campo persistido: ai_communication_identity no workspace.
  3. Prova de que virou treinamento: após salvar, em Sincronização da IA a linha Estilo de comunicação fica ready.
Não use o item ps:estilo-comunicacao na auditoria como prova de preenchimento — é o template gerador da plataforma, não os dados do cliente.

​
Estilo de Comunicação: o agente lê?

​
Por que aparece “Não entra” em ps:estilo-comunicacao

estilo-comunicacao e linguagem-equipe entram via embeddings do ConnectIA, não pelo texto do prompt stack. Na auditoria isso aparece como decisão Não entra + motivo embedding_synced. É o comportamento esperado. O texto tipo “GERADOR DE TREINAMENTO — ESTILO DE COMUNICAÇÃO” é a receita usada no save do ConnectIA; não é o prompt injetado a cada mensagem.

​
O que o agente realmente usa

  • Documentos gerados no save, título Estilo de Comunicação / Linguagem da Equipe
  • Origem Treinamento do agente (a:…)
  • Modo always → decisão Sempre no contexto

​
Checklist prático

  1. Auditoria → atalho Estilo do cliente (embeddings) → item com decisão Sempre → Ver (conteúdo com valores do cliente).
  2. Sincronização da IA → Estilo de comunicação = ready.
  3. Chat de teste: a lista “Embeddings usados nesta resposta” mostra só RAG roteado. Treinamentos Sempre no contexto (estilo) não aparecem aí — confie na auditoria + sync.

​
Prompt stack “retired”

Uma release marcada como retired no cabeçalho da auditoria não invalida embeddings já sincronizados. Afeta sobretudo treinamentos que entram pelo texto do stack.

​
Admin alterou o template global de estilo

O texto de fábrica novo só república embeddings no próximo salvamento de Estilo / Linguagem no ConnectIA.

​
Checklist rápido

  1. Sincronizado? → /ai-sync, categoria desejada = ready.
  2. Cliente preencheu? → /ai-tone (campos preenchidos) + sync ready.
  3. Agente com treinamento X ou Y? → Auditoria: Sempre = injetado sempre; Pode ser roteado = só se o roteador escolher; Não entra = ler o Motivo.
  4. Estilo? → Ignorar ps:estilo-comunicacao; validar a:… Estilo de Comunicação, decisão Sempre; sync communication_identity = ready.