Temario Lección 115 de 250 · Llamar a un LLM de verdad
Llamar a un LLM de verdad

Construir el cuerpo de los mensajes

Cada llamada a un modelo de chat no es más que una petición HTTP que lleva un cuerpo JSON, y que ese cuerpo esté bien es lo primero que hace el código real. A lo largo de este módulo vas a construir a mano, con Python sin más, los diccionarios y las listas exactos que consume y devuelve la API de Anthropic -> así todo funciona sin conexión y se puede corregir. Cada lección también te enseña la única línea real que ejecutarías con una clave de API en tu propio equipo. Las formas que construyes aquí SON las formas que viajan por la red.

Con el SDK instalado, enviar un mensaje es así (solo como ilustración -> aquí no llamamos a la red):

import anthropic
client = anthropic.Anthropic()   # reads ANTHROPIC_API_KEY from the environment
resp = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    system="You are a terse assistant.",
    messages=[{"role": "user", "content": "Hello"}],
)

Fíjate en la forma: system es su propio campo de nivel superior (NO es un mensaje), y messages es una lista de turnos, cada uno un diccionario con un role y un content. Los únicos roles válidos dentro de messages son "user" y "assistant", alternándose como en una conversación. Un fallo habitual es poner las instrucciones en un turno {"role": "system", ...} al principio de messages, como hacen otras API. La API de Anthropic rechaza un turno de sistema como primer mensaje: el prompt del sistema tiene su propio sitio de nivel superior. (Los modelos de Claude recientes sí aceptan un mensaje de sistema más adelante en una conversación, para una instrucción que llega a mitad, pero es una función avanzada; este curso siempre usa el sitio de nivel superior, así que tu build_request rechaza cualquier turno de sistema.)

Vas a construir build_request(system, messages, model="claude-opus-5-5", max_tokens=1024). Devuelve el diccionario de la petición:

{"model": ..., "max_tokens": ..., "system": ..., "messages": [...]}
  • Copia tal cual model y max_tokens, y pon system en su propia clave.
  • Para cada turno de messages, comprueba que el rol es exactamente "user" o "assistant". Cualquier otra cosa (un turno "system", una errata como "User", un rol que falta) tiene que lanzar un ValueError -> falla de forma ruidosa antes de llegar a la API y gastar un viaje de ida y vuelta.
  • Devuelve los turnos de messages sin cambios (en el mismo orden, con el mismo contenido).

Esta es la llamada real que harías con el diccionario que acabas de construir; el ** desempaqueta el diccionario en argumentos con nombre:

resp = client.messages.create(**build_request("Be brief.", history))

Constrúyelo de forma que dos pares (system, messages) distintos produzcan dos diccionarios de petición distintos, y que un turno con un rol que no sea user ni assistant lance un error.

Tu turno

Escribe build_request(system, messages, model="claude-opus-5-5", max_tokens=1024), que devuelve el diccionario de petición con la forma de Anthropic {"model", "max_tokens", "system", "messages"}. messages es una lista de turnos {"role", "content"}. Comprueba que cada rol es exactamente "user" o "assistant" y lanza un ValueError con cualquier otra cosa (incluido un turno "system" colado). Devuelve los turnos sin cambios.

¿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.