Aula 3 · 18 min
Ficha de catálogo, corpo de notícia, resumo de página: o agente escreve a partir de uma fonte, em lote. O risco é ele enfeitar e inventar. Aqui você chama o modelo pela assinatura, em modo só de leitura, lê o primeiro JSON da resposta e passa tudo por uma trava que descarta o item inventado.
Começar a aula
Objetivo: chamar o Codex ou o Claude pela assinatura para extrair de uma fonte e descartar, sem consertar, o item que falha na trava.
Clique em cada bloco.
O modelo pode reescrever e organizar; a trava garante que ele não criou fatos.
Clique em cada passo.
O gerador de textos de notícias do INEMA chama o Codex com o pedido pela entrada padrão, sandbox só de leitura, sessão efêmera e saída num arquivo. Feche a entrada depois de mandar o pedido: sem isso o processo fica esperando.
No Claude Code, o mesmo pedido roda na pasta do projeto, com o AGENTS.md proibindo escrita fora da pasta de saída.
Em 02/10/2026, respostas do Codex com o JSON duplicado quebraram a leitura do lote. A menor correção foi ler só o primeiro objeto completo (a função primeiroJson).
Não foi trocar de modelo nem reescrever o gerador: uma proteção de dez linhas.
Das 159 notícias, 113 ganharam corpo de texto. As 46 sem texto ficaram assim porque a fonte exige login (25), tem pouco texto (18) ou deu 404 (1), e ficam com noindex, fora do sitemap.
Ninguém escreveu o que faltava à mão: melhor uma página a menos do que uma página com fato inventado.
A primeira rodada de fichas usou API autorizada: 40 fichas extraídas e validadas por US$ 0,031. Os lotes seguintes passaram para o Codex pela assinatura.
A trava é a mesma nos dois caminhos; o que muda é quem paga a chamada.
pedido.txt = prompt extrativo (curso 2, aula 5) + o texto da fonte. valida-ficha.mjs é um modelo que usa a biblioteca do validar_extracao.mjs.
codex exec --skip-git-repo-check --ephemeral --sandbox read-only -C "$PWD" -o saida.txt - < pedido.txt node valida-ficha.mjs fonte.txt saida.txt
// passa cada item da ficha pela trava (usa validar_extracao.mjs como biblioteca)
import fs from 'node:fs'
import { apoiada, numerosNaFonte, tituloNaFonte } from './validar_extracao.mjs'
const [fonteArq, fichaArq] = process.argv.slice(2)
const fonte = fs.readFileSync(fonteArq, 'utf8')
const ficha = JSON.parse(fs.readFileSync(fichaArq, 'utf8'))
let validos = 0
for (const m of ficha.estrutura || []) {
const ok = tituloNaFonte(m.titulo, fonte) && numerosNaFonte(m.detalhe || '', fonte)
console.log(`${ok ? '✓' : '✗ descarta'} módulo: ${m.titulo}`)
if (ok) validos++
}
for (const campo of ['aprende', 'publico', 'constroi']) {
for (const f of ficha[campo] || []) {
const ok = apoiada(f, fonte) && numerosNaFonte(f, fonte)
console.log(`${ok ? '✓' : '✗ descarta'} ${campo}: ${f}`)
}
}
console.log(validos >= 3 ? `ficha enriquecida (${validos} módulos válidos)` : `não publica como enriquecida (${validos} módulos válidos)`)function primeiroJson(txt) {
const ini = txt.indexOf('{')
let prof = 0, str = false, esc = false
for (let i = ini; i < txt.length; i++) {
const c = txt[i]
if (str) { if (esc) esc = false; else if (c === '\\') esc = true; else if (c === '"') str = false; continue }
if (c === '"') str = true
else if (c === '{') prof++
else if (c === '}' && --prof === 0) return JSON.parse(txt.slice(ini, i + 1))
}
throw new Error('JSON incompleto')
}$ node valida-ficha.mjs fonte.txt saida.txt ✓ módulo: Módulo 1: Preparar o barro ✓ módulo: Módulo 2: Centralizar no torno ✓ módulo: Módulo 3: Abrir e levantar a peça ✓ módulo: Módulo 4: Acabamento e secagem ✓ aprende: Amassar, tirar o ar e pesar as bolas de argila. ✓ publico: quem nunca sentou num torno e quer fazer as primeiras peças utilitárias. ✓ constroi: copos e tigelas simples, prontos para esmaltar. ficha enriquecida (4 módulos válidos)
Trecho. A fonte era a página de exemplo de um curso de cerâmica de torno, com 4 módulos e "8 encontros de 3 horas".
$ node valida-ficha.mjs fonte.txt saida-livre.txt ✗ descarta módulo: Módulo 1 — Prepare o barro para suas primeiras peças ✗ descarta módulo: Módulo 2 — Encontre o centro no torno ✗ descarta módulo: Módulo 3 — Dê forma ao seu primeiro copo ✗ descarta módulo: Módulo 4 — Cuide do acabamento e da secagem ✓ aprende: Posicionar mãos e corpo para centralizar o barro no torno. ✗ descarta constroi: Seu primeiro copo modelado no torno. não publica como enriquecida (0 módulos válidos)
Trecho. Mesma fonte, mas o pedido foi "escreva a ementa de forma atraente". O modelo reescreveu todos os títulos e, no módulo 4, somou "totalizando 24 horas": o número não está na fonte.
Escolha um item do seu site que tem página própria com texto.
Salve o texto da página em fonte.txt, monte o pedido.txt com o prompt extrativo e rode a chamada do Codex (ou o mesmo pedido no Claude Code). Repita com um pedido livre, "de forma atraente", para comparar.
Pronto quando: você tem saida.txt e saida-livre.txt, as duas em JSON, e nenhuma chave de API foi usada.
Copie o validar_extracao.mjs e o valida-ficha.mjs para a pasta e rode nas duas saídas. Anote o que foi descartado e por quê.
Pronto quando: uma anotação lista cada item descartado com o motivo (título, palavras ou número fora da fonte), e só a ficha com 3 ou mais módulos válidos está marcada para publicar.
A explicação aparece depois da sua resposta.
Pergunta 1 de 4
Para que serve a opção de sandbox só de leitura na chamada do Codex?competência
Pergunta 2 de 4
No pedido "atraente", o modelo escreveu "totalizando 24 horas". A fonte dizia 8 encontros de 3 horas. O que a trava faz?
Pergunta 3 de 4
Respostas do modelo vieram com o JSON duplicado e o lote quebrou. Qual foi a menor correção?
Pergunta 4 de 4
46 notícias ficaram sem corpo de texto porque a fonte exigia login, tinha pouco texto ou deu 404. O que foi feito com elas?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.