Temario Lección 248 de 250 · Trabajar con las respuestas del modelo
Trabajar con las respuestas del modelo

Comprueba una llamada a herramienta antes de ejecutarla

Por qué importa Una llamada a herramienta es el modelo pidiendo a tu código que actúe: reservar, pagar, borrar. El modelo rellena los argumentos a partir de una conversación, y puede equivocarse. Hacer una reserva para "Friday" o para veinte personas en un restaurante con doce plazas es un fallo real con un coste real.

La herramienta que se le dio al modelo:

{"name": "book_table",
 "input_schema": {"type": "object", "required": ["date", "time", "party_size"],
   "properties": {"date": {"type": "string", "description": "YYYY-MM-DD"},
                  "time": {"type": "string", "description": "HH:MM, 24-hour"},
                  "party_size": {"type": "integer", "description": "1 to 12"}}}}

Seis respuestas, cada una un patrón que producen los modelos reales: una llamada correcta; una llamada con "Friday" donde se requería una fecha; party_size como la cadena "2"; una llamada a la que le falta time; un grupo de 20 (la descripción dice de 1 a 12, y una descripción es una petición, no una garantía); y ninguna llamada a herramienta, porque el modelo le hizo antes una pregunta al usuario, que a menudo es lo correcto.

Tu trabajo es la barrera: decidir si ejecutar la herramienta, devolverle los problemas al modelo para que los corrija o pasarle la pregunta al usuario. (Con strict: true en la definición de la herramienta, la API garantiza los tipos y los campos obligatorios, pero no que los valores tengan sentido; el rango y que la fecha sea real te toca comprobarlos siempre a ti.)

Sobre estas respuestas: son simuladas. Cada una se escribió para este curso exactamente con la forma que devuelve la API Messages de Claude (bloques de contenido, stop_reason, usage), y cada una copia algo que hacen los modelos reales. No son grabaciones de un modelo en vivo, así que la redacción exacta es nuestra; las formas y los problemas son los reales con los que se encontrará tu código.

Tu turno

Escribe gate_booking(reply). Si la respuesta no tiene ningún bloque tool_use, devuelve {"action": "ask_user", "text": ...} con el texto unido. Si no, toma la primera llamada a book_table y comprueba su entrada: que estén todas las claves obligatorias; que date sea una fecha real escrita YYYY-MM-DD; que time esté escrito HH:MM con horas de 00 a 23 y minutos de 00 a 59; que party_size sea un int real (no una cadena, no True) de 1 a 12. Devuelve {"action": "run", "input": ...} cuando todo pase, y si no {"action": "fix", "errors": [...]} con un mensaje por problema, cada mensaje nombrando el campo al que se refiere. Deja REPLIES del código inicial como está: la comprobación lo lee.

¿Has visto un problema en esta lección? Avísanos · Preguntar sobre esta lección

Este ejercicio se abre pronto

Termina la lección anterior y esta se desbloquea. Todo el curso es gratis, no hace falta cuenta, y puedes leer esta lección ahora mismo.