Структура Messages API

Роли system/user/assistant, content-блоки (текст, изображение), как устроен многоходовый диалог.

22 мин чтения2 вопроса в квизеГотовый промпт включёнВ работе

Практическое задание

Что сделать после урока

Соберите диалог из 3 ходов вручную (user/assistant/user), отправьте и убедитесь, что модель помнит контекст из первого хода. Затем добавьте system-инструкцию и сравните тон ответа.

Готовый промпт

Шаблон под задачу урока

Скопируйте и адаптируйте под свой контекст. Текст в треугольных скобках — то, что нужно заменить.

Помоги спроектировать структуру messages для моего сценария.
Сценарий: <чат-бот / агент / классификатор>
Нужна ли память диалога: <да/нет>
Формат ответа: <текст / JSON>

Покажи правильную структуру system + messages[] и как добавлять ходы.

Типичные ошибки

На чём чаще всего спотыкаются

Три роли

system — отдельный top-level параметр system, не элемент массива messages. Задаёт инструкции и поведение.

user — реплики пользователя.

assistant — ответы модели. Их вы добавляете обратно в историю для следующего хода.

const res = await client.messages.create({ model: "claude-sonnet-4-5", max_tokens: 1024, system: "Ты лаконичный технический ассистент. Отвечай по делу.", messages: [ { role: "user", content: "Что такое идемпотентность?" }, ], });

Content может быть строкой или массивом блоков

Короткий вариант — строка. Полный — массив блоков (нужен для картинок, документов, кэширования):

messages: [ { role: "user", content: [ { type: "text", text: "Что на картинке?" }, { type: "image", source: { type: "base64", media_type: "image/png", data: "<base64>" }, }, ], }, ];

Многоходовый диалог

Messages API stateless — сервер не помнит историю. Вы сами передаёте весь массив на каждый запрос:

const history = [ { role: "user", content: "Меня зовут Макс." }, { role: "assistant", content: "Приятно познакомиться, Макс." }, { role: "user", content: "Как меня зовут?" }, // модель ответит "Макс" ];

Правила: сообщения чередуются user/assistant, первое — всегда user, последнее обычно user. Два user-сообщения подряд недопустимы.

Сообщить об ошибке

Структура Messages API

Квиз — 2 вопроса

Три роли

Content может быть строкой или массивом блоков

Многоходовый диалог

Префилл ответа ассистента