Clase 3 · 18 min
Ficha de catálogo, cuerpo de noticia, resumen de página: el agente escribe a partir de una fuente, en lote. El riesgo es que adorne e invente. Aquí llamas al modelo por la suscripción, en modo de solo lectura, lees el primer JSON de la respuesta y lo pasas todo por un control que descarta el ítem inventado.
Comenzar la lección
Objetivo: llamar al Codex o a Claude por la suscripción para extraer de una fuente y descartar, sin arreglar, el ítem que falla en el control.
Toca cada bloque.
El modelo puede reescribir y organizar; el control garantiza que no creó hechos.
Toca cada paso.
El generador de textos de noticias de INEMA llama al Codex con el pedido por la entrada estándar, sandbox de solo lectura, sesión efímera y salida en un archivo. Cierra la entrada después de mandar el pedido: sin eso el proceso se queda esperando.
En Claude Code, el mismo pedido corre en la carpeta del proyecto, con el AGENTS.md prohibiendo escribir fuera de la carpeta de salida.
El 02/10/2026, respuestas del Codex con el JSON duplicado rompieron la lectura del lote. La corrección mínima fue leer solo el primer objeto completo (la función primeiroJson).
No fue cambiar de modelo ni reescribir el generador: una protección de diez líneas.
De las 159 noticias, 113 ganaron cuerpo de texto. Las 46 sin texto quedaron así porque la fuente exige login (25), tiene poco texto (18) o dio 404 (1), y quedan con noindex, fuera del sitemap.
Nadie escribió a mano lo que faltaba: mejor una página menos que una página con un hecho inventado.
La primera ronda de fichas usó una API autorizada: 40 fichas extraídas y validadas por US$ 0,031. Los lotes siguientes pasaron a Codex por la suscripción.
El control es el mismo en los dos caminos; lo que cambia es quién paga la llamada.
pedido.txt = prompt extractivo (curso 2, clase 5) + el texto de la fuente. valida-ficha.mjs es un modelo que usa la biblioteca de 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
// pasa cada ítem de la ficha por el control (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)
Fragmento. La fuente era la página de ejemplo de un curso de cerámica de torno, con 4 módulos y "8 encuentros 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)
Fragmento. La misma fuente, pero el pedido fue "escribe el temario de forma atractiva". El modelo reescribió todos los títulos y, en el módulo 4, sumó "totalizando 24 horas": el número no está en la fuente.
Elige un ítem de tu sitio que tenga página propia con texto.
Guarda el texto de la página en fonte.txt, arma el pedido.txt con el prompt extractivo y ejecuta la llamada de Codex (o el mismo pedido en Claude Code). Repite con un pedido libre, "de forma atractiva", para comparar.
Listo cuando: tienes saida.txt y saida-livre.txt, las dos en JSON, y no se usó ninguna clave de API.
Copia validar_extracao.mjs y valida-ficha.mjs a la carpeta y ejecútalos en las dos salidas. Anota qué se descartó y por qué.
Listo cuando: una anotación lista cada ítem descartado con el motivo (título, palabras o número fuera de la fuente), y solo la ficha con 3 o más módulos válidos está marcada para publicar.
La explicación aparece después de tu respuesta.
Pregunta 1 de 4
¿Para qué sirve la opción de sandbox de solo lectura en la llamada de Codex?competencia
Pregunta 2 de 4
En el pedido "atractivo", el modelo escribió "totalizando 24 horas". La fuente decía 8 encuentros de 3 horas. ¿Qué hace el control?
Pregunta 3 de 4
Las respuestas del modelo llegaron con el JSON duplicado y el lote se rompió. ¿Cuál fue la corrección mínima?
Pregunta 4 de 4
46 noticias quedaron sin cuerpo de texto porque la fuente exigía login, tenía poco texto o dio 404. ¿Qué se hizo con ellas?
Elige una alternativa. La explicación aparece después de tu intento.