Pergunte como você fala

Uma pergunta em português, e a resposta volta com o endereço de onde saiu

Você pergunta como perguntaria a alguém do time: quais slides falam de margem bruta, o que o contrato diz sobre rescisão, em que aba está o custo por unidade. Sem sintaxe, sem campo de busca, em português. O agente responde a partir do que o motor já leu e mediu na entrada, e traz junto o endereço: o slide, a nota, a seção, a aba. A conversa fica com você, no seu cofre, e nada do que ele responde é construído com dados de outra empresa.

Quais slides falam de margem bruta?

Dois: o slide 12 (Resultados Q3) e o slide 34 (Apêndice). No 12, a nota do apresentador traz o número consolidado do trimestre.fontes: slide 12 · nota do slide 12 · slide 34

E na versão em inglês, o título do 12 ficou como?

"Q3 Results: Consolidated Gross Margin". A tradução está lado a lado com o original no seu cofre.fonte: tradução en-US · slide 12

Duas perguntas, duas respostas, e cada uma com o endereço de onde veio.

Um chatbot genérico te dá uma resposta; um agente com fonte te dá uma afirmação que você consegue checar. A fonte é um endereço no seu cofre, e o clique abre o slide 12 com as notas e os comentários em volta. É a diferença entre uma impressão e um fato.

A conversa é com a IA

Quem mexe no arquivo é o motor, e essa divisão é a origem de tudo

A camada que conversa entende o que você quer e escolhe a operação; a que mexe no arquivo é um motor determinístico que executa uma especificação sobre uma estrutura conhecida. Por isso o pior erro possível da IA continua sendo um erro de conversa, e aparece no recibo em vez de aparecer no arquivo. A tradução é o único ponto em que o texto do modelo chega mesmo ao documento, e ali a fronteira é conferida em vez de presumida. Como isso funciona, e o que acontece quando a contagem não bate, está em [a conversa é com a IA](docs-by-spec).

Interfaces

Na tela do cofre, no cliente de IA que você já usa, ou pela API do seu time

A mesma conversa acontece em três lugares, e o cofre atrás dos três é um só. O canal por onde um cliente de IA fala com ele é padrão aberto: responde 401 sem credencial, que é o comportamento correto, e publica a descoberta para qualquer cliente ler sozinho. O que isso habilita não é encanamento: é o seu time construindo painel, fluxo e automação sobre o mesmo substrato, sem a gente na sala. As três portas, e por que mudar de porta não muda o dono do cofre, estão em [interfaces](interfaces).

Capacidades

O que ele faz, o que ele recusa, e o contrato que mantém o conjunto único

Quando algo não está nos seus documentos, o agente diz que não está. Ele não completa, não resume o que não leu, não preenche o silêncio com uma ficção plausível. Para quem responde a um auditor, *não está no material* é funcionalidade e não falha. E o conjunto de operações não muda de tamanho conforme a porta: o que o agente expõe é subconjunto do que a API expõe, por contrato. O que ele faz hoje, o que ele recusa, e as três perguntas que uma capacidade responde antes de virar frase servida, estão em [capacidades](capabilities).