From e769bde66eb7bead00101bde99d5eb0340b4cb89 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sat, 25 Apr 2026 01:08:27 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/tools/thinking.md | 141 +++++++++++++++++++------------------- 1 file changed, 71 insertions(+), 70 deletions(-) diff --git a/docs/uk/tools/thinking.md b/docs/uk/tools/thinking.md index 9851b9b54..9ffd25c43 100644 --- a/docs/uk/tools/thinking.md +++ b/docs/uk/tools/thinking.md @@ -1,130 +1,131 @@ --- read_when: - - Налаштування парсингу або значень за замовчуванням для директив мислення, fast-mode чи verbose + - Налаштування розбору директив мислення, швидкого режиму або докладного режиму чи значень за замовчуванням summary: Синтаксис директив для /think, /fast, /verbose, /trace і видимості міркувань title: Рівні мислення x-i18n: - generated_at: "2026-04-24T23:39:00Z" + generated_at: "2026-04-25T01:07:35Z" model: gpt-5.4 provider: openai - source_hash: 177fa325f48d6b6e28a085337cf30b8d2d1d31a094cef846c5af8633e013d4b6 + source_hash: 0537f10d3dd3251ac41590bebd2d83ba8b2562725c322040b20f32547c8af88d source_path: tools/thinking.md workflow: 15 --- ## Що це робить -- Вбудована директива в будь-якому вхідному тілі повідомлення: `/t `, `/think:` або `/thinking `. +- Вбудована директива в будь-якому вхідному тілі: `/t `, `/think:` або `/thinking `. - Рівні (псевдоніми): `off | minimal | low | medium | high | xhigh | adaptive | max` - minimal → “think” - low → “think hard” - medium → “think harder” - high → “ultrathink” (максимальний бюджет) - - xhigh → “ultrathink+” (GPT-5.2+ і моделі Codex, а також effort для Anthropic Claude Opus 4.7) - - adaptive → adaptive thinking під керуванням провайдера (підтримується для Claude 4.6 на Anthropic/Bedrock і Anthropic Claude Opus 4.7) - - max → максимальне міркування провайдера (зараз Anthropic Claude Opus 4.7) + - xhigh → “ultrathink+” (GPT-5.2+ і моделі Codex, а також зусилля Anthropic Claude Opus 4.7) + - adaptive → адаптивне мислення під керуванням провайдера (підтримується для Claude 4.6 на Anthropic/Bedrock, Anthropic Claude Opus 4.7 і Google Gemini dynamic thinking) + - max → максимальне міркування провайдера (наразі Anthropic Claude Opus 4.7) - `x-high`, `x_high`, `extra-high`, `extra high` і `extra_high` зіставляються з `xhigh`. - `highest` зіставляється з `high`. - Примітки щодо провайдерів: - - Меню та перемикачі thinking залежать від профілю провайдера. Плагіни провайдерів оголошують точний набір рівнів для вибраної моделі, включно з мітками на кшталт бінарного `on`. - - `adaptive`, `xhigh` і `max` оголошуються лише для профілів провайдерів/моделей, які їх підтримують. Введені директиви з непідтримуваними рівнями відхиляються з переліком допустимих варіантів для цієї моделі. - - Наявні збережені непідтримувані рівні переназначаються за рангом профілю провайдера. `adaptive` повертається до `medium` на неадаптивних моделях, тоді як `xhigh` і `max` повертаються до найбільшого підтримуваного рівня, відмінного від `off`, для вибраної моделі. - - Моделі Anthropic Claude 4.6 за замовчуванням використовують `adaptive`, якщо явний рівень thinking не задано. - - Anthropic Claude Opus 4.7 не використовує adaptive thinking за замовчуванням. Його значення effort API за замовчуванням і надалі визначається провайдером, якщо ви явно не задасте рівень thinking. - - Anthropic Claude Opus 4.7 зіставляє `/think xhigh` з adaptive thinking плюс `output_config.effort: "xhigh"`, оскільки `/think` є директивою thinking, а `xhigh` — це налаштування effort в Opus 4.7. - - Anthropic Claude Opus 4.7 також підтримує `/think max`; воно зіставляється з тим самим шляхом максимального effort, який визначається провайдером. - - Моделі OpenAI GPT зіставляють `/think` через специфічну для моделі підтримку effort в Responses API. `/think off` надсилає `reasoning.effort: "none"` лише тоді, коли цільова модель це підтримує; інакше OpenClaw пропускає payload для вимкненого reasoning замість надсилання непідтримуваного значення. - - MiniMax (`minimax/*`) на Anthropic-сумісному streaming-шляху за замовчуванням використовує `thinking: { type: "disabled" }`, якщо ви явно не задали thinking у параметрах моделі або запиту. Це запобігає витоку дельт `reasoning_content` з не нативного формату потоку Anthropic у MiniMax. - - Z.AI (`zai/*`) підтримує лише бінарний thinking (`on`/`off`). Будь-який рівень, відмінний від `off`, розглядається як `on` (зіставляється з `low`). + - Меню та перемикачі мислення керуються профілем провайдера. Плагіни провайдерів оголошують точний набір рівнів для вибраної моделі, включно з мітками на кшталт бінарного `on`. + - `adaptive`, `xhigh` і `max` рекламуються лише для профілів провайдера/моделі, які їх підтримують. Введені директиви для непідтримуваних рівнів відхиляються з показом дійсних варіантів для цієї моделі. + - Наявні збережені непідтримувані рівні переназначаються за рангом профілю провайдера. `adaptive` повертається до `medium` на неадаптивних моделях, а `xhigh` і `max` — до найбільшого підтримуваного небінарного рівня, відмінного від `off`, для вибраної моделі. + - Для моделей Anthropic Claude 4.6 за замовчуванням використовується `adaptive`, якщо явний рівень мислення не задано. + - Anthropic Claude Opus 4.7 не використовує adaptive thinking за замовчуванням. Типовий рівень effort для його API залишається під керуванням провайдера, якщо ви явно не задасте рівень мислення. + - Anthropic Claude Opus 4.7 зіставляє `/think xhigh` з adaptive thinking плюс `output_config.effort: "xhigh"`, оскільки `/think` — це директива мислення, а `xhigh` — налаштування effort для Opus 4.7. + - Anthropic Claude Opus 4.7 також підтримує `/think max`; це зіставляється з тим самим шляхом максимального effort під керуванням провайдера. + - Моделі OpenAI GPT зіставляють `/think` через підтримку effort у Responses API, специфічну для моделі. `/think off` надсилає `reasoning.effort: "none"` лише тоді, коли цільова модель це підтримує; інакше OpenClaw пропускає payload вимкненого reasoning замість надсилання непідтримуваного значення. + - Google Gemini зіставляє `/think adaptive` з dynamic thinking Gemini під керуванням провайдера. Запити Gemini 3 пропускають фіксований `thinkingLevel`, тоді як запити Gemini 2.5 надсилають `thinkingBudget: -1`; фіксовані рівні, як і раніше, зіставляються з найближчим `thinkingLevel` або бюджетом Gemini для цього сімейства моделей. + - MiniMax (`minimax/*`) на Anthropic-сумісному потоковому шляху за замовчуванням використовує `thinking: { type: "disabled" }`, якщо ви явно не задасте thinking у параметрах моделі або параметрах запиту. Це запобігає витоку дельт `reasoning_content` із ненативного формату Anthropic stream у MiniMax. + - Z.AI (`zai/*`) підтримує лише бінарне thinking (`on`/`off`). Будь-який рівень, відмінний від `off`, трактується як `on` (зіставляється з `low`). - Moonshot (`moonshot/*`) зіставляє `/think off` з `thinking: { type: "disabled" }`, а будь-який рівень, відмінний від `off`, — з `thinking: { type: "enabled" }`. Коли thinking увімкнено, Moonshot приймає лише `tool_choice` `auto|none`; OpenClaw нормалізує несумісні значення до `auto`. ## Порядок визначення 1. Вбудована директива в повідомленні (застосовується лише до цього повідомлення). -2. Перевизначення сесії (задається надсиланням повідомлення, що містить лише директиву). -3. Типове значення для агента (`agents.list[].thinkingDefault` у конфігурації). -4. Глобальне типове значення (`agents.defaults.thinkingDefault` у конфігурації). -5. Резервний варіант: оголошене провайдером значення за замовчуванням, якщо доступне; інакше моделі з підтримкою reasoning визначаються як `medium` або найближчий підтримуваний рівень, відмінний від `off`, для цієї моделі, а моделі без reasoning залишаються на `off`. +2. Перевизначення сесії (встановлюється надсиланням повідомлення, що містить лише директиву). +3. Значення за замовчуванням для агента (`agents.list[].thinkingDefault` у конфігурації). +4. Глобальне значення за замовчуванням (`agents.defaults.thinkingDefault` у конфігурації). +5. Резервний варіант: оголошене провайдером значення за замовчуванням, якщо доступне; інакше моделі зі здатністю до міркування визначаються як `medium` або найближчий підтримуваний рівень, відмінний від `off`, для цієї моделі, а моделі без міркування залишаються `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` або під час idle reset сесії. +- Надсилається відповідь-підтвердження (`Thinking level set to high.` / `Thinking disabled.`). Якщо рівень недійсний (наприклад, `/thinking big`), команду буде відхилено з підказкою, а стан сесії залишиться без змін. +- Надішліть `/think` (або `/think:`) без аргументу, щоб побачити поточний рівень мислення. ## Застосування за агентом -- **Embedded Pi**: визначений рівень передається в runtime вбудованого агента Pi. +- **Вбудований Pi**: визначений рівень передається в runtime агента Pi у межах процесу. -## Fast mode (/fast) +## Швидкий режим (/fast) - Рівні: `on|off`. -- Повідомлення лише з директивою перемикає перевизначення fast mode для сесії та повертає `Fast mode enabled.` / `Fast mode disabled.`. -- Надішліть `/fast` (або `/fast status`) без режиму, щоб побачити поточний ефективний стан fast mode. -- OpenClaw визначає fast mode в такому порядку: - 1. Вбудована директива/повідомлення лише з директивою `/fast on|off` +- Повідомлення лише з директивою перемикає перевизначення швидкого режиму для сесії та відповідає `Fast mode enabled.` / `Fast mode disabled.`. +- Надішліть `/fast` (або `/fast status`) без режиму, щоб побачити поточний ефективний стан швидкого режиму. +- OpenClaw визначає швидкий режим у такому порядку: + 1. Вбудоване/директивне `/fast on|off` 2. Перевизначення сесії - 3. Типове значення для агента (`agents.list[].fastModeDefault`) + 3. Значення за замовчуванням для агента (`agents.list[].fastModeDefault`) 4. Конфігурація для моделі: `agents.defaults.models["/"].params.fastMode` 5. Резервний варіант: `off` -- Для `openai/*` fast mode зіставляється з пріоритетною обробкою OpenAI через надсилання `service_tier=priority` у підтримуваних запитах Responses. -- Для `openai-codex/*` fast mode надсилає той самий прапорець `service_tier=priority` у Codex Responses. OpenClaw зберігає один спільний перемикач `/fast` для обох шляхів автентифікації. -- Для прямих публічних запитів `anthropic/*`, зокрема трафіку з OAuth-автентифікацією, надісланого до `api.anthropic.com`, fast mode зіставляється з рівнями сервісу Anthropic: `/fast on` задає `service_tier=auto`, `/fast off` задає `service_tier=standard_only`. +- Для `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` перевизначають типове значення fast mode, якщо задано обидва. OpenClaw, як і раніше, пропускає вставку рівня сервісу Anthropic для проксі-базових URL, що не належать Anthropic. -- `/status` показує `Fast` лише коли fast mode увімкнено. +- Явні параметри моделі Anthropic `serviceTier` / `service_tier` перевизначають значення швидкого режиму за замовчуванням, якщо встановлено обидва. OpenClaw, як і раніше, пропускає впровадження service tier Anthropic для не-Anthropic proxy base URL. +- `/status` показує `Fast` лише тоді, коли швидкий режим увімкнено. -## Директиви verbose (/verbose або /v) +## Докладні директиви (/verbose або /v) - Рівні: `on` (мінімальний) | `full` | `off` (за замовчуванням). -- Повідомлення лише з директивою перемикає verbose для сесії та повертає `Verbose logging enabled.` / `Verbose logging disabled.`; недійсні рівні повертають підказку без зміни стану. -- `/verbose off` зберігає явне перевизначення сесії; очистити його можна через інтерфейс Sessions, вибравши `inherit`. -- Вбудована директива впливає лише на це повідомлення; інакше застосовуються типові значення сесії/глобальні. -- Надішліть `/verbose` (або `/verbose:`) без аргументу, щоб побачити поточний рівень verbose. -- Коли verbose увімкнено, агенти, які надсилають структуровані результати інструментів (Pi, інші JSON-агенти), повертають кожен виклик інструмента як окреме повідомлення лише з метаданими, з префіксом ` : `, коли доступно (path/command). Ці зведення інструментів надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як streaming-дельти. -- Зведення про збої інструментів залишаються видимими у звичайному режимі, але суфікси з необробленими подробицями помилок приховуються, якщо verbose не дорівнює `on` або `full`. -- Коли verbose має значення `full`, вивід інструментів також пересилається після завершення (окремою бульбашкою, обрізаний до безпечної довжини). Якщо ви перемкнете `/verbose on|full|off`, поки виконання триває, наступні бульбашки інструментів врахують нове налаштування. +- Повідомлення лише з директивою перемикає докладність для сесії та відповідає `Verbose logging enabled.` / `Verbose logging disabled.`; недійсні рівні повертають підказку без зміни стану. +- `/verbose off` зберігає явне перевизначення сесії; очистіть його через інтерфейс Sessions, вибравши `inherit`. +- Вбудована директива впливає лише на це повідомлення; інакше застосовуються значення за замовчуванням для сесії/глобальні. +- Надішліть `/verbose` (або `/verbose:`) без аргументу, щоб побачити поточний рівень докладності. +- Коли verbose увімкнено, агенти, які видають структуровані результати інструментів (Pi, інші JSON-агенти), надсилають кожен виклик інструмента назад як окреме повідомлення лише з метаданими, з префіксом ` : `, коли доступно (path/command). Ці підсумки інструментів надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як потокові дельти. +- Підсумки збоїв інструментів залишаються видимими у звичайному режимі, але суфікси з необробленими деталями помилок приховуються, якщо 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`: він показує лише рядки трасування/налагодження, що належать плагіну, як-от підсумки налагодження Active Memory. +- Рядки трасування можуть з’являтися в `/status` і як подальше діагностичне повідомлення після звичайної відповіді помічника. -## Видимість reasoning (/reasoning) +## Видимість міркувань (/reasoning) - Рівні: `on|off|stream`. -- Повідомлення лише з директивою перемикає, чи показувати блоки thinking у відповідях. -- Коли увімкнено, reasoning надсилається як **окреме повідомлення** з префіксом `Reasoning:`. -- `stream` (лише Telegram): транслює reasoning у чернеткову бульбашку Telegram під час генерування відповіді, а потім надсилає фінальну відповідь без reasoning. +- Повідомлення лише з директивою перемикає, чи показуються блоки мислення у відповідях. +- Коли ввімкнено, reasoning надсилається як **окреме повідомлення** з префіксом `Reasoning:`. +- `stream` (лише Telegram): транслює reasoning у чернетку бульбашки Telegram, поки генерується відповідь, а потім надсилає фінальну відповідь без reasoning. - Псевдонім: `/reason`. -- Надішліть `/reasoning` (або `/reasoning:`) без аргументу, щоб побачити поточний рівень reasoning. -- Порядок визначення: вбудована директива, потім перевизначення сесії, потім типове значення для агента (`agents.list[].reasoningDefault`), потім резервний варіант (`off`). +- Надішліть `/reasoning` (або `/reasoning:`) без аргументу, щоб побачити поточний рівень видимості міркувань. +- Порядок визначення: вбудована директива, потім перевизначення сесії, потім значення за замовчуванням для агента (`agents.list[].reasoningDefault`), потім резервний варіант (`off`). ## Пов’язане -- Документація режиму elevated розміщена в [Elevated mode](/uk/tools/elevated). +- Документація режиму elevated міститься в [Elevated mode](/uk/tools/elevated). -## Heartbeats +## Heartbeat -- Тіло запиту Heartbeat — це налаштований heartbeat prompt (за замовчуванням: `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 — це налаштований prompt 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` для окремого агента. -## Вебінтерфейс чату +## Веб-інтерфейс чату -- Перемикач thinking у вебчаті при завантаженні сторінки відображає збережений рівень сесії зі сховища/конфігурації вхідної сесії. -- Вибір іншого рівня негайно записує перевизначення сесії через `sessions.patch`; він не чекає наступного надсилання і не є одноразовим перевизначенням `thinkingOnce`. -- Перший варіант завжди — `Default ()`, де визначене типове значення береться з профілю thinking провайдера для активної моделі сесії плюс та сама резервна логіка, яку використовують `/status` і `session_status`. -- Перемикач використовує `thinkingLevels`, що повертаються рядком/defaults сесії Gateway, а `thinkingOptions` зберігається як застарілий список міток. Інтерфейс браузера не зберігає власний список regex провайдерів; плагіни володіють наборами рівнів, специфічними для моделей. -- `/think:` як і раніше працює та оновлює той самий збережений рівень сесії, тому директиви в чаті й перемикач залишаються синхронізованими. +- Селектор мислення у веб-чаті відображає збережений рівень сесії зі сховища/конфігурації вхідної сесії під час завантаження сторінки. +- Вибір іншого рівня одразу записує перевизначення сесії через `sessions.patch`; він не чекає наступного надсилання і не є одноразовим перевизначенням `thinkingOnce`. +- Перший варіант завжди має вигляд `Default ()`, де визначене значення за замовчуванням надходить із профілю мислення провайдера для активної моделі сесії плюс та сама логіка резервного варіанта, яку використовують `/status` і `session_status`. +- Перемикач використовує `thinkingLevels`, повернуті рядком/defaults сесії Gateway, а `thinkingOptions` зберігаються як застарілий список міток. Інтерфейс браузера не зберігає власний список regex провайдерів; плагіни керують наборами рівнів, специфічними для моделі. +- `/think:` як і раніше працює та оновлює той самий збережений рівень сесії, тож директиви чату й перемикач залишаються синхронізованими. ## Профілі провайдерів -- Плагіни провайдерів можуть надавати `resolveThinkingProfile(ctx)`, щоб визначити підтримувані рівні моделі та значення за замовчуванням. +- Плагіни провайдерів можуть надавати `resolveThinkingProfile(ctx)` для визначення підтримуваних рівнів моделі та значення за замовчуванням. - Кожен рівень профілю має збережений канонічний `id` (`off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `adaptive` або `max`) і може містити відображувану `label`. Бінарні провайдери використовують `{ id: "low", label: "on" }`. -- Опубліковані застарілі хуки (`supportsXHighThinking`, `isBinaryThinking` і `resolveDefaultThinkingLevel`) залишаються адаптерами сумісності, але нові користувацькі набори рівнів мають використовувати `resolveThinkingProfile`. -- Рядки/defaults Gateway надають `thinkingLevels`, `thinkingOptions` і `thinkingDefault`, щоб клієнти ACP/чату відображали ті самі id і мітки профілю, які використовує перевірка runtime. +- Опубліковані застарілі хуки (`supportsXHighThinking`, `isBinaryThinking` і `resolveDefaultThinkingLevel`) залишаються адаптерами сумісності, але нові користувацькі набори рівнів слід реалізовувати через `resolveThinkingProfile`. +- Рядки/defaults Gateway надають `thinkingLevels`, `thinkingOptions` і `thinkingDefault`, щоб клієнти ACP/чату відображали ті самі id і label профілю, які використовує перевірка в runtime.