Manual Agentes Playbook

Voltar para Central de Manuais

# Manual Agentes - Playbook Operacional

## Objetivo

Padronizar o uso dos agentes da Conexlog no dia a dia.

## 1) LOGOS (Financeiro)

- Foco: faturamento, inadimplência, fluxo de caixa, contas a receber/pagar.
- Quando usar:
  - fechamento de período
  - análise de carteira
  - risco financeiro por cliente/grupo
- Prompt recomendado:
  - "Modo paridade de relatório: faturamento emitido de abril/2026 por grupo."

## 2) VETOR (Comercial)

- Foco: churn, crescimento, receita por cliente/grupo/canal.
- Quando usar:
  - priorização comercial
  - análise de queda de base
  - potencial de expansão
- Prompt recomendado:
  - "Top clientes por crescimento no último trimestre, com risco de churn."

## 3) SENTINELA (Operacional)

- Foco: SLA, performance de agentes, gargalos operacionais.
- Quando usar:
  - auditoria de atraso
  - qualidade de parceiro
  - risco operacional por rota
- Prompt recomendado:
  - "Quais agentes têm maior incidência de atraso nas últimas 4 semanas?"

## 4) HILDR (Atendimento)

- Foco: rastreamento, posição de carga, histórico de eventos.
- Quando usar:
  - suporte ao cliente
  - acompanhamento de embarque
  - consulta por CNPJ/CTE/NF
- Prompt recomendado:
  - "Rastreie as cargas do CNPJ X e destaque risco de atraso."

## 5) ODIN (Executivo)

- Foco: visão 360 integrada.
- Quando usar:
  - reuniões de diretoria
  - decisões estratégicas
  - síntese de saúde do negócio
- Prompt recomendado:
  - "Traga visão 360: financeiro + operacional + comercial com prioridades."

## Regra de ouro

- Número oficial = relatório oficial.
- Agente = análise + cruzamento + previsão (ML), não substitui fechamento contábil.

## Regra obrigatória para CTE (paridade)

- Quando o usuário não pedir status específico: usar somente CTE autorizada e não cancelada.
- Para CTE por cliente/grupo, resolver coleta de forma robusta:
  - `COALESCE(ct.id_coleta, r.id_coleta, cte_pai.id_coleta)`
  - com `LEFT JOIN app_rastreamentos r` e `LEFT JOIN app_ctes cte_pai`.
- Objetivo: evitar divergência por CTE complementar/substituto em comparação com relatório oficial.