diff --git a/docs/uk/concepts/progress-drafts.md b/docs/uk/concepts/progress-drafts.md index 32be8ee76..462c00c05 100644 --- a/docs/uk/concepts/progress-drafts.md +++ b/docs/uk/concepts/progress-drafts.md @@ -1,42 +1,43 @@ --- read_when: - - Налаштування видимих оновлень перебігу для тривалих ходів чату - - Вибір між режимами часткового, блокового потокового передавання та потокового передавання прогресу - - Пояснення того, як OpenClaw оновлює одне повідомлення каналу під час виконання роботи - - Усунення несправностей із чернетками перебігу виконання, окремими повідомленнями про перебіг виконання або резервним механізмом фіналізації -summary: 'Чернетки прогресу: одне видиме повідомлення про роботу, що триває, яке оновлюється під час роботи агента' -title: Чернетки прогресу + - Налаштування видимих оновлень прогресу для тривалих ходів чату + - Вибір між режимами потокового передавання partial, block і progress + - Пояснення, як OpenClaw оновлює одне повідомлення в каналі під час виконання роботи + - Усунення проблем із чернетками прогресу, окремими повідомленнями про прогрес або резервним механізмом фіналізації +summary: 'Чернетки прогресу: одне видиме повідомлення про перебіг роботи, яке оновлюється під час роботи агента' +title: Чернетки перебігу роботи x-i18n: - generated_at: "2026-05-03T21:05:52Z" + generated_at: "2026-05-03T23:27:03Z" model: gpt-5.5 provider: openai - source_hash: 0fc0dff38232228b49872d66f4498f065675cdd3abf3a0f4003cb34fcbb7de8c + source_hash: 04e87e81b5b256a3dcd52b70d46e85c80a5d05ecb32df00ccf59782ab47bde2c source_path: concepts/progress-drafts.md workflow: 16 --- -Чернетки перебігу роботи роблять тривалі ходи агента живими в чаті, не перетворюючи -розмову на стос тимчасових відповідей зі статусом. +Чернетки прогресу оживляють довгі ходи агента в чаті, не перетворюючи +розмову на стек тимчасових відповідей зі статусом. -Коли чернетки перебігу роботи увімкнені, OpenClaw створює одне видиме повідомлення -про роботу в процесі, оновлює його, поки агент читає, планує, викликає інструменти -або чекає на схвалення, а потім перетворює цю чернетку на фінальну відповідь, -коли канал може зробити це безпечно. +Коли чернетки прогресу ввімкнені, OpenClaw створює одне видиме повідомлення +про роботу в процесі лише після того, як хід доведе, що виконує реальну роботу, +оновлює його, поки агент читає, планує, викликає інструменти або чекає на +схвалення, а потім перетворює цю чернетку на фінальну відповідь, коли канал +може зробити це безпечно. ```text -Shelling +Shelling... - reading recent channel context - checking matching issues - preparing reply ``` -Використовуйте чернетки перебігу роботи, коли потрібне одне охайне повідомлення -зі статусом під час роботи з багатьма інструментами та фінальна відповідь після -завершення ходу. +Використовуйте чернетки прогресу, коли потрібне одне охайне повідомлення зі +статусом під час роботи з великою кількістю інструментів і фінальна відповідь, +коли хід завершено. ## Швидкий старт -Увімкніть чернетки перебігу роботи для кожного каналу через `streaming.mode: "progress"`: +Увімкніть чернетки прогресу для кожного каналу за допомогою `streaming.mode: "progress"`: ```json5 { @@ -50,77 +51,81 @@ Shelling } ``` -Зазвичай цього достатньо. OpenClaw вибере автоматичну однослівну мітку, додаватиме -стислі рядки перебігу, поки відбувається корисна робота, і приглушить дубльовані -окремі повідомлення про перебіг для цього ходу. +Зазвичай цього достатньо. OpenClaw вибере автоматичну однослівну мітку, +зачекає, доки робота триватиме щонайменше п’ять секунд або згенерує другу подію +роботи, додаватиме стислі рядки прогресу, поки відбувається корисна робота, і +пригнічуватиме дублікати окремого прогрес-чату для цього ходу. ## Що бачать користувачі -Чернетка перебігу роботи має дві частини: +Чернетка прогресу має дві частини: -| Частина | Призначення | -| --------------- | ---------------------------------------------------------------- | -| Мітка | Короткий заголовок, наприклад `Thinking` або `Shelling`. | -| Рядки перебігу | Стислі оновлення запуску, як-от виклики інструментів, кроки завдання або схвалення. | +| Частина | Призначення | +| -------------- | ----------------------------------------------------------------- | +| Мітка | Короткий заголовок, наприклад `Thinking...` або `Shelling...`. | +| Рядки прогресу | Стислі оновлення виконання, як-от виклики інструментів, кроки завдань або схвалення. | -Мітка з'являється одразу, коли агент починає відповідати. Рядки перебігу додаються -лише тоді, коли агент надсилає корисні оновлення про роботу. Фінальна відповідь -замінює чернетку, коли це можливо; інакше OpenClaw надсилає фінальну відповідь -звичайним способом і очищає або припиняє оновлювати чернетку відповідно до транспорту каналу. +Мітка з’являється після того, як агент починає змістовну роботу і або +залишається зайнятим п’ять секунд, або генерує другу подію роботи. Відповіді +лише звичайним текстом не показують чернетку прогресу. Рядки прогресу +додаються лише тоді, коли агент генерує корисні оновлення роботи. Фінальна +відповідь замінює чернетку, коли це можливо; інакше OpenClaw надсилає фінальну +відповідь звичайним способом і очищає або припиняє оновлювати чернетку +відповідно до транспорту каналу. ## Вибір режиму `channels..streaming.mode` керує видимою поведінкою роботи в процесі: -| Режим | Найкраще для | Що з'являється в чаті | -| ---------- | ------------------------------------ | -------------------------------------------------- | -| `off` | Тихі канали | Лише фінальна відповідь. | -| `partial` | Спостереження за появою тексту відповіді | Одна чернетка, яку редагують найновішим текстом відповіді. | +| Режим | Найкраще для | Що з’являється в чаті | +| ---------- | -------------------------------- | ------------------------------------------------- | +| `off` | Тихі канали | Лише фінальна відповідь. | +| `partial` | Спостереження за появою тексту відповіді | Одна чернетка, що редагується з найновішим текстом відповіді. | | `block` | Більші фрагменти попереднього перегляду відповіді | Один попередній перегляд, що оновлюється або доповнюється більшими фрагментами. | -| `progress` | Ходи з багатьма інструментами або тривалі ходи | Одна чернетка статусу, потім фінальна відповідь. | +| `progress` | Ходи з великою кількістю інструментів або довгим виконанням | Одна чернетка статусу, потім фінальна відповідь. | -Виберіть `progress`, коли користувачам важливіше "що відбувається", ніж спостерігати, -як текст відповіді транслюється токен за токеном. +Вибирайте `progress`, коли користувачам важливіше "що відбувається", ніж +спостерігати, як текст відповіді транслюється токен за токеном. -Виберіть `partial`, коли сама відповідь є сигналом перебігу. +Вибирайте `partial`, коли сама відповідь є сигналом прогресу. -Виберіть `block`, коли потрібні оновлення попереднього перегляду чернетки більшими -текстовими фрагментами. У Discord і Telegram `streaming.mode: "block"` усе ще є -потоковим попереднім переглядом, а не звичайною доставкою блоками. Використовуйте -`streaming.block.enabled` або застарілий `blockStreaming`, коли потрібні звичайні -блокові відповіді. +Вибирайте `block`, коли потрібні оновлення чернетки попереднього перегляду +більшими текстовими фрагментами. У Discord і Telegram `streaming.mode: "block"` +усе ще є потоковим попереднім переглядом, а не звичайною блоковою доставкою. +Використовуйте `streaming.block.enabled` або застарілий `blockStreaming`, коли +потрібні звичайні блокові відповіді. ## Налаштування міток -Мітки перебігу роботи містяться в `channels..streaming.progress`. +Мітки прогресу розташовані в `channels..streaming.progress`. -Типова мітка — `auto`, яка вибирає з вбудованого в OpenClaw набору однослівних -міток: +Типова мітка — `auto`, яка вибирає з вбудованого пулу OpenClaw +однослівних міток із трьома крапками: ```text -Thinking -Shelling -Scuttling -Clawing -Pinching -Molting -Bubbling -Tiding -Reefing -Cracking -Sifting -Brining -Nautiling -Krilling -Barnacling -Lobstering -Tidepooling -Pearling -Snapping -Surfacing +Thinking... +Shelling... +Scuttling... +Clawing... +Pinching... +Molting... +Bubbling... +Tiding... +Reefing... +Cracking... +Sifting... +Brining... +Nautiling... +Krilling... +Barnacling... +Lobstering... +Tidepooling... +Pearling... +Snapping... +Surfacing... ``` -Використайте фіксовану мітку: +Використовуйте фіксовану мітку: ```json5 { @@ -137,7 +142,7 @@ Surfacing } ``` -Використайте власний автоматичний набір міток: +Використовуйте власний автоматичний пул міток: ```json5 { @@ -155,7 +160,7 @@ Surfacing } ``` -Приховайте мітку й показуйте лише рядки перебігу: +Приховайте мітку й показуйте лише рядки прогресу: ```json5 { @@ -172,13 +177,13 @@ Surfacing } ``` -## Керування рядками перебігу +## Керування рядками прогресу -Рядки перебігу ввімкнені типово в режимі перебігу. Вони походять із реальних -подій запуску: запусків інструментів, оновлень елементів, планів завдань, +Рядки прогресу ввімкнені типово в режимі progress. Вони походять із реальних +подій виконання: запусків інструментів, оновлень елементів, планів завдань, схвалень, виводу команд, підсумків патчів і подібної активності агента. -Обмежте кількість рядків, що залишаються видимими: +Обмежте кількість рядків, які залишаються видимими: ```json5 { @@ -195,7 +200,7 @@ Surfacing } ``` -Збережіть одну чернетку перебігу, але приховайте рядки інструментів і завдань: +Збережіть єдину чернетку прогресу, але приховайте рядки інструментів і завдань: ```json5 { @@ -212,21 +217,21 @@ Surfacing } ``` -З `toolProgress: false` OpenClaw усе одно приглушує старі окремі повідомлення -про перебіг інструментів для цього ходу. Канал залишається візуально тихим до -фінальної відповіді, за винятком мітки, якщо її налаштовано. +З `toolProgress: false` OpenClaw усе ще пригнічує старіші окремі повідомлення +про прогрес інструментів для цього ходу. Канал залишається візуально тихим до +фінальної відповіді, крім мітки, якщо її налаштовано. ## Поведінка каналів -Кожен канал використовує найохайніший транспорт, який він підтримує: +Кожен канал використовує найчистіший транспорт, який підтримує: -| Канал | Транспорт перебігу | Примітки | +| Канал | Транспорт прогресу | Примітки | | --------------- | -------------------------------------- | --------------------------------------------------------------------- | -| Discord | Надіслати одне повідомлення, потім редагувати його. | Фінальний текст редагується на місці, коли вміщується в одне безпечне повідомлення попереднього перегляду. | -| Matrix | Надіслати одну подію, потім редагувати її. | Конфігурація потокової передачі на рівні облікового запису керує чернетками на рівні облікового запису. | -| Microsoft Teams | Нативний потік Teams в особистих чатах. | `streaming.mode: "block"` зіставляється з блоковою доставкою Teams. | -| Slack | Нативний потік або редагований допис-чернетка. | Доступність гілки впливає на те, чи можна використовувати нативну потокову передачу. | -| Telegram | Надіслати одне повідомлення, потім редагувати його. | Старі видимі чернетки можуть замінюватися, щоб фінальні часові позначки залишалися корисними. | +| Discord | Надіслати одне повідомлення, потім редагувати його. | Фінальний текст редагується на місці, коли він уміщується в одне безпечне повідомлення попереднього перегляду. | +| Matrix | Надіслати одну подію, потім редагувати її. | Конфігурація потокового передавання на рівні облікового запису керує чернетками на рівні облікового запису. | +| Microsoft Teams | Нативний потік Teams в особистих чатах. | `streaming.mode: "block"` зіставляється з блоковою доставкою Teams. | +| Slack | Нативний потік або редагований допис-чернетка. | Доступність треду впливає на те, чи можна використовувати нативне потокове передавання. | +| Telegram | Надіслати одне повідомлення, потім редагувати його. | Старіші видимі чернетки можуть бути замінені, щоб фінальні часові позначки залишалися корисними. | | Mattermost | Редагований допис-чернетка. | Активність інструментів згортається в той самий допис у стилі чернетки. | Канали без безпечної підтримки редагування зазвичай повертаються до індикаторів @@ -237,53 +242,52 @@ Surfacing Коли фінальна відповідь готова, OpenClaw намагається зберегти чат чистим: - Якщо чернетка може безпечно стати фінальною відповіддю, OpenClaw редагує її на місці. -- Якщо канал використовує нативну потокову передачу перебігу, OpenClaw фіналізує - цей потік, коли нативний транспорт приймає фінальний текст. -- Якщо фінальна відповідь містить медіа, запит на схвалення, явну ціль відповіді, - забагато фрагментів або невдале редагування/надсилання, OpenClaw надсилає фінальну - відповідь через звичайний шлях доставки каналу. +- Якщо канал використовує нативне потокове передавання прогресу, OpenClaw фіналізує цей потік, коли нативний транспорт приймає фінальний текст. +- Якщо фінальна відповідь містить медіа, запит на схвалення, явну ціль відповіді, надто багато фрагментів або невдале редагування/надсилання, OpenClaw надсилає фінальну відповідь через звичайний шлях доставки каналу. -Резервний шлях навмисний. Краще надіслати нову фінальну відповідь, ніж втратити -текст, помилково прив'язати відповідь до гілки або перезаписати чернетку корисним -навантаженням, яке канал не може безпечно представити. +Резервний шлях є навмисним. Краще надіслати нову фінальну відповідь, ніж +втратити текст, неправильно прив’язати відповідь до треду або перезаписати +чернетку корисним навантаженням, яке канал не може безпечно представити. ## Усунення несправностей **Я бачу лише фінальну відповідь.** Перевірте, що `channels..streaming.mode` встановлено на `progress` для -облікового запису або каналу, який обробив повідомлення. Деякі групові шляхи або -шляхи відповіді з цитуванням можуть вимкнути попередній перегляд чернетки для +облікового запису або каналу, який обробив повідомлення. Деякі групові шляхи +або шляхи відповіді з цитатою можуть вимикати попередні перегляди чернеток для ходу, коли канал не може безпечно редагувати правильне повідомлення. **Я бачу мітку, але не бачу рядків інструментів.** -Перевірте `streaming.progress.toolProgress`. Якщо значення `false`, OpenClaw -зберігає поведінку однієї чернетки, але приховує рядки перебігу інструментів і завдань. +Перевірте `streaming.progress.toolProgress`. Якщо це `false`, OpenClaw зберігає +поведінку єдиної чернетки, але приховує рядки прогресу інструментів і завдань. **Я бачу нове фінальне повідомлення замість відредагованої чернетки.** -Це резервний механізм безпеки. Це може трапитися для відповідей із медіа, довгих -відповідей, явних цілей відповіді, старих чернеток Telegram, відсутніх цілей гілок -Slack, видалених повідомлень попереднього перегляду або невдалої фіналізації нативного потоку. +Це резервний механізм безпеки. Таке може статися для відповідей із медіа, +довгих відповідей, явних цілей відповіді, старих чернеток Telegram, відсутніх +цілей тредів Slack, видалених повідомлень попереднього перегляду або невдалої +фіналізації нативного потоку. -**Я все ще бачу окремі повідомлення про перебіг.** +**Я все ще бачу окремі повідомлення про прогрес.** -Режим перебігу приглушує типові окремі повідомлення про перебіг інструментів, -коли чернетка активна. Якщо окремі повідомлення все ще з'являються, перевірте, -що хід справді використовує режим перебігу, а не `streaming.mode: "off"` або шлях -каналу, який не може створити чернетку для цього повідомлення. +Режим progress пригнічує типові окремі повідомлення про прогрес інструментів, +коли чернетка активна. Якщо окремі повідомлення все ще з’являються, перевірте, +що хід справді використовує режим progress, а не `streaming.mode: "off"` або +шлях каналу, який не може створити чернетку для цього повідомлення. **Teams поводиться інакше, ніж Discord або Telegram.** -Microsoft Teams використовує нативний потік в особистих чатах замість універсального -транспорту попереднього перегляду з надсиланням і редагуванням. Teams також трактує -`streaming.mode: "block"` як блокову доставку Teams, оскільки не має такого самого -блокового режиму попереднього перегляду чернеток, який використовують Discord і Telegram. +Microsoft Teams використовує нативний потік в особистих чатах замість +універсального транспорту попереднього перегляду з надсиланням і редагуванням. +Teams також трактує `streaming.mode: "block"` як блокову доставку Teams, +оскільки він не має такого самого режиму блокового попереднього перегляду +чернеток, який використовують Discord і Telegram. -## Пов'язане +## Пов’язане -- [Потокова передача й фрагментація](/uk/concepts/streaming) +- [Потокове передавання та фрагментація](/uk/concepts/streaming) - [Повідомлення](/uk/concepts/messages) - [Конфігурація каналів](/uk/gateway/config-channels) - [Discord](/uk/channels/discord)