Pular para o conteúdo
Histórico

Tudo o que já aconteceu com o cliente, para o agente consultar.

O contexto cobre o que importa agora. Quando a conversa pede mais, o agente consulta o histórico inteiro do cliente, com qualquer LLM: busca por significado e por palavra, folheia a linha do tempo e abre uma conversa específica. Cada resultado volta com data, canal, desfecho e origem, e respeita as permissões daquele agente.

Como funciona

Busca no históricoexemplo
A cliente diz

“Da outra vez vocês me deram um crédito.”

O agente consulta
niadra.search(
  subject=ctx.subject,
  query="crédito por visita técnica perdida",
)
A Niadra responde
  • 12/03/2026 · TelefoneTécnico não compareceu. Crédito de R$ 40 aplicado na fatura de abril. resolvido
  • 14/03/2026 · WhatsAppA cliente confirmou o crédito e a nova visita. resolvido
  • 03/11/2025 · AppVisita remarcada a pedido da cliente. sem crédito
Segunda visita perdida em 12 meses. Na anterior, crédito de R$ 40.
  • Três operações: buscar, folhear a linha do tempo e abrir uma conversa
  • “Quantas vezes isso aconteceu” é uma contagem, não um palpite
  • Mesmas permissões e mesmo nível de verificação do contexto
  • Pelo SDK, pela API ou como ferramenta MCP, com o modelo que você já usa
  • O identificador do cliente vai amarrado na ferramenta, fora do alcance do modelo: uma mensagem maliciosa não troca de cliente
  • Cada consulta deixa registro: quem perguntou, o que perguntou e o que voltou

O que o agente consegue perguntar

  • Isso já aconteceu antes? Quantas vezes?
  • O que foi prometido da última vez, e por quem?
  • Como a última reclamação foi resolvida?
  • Ela já pediu cancelamento alguma vez?
  • Alguém já cuidou disso? O que foi feito?

Sete ferramentas MCP

As mesmas funções do SDK, para o agente que fala MCP. A descrição de cada uma ensina o modelo quando usar.

  • get_customer_context
  • track_event
  • record_action
  • resolve_identity
  • search_customer_history
  • get_customer_timeline
  • open_history_item

O próximo agente já pode chegar sabendo.

Conte o que você está construindo. Quem responde é quem escreve o código.