Программа курса Урок 115 из 250 · Вызов реальной LLM
Вызов реальной LLM

Создание Messages Payload

Каждый вызов чат модели это просто HTTP запрос с телом JSON, и правильное формирование этого тела это первое, что делает настоящий код. В этом модуле вы будете вручную создавать именно те dicts и lists, которые принимает и возвращает Anthropic API, используя простой Python -> так всё будет работать офлайн и можно будет оценить. Каждый урок также показывает одну реальную строку, которую вы запустили бы с API ключом на своей машине. Структуры, которые вы строите здесь, это те самые структуры, которые передаются по сети.

После установки SDK отправка сообщения выглядит так (только для иллюстрации -> мы не вызываем сеть здесь):

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"}],
)

Обратите внимание на структуру: system это поле верхнего уровня (это НЕ сообщение), а messages это список ходов, каждый из которых является dict с role и content. Единственные допустимые роли внутри messages это "user" и "assistant", которые чередуются как в разговоре. Распространенная ошибка это размещение инструкций в {"role": "system", ...} ходе в начале messages, как это делают некоторые другие API. Anthropic API отказывается принимать системный ход как первое сообщение: системный промпт имеет свой собственный слот верхнего уровня. (Недавние модели Claude принимают системное сообщение позже в разговоре для инструкции, которая приходит в середине, но это продвинутая функция; этот курс всегда использует слот верхнего уровня, поэтому ваш build_request отклоняет любой системный ход.)

Вы строите build_request(system, messages, model="claude-opus-5-5", max_tokens=1024). Она возвращает request dict:

{"model": ..., "max_tokens": ..., "system": ..., "messages": [...]}
  • Скопируйте model и max_tokens как есть, а system положите в отдельный ключ.
  • Для каждого поворота в messages проверяйте, что роль соответствует точно "user" или "assistant". Все остальное (поворот "system", опечатка типа "User", отсутствие роли) должно вызывать ValueError -> громко сообщать об ошибке до того, как вы обратитесь к API и потратите один цикл.
  • Верните ходы в messages без изменений (тот же порядок, то же содержание).

Вот реальный вызов, который вы сделали бы с dict, который вы только что построили; ** распаковывает dict в keyword arguments:

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

Сделайте так, чтобы две разные пары (system, messages) создавали два разных request dicts, и ход с ролью, отличной от user или assistant, вызывал ошибку.

Твоя очередь

Напишите build_request(system, messages, model="claude-opus-5-5", max_tokens=1024), который возвращает словарь запроса в формате Anthropic {"model", "max_tokens", "system", "messages"}. messages это список ходов {"role", "content"}. Проверьте, чтобы каждая роль была строго "user" или "assistant", и вызовите ValueError на чем угодно другом (включая спрятанный ход "system"). Верните ходы без изменений.

Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке

Это упражнение откроется скоро

Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.