Cada número que o agente fala tem origem no próprio turno, ou é contado e sinalizado.
Um preço que ninguém cotou, um prazo três dias fora, uma promessa sem ação por trás. O contrato de afirmação declara, para cada agente, o que ele pode afirmar e a evidência que cada afirmação precisa ter no registro do turno: um valor com origem e frescor, uma chamada à ferramenta certa, um trecho que cita a fonte. A conferência roda no processo do agente, por léxico, papel e âncora, sem modelo a mais, no último ponto antes do cliente ou antes de um documento ser salvo. O que não se sustenta é anotado, contado ou dá lugar à ressalva da categoria, conforme o contrato da sua empresa. Documento assinado nunca é reescrito: é conferido e contado, e vai a uma pessoa quando não se sustenta. A Niadra recebe só os vereditos e os soma.
Como funciona
A resposta, conferida antes de sair
exemploOi, Marina. O crédito de R$ 40 já foi lançado na fatura de agosto, e remarquei a visita para 23/09 de manhã. Como pedido de desculpas, a próxima fatura vem com 15% de desconto.
- R$ 40 valor · crédito leitura de estado: fatura 0823, campo crédito, ERP há 1 min veredito: confere ação: nenhuma
- 23/09 data · visita ferramenta remarcar_visita, chamada neste turno veredito: confere ação: nenhuma
- 15% porcentagem · desconto nenhuma: nem ferramenta nem leitura do turno traz um desconto veredito: sem origem ação: a frase dá lugar à ressalva do contrato
Oi, Marina. O crédito de R$ 40 já foi lançado na fatura de agosto, e remarquei a visita para 23/09 de manhã. Sobre desconto, eu confirmo com o time e te retorno.
Conferido no processo do agente, por léxico, papel e âncora: nenhum modelo a mais. Os três vereditos vão ao registro do turno; o texto do seu prompt, nunca.
- Três naturezas de número: citado, computado e dito pelo modelo. Só o que não tem origem é tratado como o contrato manda: anotar, contar ou dar lugar à ressalva
- A evidência é exatamente uma: um valor com origem no turno, uma chamada a esta ferramenta, uma chamada a qualquer destas, ou uma âncora de texto a 0,90 ou mais
- O frescor governa a afirmação: um valor velho vem com a idade e não sustenta um número
- Uma reescrita só quando é inequívoca, em saída mutável, e nunca em dose, medida, tamanho ou identificador
- Uma lista versionada de frases do ofício que nunca podem disparar, testada no seu CI com niadra contract test
- O texto do seu próprio prompt, registrado por impressão digital, nunca chega ao cliente: o trecho dá lugar à linha do contrato, e o registro guarda o veredito, nunca o texto
- A taxa do que cada agente afirma sem consultar sai no aproveitamento do contexto, por agente e por fornecedor
from niadra import Niadra, phone
def shown(product):
fields = {"price_sale": product["price_sale"]}
return [{"ref": f"product:store:{product['sku']}", "fields": fields}]
@Niadra.tool("check_price", provenance=shown)
def check_price(sku: str) -> dict:
return CATALOG[sku]
niadra = Niadra(channel="whatsapp")
# fingerprints of your own prompt, computed here; the text never leaves
niadra.internal_text.register("prompts@v16", PROMPT)
customer = phone(customer_phone)
with niadra.conversation(
thread_id, subject=customer, agent_id="store"
) as conversation:
build = Niadra.build(prompts={"store": "v16"}, model="gpt-4.1-mini")
with conversation.turn(build=build):
check_price("PX-4471") # recorded, with the price it showed
# the contract's actions, at the last point before the customer
guarded = conversation.claims.guard_text(draft)
conversation.agent(guarded.text)- Python
- TypeScript
Trecho de examples/claim_guard.py do SDK: a ferramenta registra o que mostrou, e a resposta passa pelo contrato antes de virar a fala do agente.
Uma memória, treze produtos
Qualquer agente se liga à memória com três chamadas, em Python, TypeScript, HTTP ou MCP, com adaptador pronto para os frameworks de voz e de agentes mais usados.
Ver a documentação(abre docs.niadra.com)- ContextoO que cada agente precisa saber antes de começar.
- HistóricoTudo o que já aconteceu, para o agente consultar.
- AvisosUm webhook assinado para o seu sistema na hora em que algo acontece.
- AfirmaçãoVocê está aquiO que o agente pode afirmar, e a conferência do que ele afirmou, sem modelo a mais.
- CoordenaçãoQuem está com o cliente agora e o que já foi feito, antes de um agente agir.