A Tese Original, Reafirmada

Decisões de IA merecem recibos. Registro não é responsabilidade. Cadeia de pensamento não é verdade fundamental.

Essas afirmações continuam verdadeiras. Mas estão incompletas.

A pergunta "Por que devemos capturar decisões?" tem uma resposta óbvia: conformidade, responsabilidade, depuração. A pergunta mais difícil é: "O que acontece quando fazemos isso?"

A resposta é inesperada: a memória institucional se torna automática. Não como uma característica que você constrói em cima. Não como um módulo que você adiciona depois. Como uma consequência natural do modelo de dados.

O que "Decisão" Realmente Significa

Uma decisão não é a saída do modelo. Não é a resposta da API. Não é o valor de retorno da função.

Uma decisão é um artefato estruturado que contém:

O que os logs não dizem a você

Os Dois Primitivos

Todo o sistema de rastreamento de decisões repousa em duas primitivas:

Por que o Normativo Supera o Descritivo

Os gráficos de contexto armazenam relações descritivas: "relacionado a," "menciona," "pertence a." Os gráficos de argumentos de decisão armazenam relações normativas: "apoia," "se opõe."

A distinção é fundamental:

Como o Precedente Surge (Mecanicamente)

De Armazenado a Recuperável: Decisões como um Gráfico

Capturar decisões é apenas metade do valor. A outra metade é recuperá-las — e é aí que o modelo de dados justifica seu valor. Como cada decisão é armazenada como um gráfico de argumentos normativos (afirmações conectadas por arestas de apoia/opõe), torna-se um substrato de recuperação de primeira classe, não apenas um arquivo.

Aponte uma busca vetorial para logs brutos e você obtém "sopa de fragmentos" — trechos desconectados que citam uma conclusão, mas deixam de lado o contra-argumento, o aprovador e o precedente. Recupere do gráfico de decisão em vez disso e você obtém um Pacote de Decisão delimitado: a proposição, o raciocínio a favor e contra, as evidências e o resultado, intactos. Isso é GraphRAG para decisões de IA — a razão pela qual o precedente é algo que você pode consultar e citar, não apenas algo que você espera lembrar. (Mais sobre o substrato de recuperação: o que é recuperação de decisão.)

Os Três Modos de Confiança

As empresas não entregam decisões à IA da noite para o dia. Elas progridem através de modos:

O Que Isso Significa Para A Pilha de IA Empresarial

PILHA DE CONTEXTO EMPRESARIAL

Três maneiras de se conectar — o SDK é apenas uma.

O rastreamento de decisões não é um contrato de consultoria de 6 meses — e não requer nosso SDK. Existem três maneiras de se conectar:

O caminho do SDK é o mais curto para escrever — um rastro de decisão em cerca de dez linhas:

from aiagentree import AgentreeClient

client = AgentreeClient(api_key="ask_...", base_url="https://api.aiagentree.com", tenant_id="acme")

# Trace your agent's decision point
trace = client.start_trace(
    agent_id="discount-agent",
    workflow_id="discount_approval",
    entity_type="request",
    entity_id="4521",
)
trace.add_input("discount", 0.18, source="crm")
trace.add_step("s1", title="SEV-1 incident yesterday", category="evidence", confidence=0.9)
trace.add_step("s2", title="Customer flagged as churn risk", category="evidence", confidence=0.85)
trace.add_step("s3", title="Exceeds standard 15% threshold", category="risk", confidence=0.7)
trace.seal("d1", action="approved", confidence=0.9)

O registro é selado, carimbado com data e consultável. Quando a próxima solicitação semelhante chegar, esse precedente é recuperável e citável.

O Ângulo de Conformidade

O Ato de IA da UE impõe requisitos específicos para sistemas de IA de alto risco:

O que o Rastreio de Decisões NÃO Resolve

A rastreabilidade de decisões está acima de contexto operacional. Não substitui:

Como Começar