docs/docs/uk/tools/thinking.md
2026-04-17 00:30:27 +00:00

15 KiB
Raw Blame History

read_when summary title x-i18n
Налаштування розбору директив мислення, швидкого режиму або докладності чи значень за замовчуванням
Синтаксис директив для /think, /fast, /verbose, /trace і видимості міркувань Рівні мислення
generated_at model provider source_hash source_path workflow
2026-04-17T00:29:52Z gpt-5.4 openai 1cb44a7bf75546e5a8c3204e12f3297221449b881161d173dea4983da3921649 tools/thinking.md 15

Рівні мислення (директиви /think)

Що це робить

  • Вбудована директива в будь-якому вхідному тексті: /t <level>, /think:<level> або /thinking <level>.
  • Рівні (псевдоніми): off | minimal | low | medium | high | xhigh | adaptive
    • minimal → “think”
    • low → “think hard”
    • medium → “think harder”
    • high → “ultrathink” (максимальний бюджет)
    • xhigh → “ultrathink+” (GPT-5.2 + моделі Codex і зусилля Anthropic Claude Opus 4.7)
    • adaptive → adaptive-мислення під керуванням провайдера (підтримується для Anthropic Claude 4.6 і Opus 4.7)
    • x-high, x_high, extra-high, extra high і extra_high зіставляються з xhigh.
    • highest, max зіставляються з high.
  • Примітки щодо провайдерів:
    • Для моделей Anthropic Claude 4.6 за замовчуванням використовується adaptive, якщо явний рівень мислення не задано.
    • Anthropic Claude Opus 4.7 не використовує adaptive-мислення за замовчуванням. Типове значення effort у його API залишається на боці провайдера, якщо ви явно не задасте рівень мислення.
    • Для Anthropic Claude Opus 4.7 /think xhigh зіставляється з adaptive-мисленням плюс output_config.effort: "xhigh", оскільки /think — це директива мислення, а xhigh — це налаштування effort для Opus 4.7.
    • MiniMax (minimax/*) на Anthropic-сумісному потоковому шляху за замовчуванням використовує thinking: { type: "disabled" }, якщо ви явно не задасте мислення в параметрах моделі або параметрах запиту. Це запобігає витоку дельт reasoning_content із ненативного Anthropic-формату потоку MiniMax.
    • Z.AI (zai/*) підтримує лише двійкове мислення (on/off). Будь-який рівень, відмінний від off, обробляється як on (зіставляється з low).
    • Moonshot (moonshot/*) зіставляє /think off з thinking: { type: "disabled" }, а будь-який рівень, відмінний від off, — з thinking: { type: "enabled" }. Коли мислення увімкнене, Moonshot приймає лише tool_choice auto|none; OpenClaw нормалізує несумісні значення до auto.

Порядок визначення

  1. Вбудована директива в повідомленні (застосовується лише до цього повідомлення).
  2. Перевизначення сеансу (встановлюється надсиланням повідомлення, що містить лише директиву).
  3. Типове значення для агента (agents.list[].thinkingDefault у конфігурації).
  4. Глобальне типове значення (agents.defaults.thinkingDefault у конфігурації).
  5. Резервний варіант: adaptive для моделей Anthropic Claude 4.6, off для Anthropic Claude Opus 4.7, якщо не налаштовано явно, low для інших моделей із підтримкою міркування, off — в інших випадках.

Установлення типового значення для сеансу

  • Надішліть повідомлення, яке містить лише директиву (пробіли дозволені), наприклад /think:medium або /t high.
  • Це закріплюється за поточним сеансом (типово для кожного відправника окремо); скидається через /think:off або скидання через неактивність сеансу.
  • Надсилається відповідь-підтвердження (Thinking level set to high. / Thinking disabled.). Якщо рівень недійсний (наприклад, /thinking big), команда відхиляється з підказкою, а стан сеансу залишається без змін.
  • Надішліть /think (або /think:) без аргументу, щоб побачити поточний рівень мислення.

Застосування за агентом

  • Embedded Pi: визначений рівень передається до внутрішньопроцесного середовища виконання агента Pi.

Швидкий режим (/fast)

  • Рівні: on|off.
  • Повідомлення, що містить лише директиву, перемикає перевизначення швидкого режиму для сеансу і повертає Fast mode enabled. / Fast mode disabled..
  • Надішліть /fast (або /fast status) без режиму, щоб побачити поточний ефективний стан швидкого режиму.
  • OpenClaw визначає швидкий режим у такому порядку:
    1. Вбудована директива/директива-єдине-повідомлення /fast on|off
    2. Перевизначення сеансу
    3. Типове значення для агента (agents.list[].fastModeDefault)
    4. Конфігурація для моделі: agents.defaults.models["<provider>/<model>"].params.fastMode
    5. Резервний варіант: off
  • Для openai/* швидкий режим зіставляється з пріоритетною обробкою OpenAI шляхом надсилання service_tier=priority у підтримуваних запитах Responses.
  • Для openai-codex/* швидкий режим надсилає той самий прапорець service_tier=priority у Codex Responses. OpenClaw зберігає один спільний перемикач /fast для обох шляхів автентифікації.
  • Для прямих публічних запитів anthropic/*, включно з трафіком, автентифікованим через OAuth і надісланим до api.anthropic.com, швидкий режим зіставляється з рівнями сервісу Anthropic: /fast on встановлює service_tier=auto, /fast off встановлює service_tier=standard_only.
  • Для minimax/* на Anthropic-сумісному шляху /fast on (або params.fastMode: true) переписує MiniMax-M2.7 на MiniMax-M2.7-highspeed.
  • Явні параметри моделі Anthropic serviceTier / service_tier мають пріоритет над типовим значенням швидкого режиму, якщо задано обидва. OpenClaw усе одно пропускає ін’єкцію рівня сервісу Anthropic для не-Anthropic проксі-URL бази.

Директиви докладності (/verbose або /v)

  • Рівні: on (мінімальний) | full | off (типово).
  • Повідомлення, що містить лише директиву, перемикає докладність сеансу і повертає Verbose logging enabled. / Verbose logging disabled.; недійсні рівні повертають підказку без зміни стану.
  • /verbose off зберігає явне перевизначення сеансу; очистьте його через інтерфейс Sessions, вибравши inherit.
  • Вбудована директива впливає лише на це повідомлення; інакше застосовуються типові значення сеансу/глобальні типові значення.
  • Надішліть /verbose (або /verbose:) без аргументу, щоб побачити поточний рівень докладності.
  • Коли verbose увімкнено, агенти, які видають структуровані результати інструментів (Pi, інші JSON-агенти), надсилають кожен виклик інструмента назад як окреме повідомлення лише з метаданими, з префіксом <emoji> <tool-name>: <arg>, коли доступно (шлях/команда). Ці зведення інструментів надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як потокові дельти.
  • Зведення про помилки інструментів залишаються видимими у звичайному режимі, але суфікси з сирими деталями помилок приховуються, якщо verbose не on або full.
  • Коли verbose має значення full, після завершення також пересилаються виводи інструментів (окрема бульбашка, скорочена до безпечної довжини). Якщо ви перемикаєте /verbose on|full|off, поки виконання ще триває, наступні бульбашки інструментів враховують нове налаштування.

Директиви трасування Plugin (/trace)

  • Рівні: on | off (типово).
  • Повідомлення, що містить лише директиву, перемикає вивід трасування Plugin для сеансу і повертає Plugin trace enabled. / Plugin trace disabled..
  • Вбудована директива впливає лише на це повідомлення; інакше застосовуються типові значення сеансу/глобальні типові значення.
  • Надішліть /trace (або /trace:) без аргументу, щоб побачити поточний рівень трасування.
  • /trace вужчий за /verbose: він показує лише рядки трасування/налагодження, що належать Plugin, такі як зведення налагодження Active Memory.
  • Рядки трасування можуть з’являтися в /status і як додаткове діагностичне повідомлення після звичайної відповіді помічника.

Видимість міркувань (/reasoning)

  • Рівні: on|off|stream.
  • Повідомлення, що містить лише директиву, перемикає, чи показуються блоки мислення у відповідях.
  • Коли ввімкнено, міркування надсилаються як окреме повідомлення з префіксом Reasoning:.
  • stream (лише Telegram): транслює міркування в чернеткову бульбашку Telegram, поки генерується відповідь, а потім надсилає фінальну відповідь без міркувань.
  • Псевдонім: /reason.
  • Надішліть /reasoning (або /reasoning:) без аргументу, щоб побачити поточний рівень видимості міркувань.
  • Порядок визначення: вбудована директива, потім перевизначення сеансу, потім типове значення для агента (agents.list[].reasoningDefault), потім резервний варіант (off).

Пов’язане

  • Документація для Elevated mode розміщена в Elevated mode.

Heartbeats

  • Текст запиту Heartbeat — це налаштований промпт heartbeat (типово: Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.). Вбудовані директиви в повідомленні heartbeat застосовуються як завжди (але уникайте зміни типових значень сеансу через heartbeats).
  • Доставка Heartbeat типово надсилає лише фінальне корисне навантаження. Щоб також надсилати окреме повідомлення Reasoning: (коли доступне), встановіть agents.defaults.heartbeat.includeReasoning: true або для конкретного агента agents.list[].heartbeat.includeReasoning: true.

Вебінтерфейс чату

  • Селектор мислення у вебчаті під час завантаження сторінки відображає збережений рівень сеансу зі сховища вхідного сеансу/конфігурації.
  • Вибір іншого рівня одразу записує перевизначення сеансу через sessions.patch; він не чекає наступного надсилання і не є одноразовим перевизначенням thinkingOnce.
  • Перший варіант завжди Default (<resolved level>), де визначене типове значення береться з активної моделі сеансу: adaptive для Claude 4.6 на Anthropic, off для Anthropic Claude Opus 4.7, якщо не налаштовано, low для інших моделей із підтримкою міркування, off — в інших випадках.
  • Засіб вибору залишається обізнаним про провайдера:
    • більшість провайдерів показують off | minimal | low | medium | high | adaptive
    • Anthropic Claude Opus 4.7 показує off | minimal | low | medium | high | xhigh | adaptive
    • Z.AI показує двійкові off | on
  • /think:<level> як і раніше працює та оновлює той самий збережений рівень сеансу, тому директиви чату й засіб вибору залишаються синхронізованими.