Рекомендации разработчика · модели DeepSeek
Режим размышлений DeepSeek
Пересказ на русском. Оригинал: «Thinking Mode» ↗ — DeepSeek, на английском.
Как включать размышления у моделей DeepSeek через API, какие настройки в этом режиме не действуют и что обязательно возвращать модели в следующих запросах.
Коротко
- Размышления включены по умолчанию, глубина по умолчанию высокая.
- Глубина задаётся одним из трёх уровней:
low,highилиmax. temperatureи штрафы за повторы в этом режиме ничего не меняют.- Если в запросе есть инструменты, возвращайте модели её рассуждения за все ходы, иначе API вернёт ошибку 400.
Как включить и выбрать глубину
Параметры зависят от формата, в котором вы отправляете запрос:
- OpenAI:
thinkingвключает и выключает режим,reasoning_effortзадаёт глубину. Через SDK OpenAI параметрthinkingпередают в полеextra_body. - Anthropic: один параметр
reasoning.effort: значениеnoneвыключает режим,low,highиmaxзадают глубину. - Responses API: глубину задаёт
output_config.effort.
Другие значения API принимает, но сводит к трём своим:
minimalиlowработают какlow;medium,highиxhigh— какhigh;maxиultra— какmax.
Какие настройки не действуют
temperature,presence_penaltyиfrequency_penaltyв режиме размышлений игнорируются.top_pработает только в режиме размышлений и только в пределах от 0.95 до 1.0: меньшее значение считается за 0.95.- Без размышлений
top_pвсегда равен 1.0.
Что возвращать модели
Рассуждения приходят в отдельном поле reasoning_content, ответ — в поле content. Что делать с рассуждениями дальше, зависит от того, передаёте ли вы модели инструменты (параметр tools):
- Без инструментов: возвращать
reasoning_contentне нужно — API его проигнорирует. - С инструментами: возвращайте
reasoning_contentвсех прошлых ходов целиком, даже тех, где модель ничего не вызывала. Так она продолжает прежнюю мысль между вызовами.
Вместодобавлять в историю только текст ответа, content
Лучшедобавлять сообщение модели целиком — content, reasoning_content и tool_calls
Источник: Thinking Mode (DeepSeek). Пересказ ИИтак.