> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connectvets.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Sync da IA e auditoria de conhecimento

> Como saber se o treinamento está sincronizado, se o cliente preencheu e se o agente lê o Estilo de Comunicação

# 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

| Pergunta                                 | Onde olhar                                         | O que significa “ok”                                                                                                     |
| ---------------------------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| O cliente salvou e a IA já processou?    | Flow → **Sincronização da IA** (`/ai-sync`)        | Status **sincronizado** (`ready`) + mensagem “Salvo e disponível para o agente”                                          |
| O que pode entrar no contexto do modelo? | Shirechat → agente → **Auditoria de conhecimento** | Item com decisão **Sempre** ou **Pode ser roteado**, origem **Treinamento do agente**, sem motivo de falha/processamento |

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`.