Создание 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"). Верните ходы без изменений.
Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке
Это упражнение откроется скоро
Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.
Этот браузер блокирует cookies для learn.floati.life, поэтому завершенные здесь уроки не могут открыться по порядку. Разрешите cookies для этого сайта и перезагрузите страницу.