Um agente de IA que fala como gente e não inventa.

Um agente de primeiro nível que responde clientes num canal de mensagens a partir da base de conhecimento da própria empresa, mais um chat interno sobre a mesma base para o time. Toda afirmação sai com o id do trecho que a sustenta, e uma verificação determinística confere cada id contra o que a busca devolveu. Quando não confere, a violação fica registrada.

• Debounce, agrupamento de rajada e serialização por conversa resolvidos numa única consulta de reserva: o cliente manda cinco mensagens seguidas e recebe uma resposta, não cinco.
• O turno é gravado antes de ser enviado, e a primeira instrução dessa transação verifica se uma pessoa acabou de assumir a conversa, para que ninguém receba resposta de robô depois de um atendente entrar.
• Escalação em duas fases: o agente propõe o chamado, e a abertura só passa quando o servidor encontra essa proposta anterior no log, ou quando o próprio cliente pediu uma pessoa.

• agente de atendimento
• citar antes de escrever
• fila durável no Postgres
• escalação em duas fases
• chat interno por SSE
• cache de prompt fixado

O serviço de recuperação sobre o qual os agentes rodam. Uma chamada busca por sentido e por palavra exata no mesmo índice, funde os dois rankings, expande pelo grafo de conhecimento, reordena e devolve os trechos com a nota de cada um. Não chama modelo de linguagem e não escreve nos dados.

• As duas pernas são fundidas por Reciprocal Rank Fusion com peso, e não por média de scores: cada perna vota pela posição, e o peso favorece a palavra exata, onde o vocabulário do próprio cliente é o que importa.
• O grafo é construído por parsers determinísticos, sem extração por modelo: as arestas vêm de wiki-links, do front-matter, do glossário e dos diagramas que já estão no conteúdo.
• Dois espaços de embedding em tabelas separadas, com um breaker movendo o tráfego entre eles e sem reindexação, mais um contrato de índice publicado contra o qual o serviço se recusa a subir quando o formato divergiu.

• busca híbrida
• RRF com peso
• grafo Apache AGE
• pgvector HNSW
• contrato de índice publicado
• circuit breaker

A aplicação onde uma pessoa edita o conteúdo que o agente vai responder, com revisão, diff e histórico. Publicar não é salvar: passa pelo lint do corpus, gera um commit de um arquivo só no git e reindexa apenas o que mudou.

• O lint do corpus é um registro de regras sem parâmetro de bypass na assinatura: erro barra a publicação, e conteúdo com um segredo colado dentro não chega ao índice.
• Uma reindexação paga exige o escopo que o operador realmente viu: a API devolve as quatro classes de mudança separadas, mais um token daquele escopo, e recusa a execução quando o escopo mudou.
• Uma exclusão em massa é recusada antes do primeiro DELETE quando o raio real passa do limite, em vez de ser executada.

• curadoria de corpus
• lint sem bypass
• git como fonte da verdade
• reindexação com escopo
• grafo tipado determinístico
• guarda de raio de exclusão

Um assistente de modo duplo sobre o acervo societário privado de cada empresa: responde a dúvida citando o documento que sustenta a resposta, e redige o documento novo no padrão que a organização já usa. O acervo é o que a governança produz, ou seja atas de assembleia, contratos sociais, estatutos, livros de registro de ações, mandatos e procurações.

• Duas tarefas sobre o mesmo acervo, perguntar e redigir: a resposta cita o documento que a sustenta, e o documento redigido sai no padrão que a organização já usa em vez de um modelo genérico.
• Uma dúvida sobre a legislação societária vigente é respondida em separado de uma dúvida sobre o acervo do próprio cliente, porque uma envelhece com a lei e a outra envelhece com o documento.
• Dados isolados por cliente e sem treinamento externo. Num acervo societário isso não é preferência de arquitetura, é a condição para o acervo entrar no sistema.

• respostas citadas
• redação de documentos
• acervo societário
• padrão da organização
• isolamento por cliente
• sem treinamento externo