Structured output e tool use
Transformar propostas probabilísticas em contratos e ações controladas. - Capítulo: Do texto à ação segura Aplicação: Caderno de campo operacional.
Do texto livre à ação controlada
Um modelo pode escrever uma resposta, produzir dados estruturados ou propor uma chamada de ferramenta, mas nenhuma dessas saídas concede permissão para alterar o mundo. Este capítulo acompanha o fechamento da OS 742 no ERP para separar modelo, harness, ferramenta e API. O leitor aprende texto livre, JSON, JSON Schema, structured output, function calling, validação, autorização, confirmação humana, efeitos colaterais, timeout, retry, idempotência, erro parcial, logs e prompt injection. Diagramas e critérios de aceite mostram como transformar uma proposta probabilística em uma operação estreita, observável e recuperável. A regra central é simples: schema valida forma; código confiável decide autoridade e execução.
Caderno de campo: uma ferramenta de ERP sob falhas reais
Este laboratório constrói, quebra e recupera uma ferramenta que solicita o fechamento de uma ordem de serviço em um ERP sintético. O modelo apenas propõe argumentos; um harness em Python valida o contrato, resolve identidade e tenant, autoriza, pede confirmação e controla o efeito. Mutações reproduzíveis demonstram argumento inválido, acesso cross-tenant, timeout depois do efeito, retry duplicado, confirmação ignorada e vazamento em log. Um painel conta propostas válidas, rejeições, bloqueios, duplicatas evitadas e confirmações negadas. Ao final, uma feature flag desliga escrita sem perder consulta. O leitor sai com evidência executável, pré-mortem, critérios de aceite e runbook, não apenas com uma demonstração feliz.