O contrato entre máquinas

Perguntas frequentes

O que é JSON Schema e para que serve numa automação com IA?

JSON Schema é um documento, também em JSON, que descreve o que um JSON válido pode conter, como um regulamento da ficha. Ele resolve um problema que o JSON sozinho não resolve: uma ficha bem formatada pode ser absurda, como um pedido de banana com zero quilo. No schema se declara o que não pode faltar, os limites mínimo e máximo de cada número e a recusa de qualquer campo não previsto. Com isso, o pedido absurdo para com uma mensagem dizendo onde está o erro e vai para revisão manual, em vez de ser faturado. O sistema não conserta o JSON sozinho.

A saída estruturada dos modelos garante que a resposta da IA está certa?

Não. A saída estruturada ajuda a cumprir o formato, mas não garante conteúdo verdadeiro: o formato pode vir certo e o número errado. Os grandes provedores permitem enviar o schema junto com o pedido e restringem a geração para seguir aquele formato. Segundo a documentação consultada pelo livro em 28/09/2026, eles diferem no que aceitam: uma regra de valor mínimo pode ser respeitada pela restrição de um provedor e deixada de fora pela de outro. A conclusão não depende de fornecedor: use a saída estruturada para reduzir erro de formato e valide sempre do seu lado, com o seu schema completo.

O que é idempotência e como ela evita pedidos duplicados em webhooks?

Uma operação é idempotente quando fazê-la duas vezes tem o mesmo efeito que fazê-la uma. Plataformas de automação reenviam chamadas quando não recebem confirmação a tempo, e isso é bom, porque impede que um pedido se perca. O erro é quem recebe tratar o reenvio como pedido novo e emitir duas notas. A técnica é a chave de idempotência: o emissor manda um identificador que é o mesmo em todos os reenvios, e o receptor grava a chave antes de processar; se ela já existe, devolve a resposta guardada. A chave deve vir de algo que não muda, como o identificador da mensagem no canal de origem, e sobreviver ao reinício do receptor.