# Estado: o que vale agora para cada cliente, com idade, fonte e o que se pode afirmar | Niadra > Os tipos de estado da sua empresa (um pedido, um processo, uma proposta, uma cotação), declarados por você ou derivados do seu banco. Cada valor chega ao agente com a idade, a fonte e o que ele não pode afirmar com esse dado. “Não conferido” nunca vira “não”. URL: https://niadra.com/produtos/estado Estado # O que vale agora para cada cliente, com a idade, a fonte e o que se pode afirmar. O histórico diz o que aconteceu; o estado diz o que vale agora. A sua empresa declara os tipos de estado dela, ou a Niadra os deriva do seu banco e avisa quando mudam. Um pedido, um processo, uma proposta, uma cotação: a memória entende todos da mesma forma. Todo valor chega ao agente com a idade, a fonte e o que ele não pode afirmar com esse dado. Um valor velho nunca é recusado: vem com a idade, e o agente sabe o que não dizer com ele. O valor oficial continua no seu sistema, e a Niadra nunca o chama: quando um valor precisa ser lido de novo, o seu código lê, dentro da sua empresa. [Falar com a gente](/enterprise)[Ler na documentação(abre docs.niadra.com)](https://docs.niadra.com/concepts/object-types) ## Como funciona ### Leitura de estado finalidade: afirmar exemplo Campo · ValorIdade e fontePode afirmar? Fatura 0823 tipo fatura · espelha o ERP - estado creditada sim há 1 min · ERP, ao vivo fresco - crédito R$ 40,00 sim há 1 min · ERP, ao vivo fresco - boleto novo emitido não não há 1 min · ERP, ao vivo a fonte afirmou que não há Visita técnica 5521 tipo visita\_tecnica · espelha o sistema de campo - data 23/09, de manhã sim há 2 h · sistema de campo vencido para afirmar: releia antes de dizer - técnico confirmado não observado não observado ninguém observou “não conferido” não vira “não” - peça em estoque defeito conhecido defeito da fonte há 10 min · estoque o tipo declara que esse campo dessa fonte vem errado O que o agente não pode afirmar com esse dado - a data da visita - se o técnico está confirmado - se a peça está em estoque Sem modelo de IA na leitura, e sem consulta ao banco com o estado quente. O bloco de estado vai no mesmo pedido do contexto e passa pelo mesmo nível de verificação. - Declarado pela sua empresa ou derivado do esquema do seu banco, com a impressão digital do esquema: quando ele muda, a Niadra abre um problema de dados e avisa - Quatro valores lógicos: sim, não, não observado e defeito conhecido da fonte. “Não conferido” nunca vira “não” - Frescor por campo, calculado na leitura: um preço envelhece em segundos, um cadastro em dias, e uma declaração nova vale para todos os objetos de uma vez - Uma cotação vence na hora em que um dado dela muda, não quando passa o prazo - Fontes com precedência: o sistema de registro vence o snapshot, e o que uma ferramenta mostrou ao agente também é estado, com a proveniência - O bloco de estado vai no mesmo pedido do contexto e passa pelo mesmo nível de verificação: numa conversa em V0, nada do cliente - Acesso por campo: um campo sensível nunca entra no texto do contexto, e o agente que precisa dele lê pela finalidade, sob a regra do campo Antes de dizer um valor, o agente pergunta se pode ``` from niadra import Niadra, phone from niadra.resolvers import Resolved def requote(ref, fields): # your own read of the quote, inside your company quote = quoting_system.read(ref.id) picked = {k: v for k, v in quote.items() if not fields or k in fields} return Resolved(picked, version=7) niadra = Niadra(channel="whatsapp") niadra.resolvers.register("health_quote", requote) customer = phone(customer_phone) with niadra.conversation( thread_id, subject=customer, agent_id="sales" ) as conversation, conversation.turn(): verdict = conversation.verify_claim( "health_quote:op:q-77", "price_full", 511.06 ) if verdict.claim_safe: # said only because it may be claimed now reply = f"The plan is {verdict.value:.2f} a month." else: reply = "Let me confirm the current price and get back to you." ``` - Python - TypeScript Trecho de examples/object\_state.py do SDK: um valor só é dito quando pode ser afirmado agora, e um valor velho é relido pela sua própria função, dentro da sua empresa. ### Na documentação - [Tipos de objeto e estado(abre docs.niadra.com)](https://docs.niadra.com/concepts/object-types) - [Derivar tipos do seu banco(abre docs.niadra.com)](https://docs.niadra.com/guides/derive-types) - [O worker de resolução(abre docs.niadra.com)](https://docs.niadra.com/guides/resolver-worker) - [Ler objetos tipados, na referência da API(abre docs.niadra.com)](https://docs.niadra.com/api/state-read) ## Uma memória, treze produtos Conectar O que entra na memória - [SistemasOs eventos que os seus sistemas já emitem, ligados ao cliente certo.](/produtos/sistemas) SDK, API e MCP 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)](https://docs.niadra.com) Lembrar O que a memória sabe - [MemóriaO que foi dito e feito, com data, origem e evidência.](/produtos/memoria) - [IdentidadePessoas, empresas e parceiros, reconhecidos em qualquer canal.](/produtos/identidade) - [PadrõesO que cada cliente repete, calculado do histórico e entregue a todo agente.](/produtos/padroes) - EstadoVocê está aquiO que vale agora para cada cliente, com a idade e a fonte de cada valor. Entregar O que cada agente recebe - [ContextoO que cada agente precisa saber antes de começar.](/produtos/contexto) - [HistóricoTudo o que já aconteceu, para o agente consultar.](/produtos/historico) - [AvisosUm webhook assinado para o seu sistema na hora em que algo acontece.](/produtos/avisos) - [AfirmaçãoO que o agente pode afirmar, e a conferência do que ele afirmou, sem modelo a mais.](/produtos/afirmacao) - [CoordenaçãoQuem está com o cliente agora e o que já foi feito, antes de um agente agir.](/produtos/coordenacao) Governar O que o seu time controla - [MediçãoSe cada agente usou o contexto que recebeu.](/produtos/medicao) - [RegistroPor que o agente fez o que fez, turno a turno, e o replay no seu CI.](/produtos/registro) - [ConsoleQuem leu o quê, revisão, exportação e apagamento.](/produtos/console)