diff --git a/docs/uk/tools/thinking.md b/docs/uk/tools/thinking.md index 758196b36..23b114b47 100644 --- a/docs/uk/tools/thinking.md +++ b/docs/uk/tools/thinking.md @@ -1,118 +1,121 @@ --- read_when: - - Налаштування парсингу або значень за замовчуванням для директив thinking, fast-mode чи verbose -summary: Синтаксис директив для `/think`, `/fast`, `/verbose`, `/trace` і видимості міркувань -title: Рівні thinking + - Налаштування розбору директив мислення, швидкого режиму або докладності чи значень за замовчуванням +summary: Синтаксис директив для /think, /fast, /verbose, /trace і видимості міркувань +title: Рівні мислення x-i18n: - generated_at: "2026-04-12T18:22:22Z" + generated_at: "2026-04-17T00:29:52Z" model: gpt-5.4 provider: openai - source_hash: 4f3b1341281f07ba4e9061e3355845dca234be04cc0d358594312beeb7676e68 + source_hash: 1cb44a7bf75546e5a8c3204e12f3297221449b881161d173dea4983da3921649 source_path: tools/thinking.md workflow: 15 --- -# Рівні thinking (/think директиви) +# Рівні мислення (директиви /think) ## Що це робить -- Вбудована директива в будь-якому вхідному тілі: `/t `, `/think:` або `/thinking `. -- Рівні (аліаси): `off | minimal | low | medium | high | xhigh | adaptive` +- Вбудована директива в будь-якому вхідному тексті: `/t `, `/think:` або `/thinking `. +- Рівні (псевдоніми): `off | minimal | low | medium | high | xhigh | adaptive` - minimal → “think” - low → “think hard” - medium → “think harder” - high → “ultrathink” (максимальний бюджет) - - xhigh → “ultrathink+” (лише GPT-5.2 + моделі Codex) - - adaptive → адаптивний бюджет міркувань, керований провайдером (підтримується для сімейства моделей Anthropic Claude 4.6) + - 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`, якщо явний рівень thinking не задано. - - Для MiniMax (`minimax/*`) на Anthropic-сумісному шляху потокової передачі типовим є `thinking: { type: "disabled" }`, якщо ви явно не задасте thinking у параметрах моделі або параметрах запиту. Це запобігає витоку дельт `reasoning_content` із ненативного Anthropic-потоку MiniMax. - - Z.AI підтримує лише двійковий thinking (`on`/`off`). Будь-який рівень, відмінний від `off`, трактується як `on` (зіставляється з `low`). - - Moonshot зіставляє `/think off` з `thinking: { type: "disabled" }`, а будь-який рівень, відмінний від `off`, — з `thinking: { type: "enabled" }`. Коли thinking увімкнено, Moonshot приймає лише `tool_choice` `auto|none`; OpenClaw нормалізує несумісні значення до `auto`. + - Для моделей 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` у конфігурації). +2. Перевизначення сеансу (встановлюється надсиланням повідомлення, що містить лише директиву). +3. Типове значення для агента (`agents.list[].thinkingDefault` у конфігурації). 4. Глобальне типове значення (`agents.defaults.thinkingDefault` у конфігурації). -5. Запасний варіант: `adaptive` для моделей Anthropic Claude 4.6, `low` для інших моделей із підтримкою міркувань, інакше `off`. +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:`) без аргументу, щоб побачити поточний рівень thinking. +- Надішліть повідомлення, яке **містить лише** директиву (пробіли дозволені), наприклад `/think:medium` або `/t high`. +- Це закріплюється за поточним сеансом (типово для кожного відправника окремо); скидається через `/think:off` або скидання через неактивність сеансу. +- Надсилається відповідь-підтвердження (`Thinking level set to high.` / `Thinking disabled.`). Якщо рівень недійсний (наприклад, `/thinking big`), команда відхиляється з підказкою, а стан сеансу залишається без змін. +- Надішліть `/think` (або `/think:`) без аргументу, щоб побачити поточний рівень мислення. ## Застосування за агентом -- **Вбудований Pi**: визначений рівень передається в runtime вбудованого агента Pi. +- **Embedded Pi**: визначений рівень передається до внутрішньопроцесного середовища виконання агента Pi. ## Швидкий режим (/fast) - Рівні: `on|off`. -- Повідомлення лише з директивою перемикає перевизначення швидкого режиму для сесії та повертає `Fast mode enabled.` / `Fast mode disabled.`. +- Повідомлення, що містить лише директиву, перемикає перевизначення швидкого режиму для сеансу і повертає `Fast mode enabled.` / `Fast mode disabled.`. - Надішліть `/fast` (або `/fast status`) без режиму, щоб побачити поточний ефективний стан швидкого режиму. - OpenClaw визначає швидкий режим у такому порядку: - 1. Вбудована директива/повідомлення лише з директивою `/fast on|off` - 2. Перевизначення сесії - 3. Типове значення для конкретного агента (`agents.list[].fastModeDefault`) - 4. Конфігурація для конкретної моделі: `agents.defaults.models["/"].params.fastMode` - 5. Запасний варіант: `off` -- Для `openai/*` швидкий режим зіставляється з пріоритетною обробкою OpenAI через надсилання `service_tier=priority` у підтримуваних запитах Responses. + 1. Вбудована директива/директива-єдине-повідомлення `/fast on|off` + 2. Перевизначення сеансу + 3. Типове значення для агента (`agents.list[].fastModeDefault`) + 4. Конфігурація для моделі: `agents.defaults.models["/"].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`. +- Для прямих публічних запитів `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 проксі `base URL`. +- Явні параметри моделі Anthropic `serviceTier` / `service_tier` мають пріоритет над типовим значенням швидкого режиму, якщо задано обидва. OpenClaw усе одно пропускає ін’єкцію рівня сервісу Anthropic для не-Anthropic проксі-URL бази. -## Директиви verbose (/verbose або /v) +## Директиви докладності (/verbose або /v) - Рівні: `on` (мінімальний) | `full` | `off` (типово). -- Повідомлення лише з директивою перемикає verbose для сесії та повертає `Verbose logging enabled.` / `Verbose logging disabled.`; недійсні рівні повертають підказку без зміни стану. -- `/verbose off` зберігає явне перевизначення сесії; очистьте його через UI Sessions, вибравши `inherit`. -- Вбудована директива впливає лише на це повідомлення; інакше застосовуються типові значення сесії/глобальні. -- Надішліть `/verbose` (або `/verbose:`) без аргументу, щоб побачити поточний рівень verbose. -- Коли verbose увімкнено, агенти, які повертають структуровані результати інструментів (Pi, інші JSON-агенти), надсилають кожен виклик інструмента назад як окреме повідомлення лише з метаданими, з префіксом ` : `, коли доступно (шлях/команда). Ці зведення інструментів надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як потокові дельти. -- Зведення про збої інструментів залишаються видимими у звичайному режимі, але необроблені суфікси з деталями помилок приховуються, якщо verbose не дорівнює `on` або `full`. -- Коли verbose дорівнює `full`, виводи інструментів також пересилаються після завершення (окрема бульбашка, обрізана до безпечної довжини). Якщо ви перемкнете `/verbose on|full|off`, поки виконання ще триває, наступні бульбашки інструментів врахують нове налаштування. +- Повідомлення, що містить лише директиву, перемикає докладність сеансу і повертає `Verbose logging enabled.` / `Verbose logging disabled.`; недійсні рівні повертають підказку без зміни стану. +- `/verbose off` зберігає явне перевизначення сеансу; очистьте його через інтерфейс Sessions, вибравши `inherit`. +- Вбудована директива впливає лише на це повідомлення; інакше застосовуються типові значення сеансу/глобальні типові значення. +- Надішліть `/verbose` (або `/verbose:`) без аргументу, щоб побачити поточний рівень докладності. +- Коли verbose увімкнено, агенти, які видають структуровані результати інструментів (Pi, інші JSON-агенти), надсилають кожен виклик інструмента назад як окреме повідомлення лише з метаданими, з префіксом ` : `, коли доступно (шлях/команда). Ці зведення інструментів надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як потокові дельти. +- Зведення про помилки інструментів залишаються видимими у звичайному режимі, але суфікси з сирими деталями помилок приховуються, якщо verbose не `on` або `full`. +- Коли verbose має значення `full`, після завершення також пересилаються виводи інструментів (окрема бульбашка, скорочена до безпечної довжини). Якщо ви перемикаєте `/verbose on|full|off`, поки виконання ще триває, наступні бульбашки інструментів враховують нове налаштування. -## Директиви trace для plugin (/trace) +## Директиви трасування Plugin (/trace) - Рівні: `on` | `off` (типово). -- Повідомлення лише з директивою перемикає trace-вивід plugin для сесії та повертає `Plugin trace enabled.` / `Plugin trace disabled.`. -- Вбудована директива впливає лише на це повідомлення; інакше застосовуються типові значення сесії/глобальні. -- Надішліть `/trace` (або `/trace:`) без аргументу, щоб побачити поточний рівень trace. -- `/trace` вужчий, ніж `/verbose`: він показує лише рядки trace/debug, що належать plugin, наприклад зведення налагодження Active Memory. -- Рядки trace можуть з’являтися у `/status` і як додаткове діагностичне повідомлення після звичайної відповіді асистента. +- Повідомлення, що містить лише директиву, перемикає вивід трасування Plugin для сеансу і повертає `Plugin trace enabled.` / `Plugin trace disabled.`. +- Вбудована директива впливає лише на це повідомлення; інакше застосовуються типові значення сеансу/глобальні типові значення. +- Надішліть `/trace` (або `/trace:`) без аргументу, щоб побачити поточний рівень трасування. +- `/trace` вужчий за `/verbose`: він показує лише рядки трасування/налагодження, що належать Plugin, такі як зведення налагодження Active Memory. +- Рядки трасування можуть з’являтися в `/status` і як додаткове діагностичне повідомлення після звичайної відповіді помічника. ## Видимість міркувань (/reasoning) - Рівні: `on|off|stream`. -- Повідомлення лише з директивою перемикає, чи показуються блоки thinking у відповідях. -- Коли це ввімкнено, міркування надсилаються як **окреме повідомлення** з префіксом `Reasoning:`. -- `stream` (лише Telegram): транслює міркування в чернетку бульбашки Telegram під час генерації відповіді, а потім надсилає фінальну відповідь без міркувань. -- Аліас: `/reason`. -- Надішліть `/reasoning` (або `/reasoning:`) без аргументу, щоб побачити поточний рівень reasoning. -- Порядок визначення: вбудована директива, потім перевизначення сесії, потім типове значення для конкретного агента (`agents.list[].reasoningDefault`), потім запасний варіант (`off`). +- Повідомлення, що містить лише директиву, перемикає, чи показуються блоки мислення у відповідях. +- Коли ввімкнено, міркування надсилаються як **окреме повідомлення** з префіксом `Reasoning:`. +- `stream` (лише Telegram): транслює міркування в чернеткову бульбашку Telegram, поки генерується відповідь, а потім надсилає фінальну відповідь без міркувань. +- Псевдонім: `/reason`. +- Надішліть `/reasoning` (або `/reasoning:`) без аргументу, щоб побачити поточний рівень видимості міркувань. +- Порядок визначення: вбудована директива, потім перевизначення сеансу, потім типове значення для агента (`agents.list[].reasoningDefault`), потім резервний варіант (`off`). ## Пов’язане -- Документація про підвищений режим міститься в [Підвищений режим](/uk/tools/elevated). +- Документація для Elevated mode розміщена в [Elevated mode](/uk/tools/elevated). -## Heartbeat +## Heartbeats -- Тіло probe 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 застосовуються як завжди (але уникайте зміни типових значень сесії з Heartbeat). -- Доставка Heartbeat типово використовує лише фінальний payload. Щоб також надсилати окреме повідомлення `Reasoning:` (коли доступне), задайте `agents.defaults.heartbeat.includeReasoning: true` або для конкретного агента `agents.list[].heartbeat.includeReasoning: true`. +- Текст запиту 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`. -## Веб-інтерфейс чату +## Вебінтерфейс чату -- Перемикач thinking у веб-чаті під час завантаження сторінки відображає збережений рівень сесії зі сховища вхідних сесій/конфігурації. -- Вибір іншого рівня одразу записує перевизначення сесії через `sessions.patch`; він не чекає наступного надсилання і не є одноразовим перевизначенням `thinkingOnce`. -- Перший варіант завжди має вигляд `Default ()`, де визначене типове значення береться з активної моделі сесії: `adaptive` для Claude 4.6 на Anthropic/Bedrock, `low` для інших моделей із підтримкою міркувань, інакше `off`. -- Вибір залишається обізнаним про провайдера: +- Селектор мислення у вебчаті під час завантаження сторінки відображає збережений рівень сеансу зі сховища вхідного сеансу/конфігурації. +- Вибір іншого рівня одразу записує перевизначення сеансу через `sessions.patch`; він не чекає наступного надсилання і не є одноразовим перевизначенням `thinkingOnce`. +- Перший варіант завжди `Default ()`, де визначене типове значення береться з активної моделі сеансу: `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:` як і раніше працює та оновлює той самий збережений рівень сесії, тож директиви чату і перемикач залишаються синхронізованими. +- `/think:` як і раніше працює та оновлює той самий збережений рівень сеансу, тому директиви чату й засіб вибору залишаються синхронізованими.