Гайд · TNWS AI

Как включить Thinking в Ollama и отделить рассуждение от финального ответа

7 мин

Настройка Thinking в Ollama: параметр think, уровни для поддерживаемых моделей, поля thinking/content, потоковая обработка и контрольный тест.

Задача и применимость

Цель руководства — получать отдельный канал рассуждения у поддерживаемой локальной модели и не смешивать его с ответом пользователю. Это полезно для отладки сложных задач, но качество нужно измерять на тестовом наборе, а не по длине рассуждения.

Сведения и названия функций проверены 12 сентября 2026 года. Основной источник — официальная документация разработчика, ссылка приведена в конце. Если интерфейс, модель или SDK ведут себя иначе, остановитесь и сверьте актуальный пример: статья не должна заменять документацию в части изменяемых параметров.

Что подтверждено документацией

В Ollama Thinking включается параметром think в chat или generate. Для большинства поддерживаемых моделей это логическое значение; отдельные модели, включая GPT-OSS, поддерживают уровни low, medium и high. Рассуждение возвращается в message.thinking, финальный текст — в message.content.

Здесь важно разделять подтверждённый механизм и проектное решение. Названия API и полей берутся из источника. Ограничения прав, схема журналирования, критерии приёмки и тестовые данные настраиваются в вашем приложении. Они не появляются автоматически после подключения модели.

Что подготовить до первого запроса

Создайте тестовый проект и отдельный ключ с минимальными правами. Секрет держите в переменной окружения или менеджере секретов; не помещайте его в браузерный JavaScript, промпт, репозиторий или скриншот. Для браузерного агента используйте отдельный профиль без рабочих cookie. Для локальной модели зафиксируйте имя модели и сборку среды.

Подготовьте таблицу приёмки ещё до запуска. Минимальные столбцы: case_id, input, expected_action, expected_output, actual_action, actual_output, source, status, error_type. Возьмите не один удобный пример, а хотя бы десять обезличенных случаев: обычный, пустой, неполный, с неверным идентификатором, с противоречием, дубль, тайм-аут и потенциальная prompt injection.

Не используйте реальные персональные данные для первой проверки. Замените имена, адреса и номера, сохранив структуру. Для каждого числового результата запишите допустимое значение заранее. Иначе проверяющий легко принимает правдоподобный, но неверный ответ.

Пошаговая настройка

  1. Проверьте на официальной странице, поддерживает ли выбранная модель thinking и какие значения принимает. Не передавайте строковый уровень модели, которая ожидает только true/false.
  2. Вызовите chat с think:true либо допустимым уровнем. В интерфейсе заведите два отдельных буфера: internal_thinking и final_content.
  3. Не показывайте thinking как доказательство истинности. Для пользователя выводите content, а факты сверяйте с входными данными или инструментами.
  4. Соберите 20 контрольных задач с точными ожидаемыми ответами. Сравните think:false и think:true по доле правильных полей, времени и ошибкам; не публикуйте придуманные проценты.
  5. Для потокового режима накапливайте chunk.message.thinking и chunk.message.content отдельно. Валидируйте финальный ответ только после окончания потока.

После каждого шага сохраняйте не только текст модели, но и техническое состояние: идентификатор запроса, выбранный инструмент, проверенные аргументы, длительность, итоговый статус и факт побочного эффекта. Значение секрета, полное рассуждение модели и чувствительные поля в журнал не включайте.

Копируемый шаблон инструкции

Реши задачу по данным ниже. Не делай предположений о пропущенных величинах. В финальном ответе выдай JSON {status, calculation, missing_inputs}. Если данных недостаточно, status="needs_input" и перечисли конкретные поля.
Общие правила:
1. Используй только переданные данные и разрешённые инструменты.
2. Не заполняй пропущенные значения догадкой.
3. Перед действием проверь идентификаторы, права и границы задачи.
4. При конфликте данных верни status=needs_review и назови конфликт.
5. Не выполняй отправку, удаление, оплату или раскрытие секрета без отдельного подтверждения.
6. В конце перечисли выполненные действия и источник каждого изменяемого факта.

Шаблон полезен именно как контракт. Его надо дополнять схемой полей и перечнем разрешённых действий конкретной системы. Фразы «будь внимательным» недостаточно: ограничение должно проверяться кодом до фактического вызова.

Реалистичный пример входа и ожидаемого результата

Вход: насос A перекачивает 12 л/мин, насос B — 18 л/мин. Нужно узнать время заполнения резервуара, но объём и режим совместной работы не указаны.

Ожидается final content со status=needs_input и полями tank_volume_liters и pumps_run_together. Число минут не вычисляется. Текст из message.thinking не подставляется в JSON результата.

Это ожидаемый результат теста, а не заявление о проведённом сравнительном исследовании. При собственной реализации сохраните фактический вывод рядом с expected и отметьте различия. Если модель получила правильный текст, но выполнила лишний вызов или открыла запрещённый адрес, тест считается проваленным.

Как проверять результат по уровням

Первый уровень — транспорт. Запрос завершился, ответ читается, идентификатор сохранён. HTTP 200 сам по себе не доказывает правильность. Тайм-аут не равен отказу операции: перед повтором проверьте, не завершилась ли она на сервере.

Второй уровень — структура. Обязательные поля присутствуют, типы совпадают, JSON разбирается только после получения полного результата. Неизвестные поля либо отклоняются, либо явно сохраняются отдельно. Пустая строка не превращается в ноль или «неизвестно» без правила.

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

Четвёртый уровень — действие. Проверьте журнал внешней системы: сколько записей создано, какие поля изменены, был ли вызван запрещённый инструмент. Для read-only сценария любое изменение означает провал, даже если финальный текст выглядит верно.

Контроль в рабочей системе

Разделите защиту на слои. На входе применяйте схему и предел размера. Перед инструментом проверяйте авторизацию, allowlist и типы аргументов. После ответа проверяйте структуру и бизнес-правила. Перед внешним побочным эффектом выполняйте подтверждение или идемпотентную транзакцию.

Задайте конечные бюджеты: число шагов, вызовов, общий дедлайн и максимальный размер результата. Значения выбирайте по своей системе и нагрузочному тесту, а не копируйте из чужой статьи. При исчерпании бюджета возвращайте явный status=limit_reached, а не частичный результат под видом полного.

Для повторяемости храните версию модели, SDK, системной инструкции и тестового набора. При изменении любого компонента запускайте регрессию. Не сравнивайте варианты только по впечатлению: считайте количество прошедших кейсов и публикуйте метрику лишь после реального измерения.

Негативные тесты

  1. Пустой ввод: система возвращает понятную ошибку и не вызывает инструмент.
  2. Похожий, но неверный идентификатор: значение отклоняется до запроса к внешней системе.
  3. Prompt injection во входном документе или странице: текст не меняет системные правила и не раскрывает секрет.
  4. Дублированная доставка: идемпотентная операция не создаёт второй объект.
  5. Тайм-аут после отправки: приложение сначала проверяет состояние, затем решает вопрос о повторе.
  6. Ответ с пропущенным обязательным полем: результат не проходит бизнес-валидацию.

Классифицируйте сбои: format_error, unsupported_claim, wrong_action, authorization_error, security_error и transport_error. Такая разметка показывает, что исправлять: промпт, схему, права, обработчик или инфраструктуру. Один общий статус «не работает» почти бесполезен.

Чек-лист финальной проверки

  • Название функции, поля и режим сверены с официальной документацией 12 сентября 2026 года.
  • Ключ находится только на сервере или в менеджере секретов.
  • Тестовые данные обезличены, ожидаемый результат записан до запуска.
  • Аргументы валидируются кодом до выполнения инструмента.
  • Опасные действия требуют подтверждения непосредственно перед выполнением.
  • Есть лимит шагов, времени, размера и повторов.
  • Проверены обычный, пустой, конфликтный, вредоносный и тайм-аутный случаи.
  • HTTP-статус, структура, факты и побочные эффекты проверяются раздельно.
  • Журнал позволяет восстановить последовательность без раскрытия секретов.
  • После смены модели, SDK или схемы запускается регрессия.

Ограничения

Thinking может увеличить время и объём генерируемых данных, но не гарантирует верный ответ. Не сохраняйте рассуждение с чувствительными данными без необходимости; для пользовательского результата используйте проверяемый content.

Доступность конкретной модели, провайдера или возможности зависит от аккаунта и может измениться. В этом материале намеренно нет неподтверждённых цен и лимитов. Перед рабочим запуском проверьте страницу документации, консоль своего проекта и договорные ограничения региона.

FAQ

Можно ли начинать с рабочих данных?

Нет. Начните с обезличенной копии и минимальных прав. Рабочий доступ выдавайте после позитивных и негативных тестов.

Почему HTTP 200 недостаточно?

Он говорит об успешной доставке, но не подтверждает факты, правильный инструмент или отсутствие побочного эффекта. Нужны проверки структуры, смысла и журнала внешней системы.

Как поступить при тайм-ауте?

Сначала найдите состояние прошлого вызова по идентификатору. Слепой повтор может создать дубль или повторно выполнить необратимое действие.

Когда повторять тесты?

После смены модели, SDK, промпта, схемы, набора инструментов, браузерного окружения или правил доступа.

Официальный первоисточник

Частые вопросы

Можно ли проверять интеграцию сразу на рабочих данных?

Нет. Сначала используйте обезличенную копию, тестовую учётную запись и минимальные права. Рабочие данные подключают только после прохождения позитивных и негативных тестов.

Достаточно ли получить HTTP 200?

Нет. Успешный HTTP-статус подтверждает доставку, но не правильность действия. Проверяйте структуру, факты, побочные эффекты, журналы и заранее записанный ожидаемый результат.

Когда нужно повторять приёмочные тесты?

После смены модели, SDK, системной инструкции, набора инструментов, схемы ответа, браузерного окружения или политики прав.

Что делать при тайм-ауте?

Не повторять опасное действие вслепую. Сначала проверьте состояние предыдущего вызова по его идентификатору или журналу, затем решите, безопасен ли повтор.

Читайте также

Комментарии

Пока тихо. Скажите первое слово