chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
9f9254627d
commit
0d0683efd4
@ -1,23 +1,23 @@
|
||||
---
|
||||
read_when:
|
||||
- Налаштування видимих оновлень прогресу для тривалих ходів чату
|
||||
- Налаштування видимих оновлень прогресу для тривалих чат-взаємодій
|
||||
- Вибір між режимами потокового передавання partial, block і progress
|
||||
- Пояснення того, як OpenClaw оновлює одне повідомлення каналу, поки робота триває
|
||||
- Усунення несправностей із чернетками прогресу, окремими повідомленнями про прогрес або резервним варіантом фіналізації
|
||||
summary: 'Чернетки прогресу: одне видиме повідомлення про роботу в процесі, яке оновлюється, поки агент працює'
|
||||
- Пояснення, як OpenClaw оновлює одне повідомлення в каналі, поки триває робота
|
||||
- Усунення несправностей із чернетками прогресу, окремими повідомленнями про прогрес або резервним механізмом фіналізації
|
||||
summary: 'Чернетки прогресу: одне видиме повідомлення про хід виконання, яке оновлюється під час роботи агента'
|
||||
title: Чернетки прогресу
|
||||
x-i18n:
|
||||
generated_at: "2026-05-04T00:49:15Z"
|
||||
generated_at: "2026-05-04T02:55:03Z"
|
||||
model: gpt-5.5
|
||||
provider: openai
|
||||
source_hash: 8ce19262800f1c3c3e505a3cf1d41ed5c3dffcbca168ad7b7afabdce62eee8fe
|
||||
source_hash: c80397550032903e7c114649b0e3246884c4ab051bc36d2d09fd0b242f4c0c55
|
||||
source_path: concepts/progress-drafts.md
|
||||
workflow: 16
|
||||
---
|
||||
|
||||
Чернетки прогресу роблять довгі кроки агента живими в чаті, не перетворюючи розмову на стос тимчасових відповідей зі статусом.
|
||||
Чернетки прогресу роблять тривалі ходи агента живими в чаті, не перетворюючи розмову на стос тимчасових відповідей зі статусом.
|
||||
|
||||
Коли чернетки прогресу ввімкнено, OpenClaw створює одне видиме повідомлення про незавершену роботу лише після того, як крок доводить, що справді виконує роботу, оновлює його, поки агент читає, планує, викликає інструменти або чекає на схвалення, а потім перетворює цю чернетку на фінальну відповідь, коли канал може зробити це безпечно.
|
||||
Коли чернетки прогресу ввімкнено, OpenClaw створює одне видиме повідомлення з незавершеною роботою лише після того, як хід доведе, що справді виконує роботу, оновлює його, поки агент читає, планує, викликає інструменти або чекає на схвалення, а потім перетворює цю чернетку на фінальну відповідь, коли канал може зробити це безпечно.
|
||||
|
||||
```text
|
||||
Shelling...
|
||||
@ -26,7 +26,7 @@ Shelling...
|
||||
🛠️ Exec: run tests
|
||||
```
|
||||
|
||||
Використовуйте чернетки прогресу, коли вам потрібне одне охайне повідомлення зі статусом під час роботи з великою кількістю інструментів і фінальна відповідь після завершення кроку.
|
||||
Використовуйте чернетки прогресу, коли потрібне одне охайне статусне повідомлення під час роботи з великою кількістю інструментів і фінальна відповідь після завершення ходу.
|
||||
|
||||
## Швидкий старт
|
||||
|
||||
@ -44,7 +44,7 @@ Shelling...
|
||||
}
|
||||
```
|
||||
|
||||
Зазвичай цього достатньо. OpenClaw вибере автоматичну мітку з одного слова, зачекає, доки робота триватиме щонайменше п’ять секунд або випустить другу робочу подію, додасть компактні рядки прогресу, поки відбувається корисна робота, і приглушить дублікати окремих повідомлень про прогрес для цього кроку.
|
||||
Зазвичай цього достатньо. OpenClaw вибере автоматичну мітку з одного слова, зачекає, доки робота триватиме щонайменше п’ять секунд або видасть другу робочу подію, додаватиме компактні рядки прогресу, поки відбувається корисна робота, і придушуватиме дубльований окремий прогресний шум для цього ходу.
|
||||
|
||||
## Що бачать користувачі
|
||||
|
||||
@ -53,33 +53,33 @@ Shelling...
|
||||
| Частина | Призначення |
|
||||
| --------------- | --------------------------------------------------------------------------- |
|
||||
| Мітка | Короткий заголовок, наприклад `Thinking...` або `Shelling...`. |
|
||||
| Рядки прогресу | Компактні оновлення запуску з тими самими мітками й піктограмами інструментів, що й у докладному виводі. |
|
||||
| Рядки прогресу | Компактні оновлення запуску з тими самими мітками інструментів та іконками, що й у докладному виводі. |
|
||||
|
||||
Мітка з’являється після того, як агент починає змістовну роботу й або залишається зайнятим протягом п’яти секунд, або випускає другу робочу подію. Відповіді лише простим текстом не показують чернетку прогресу. Рядки прогресу додаються лише тоді, коли агент випускає корисні робочі оновлення, наприклад `🛠️ Exec`, `🔎 Web Search` або `✍️ Write: to /tmp/file`. За замовчуванням вони використовують той самий компактний режим пояснень, що й `/verbose`; установіть `agents.defaults.toolProgressDetail: "raw"` під час налагодження, якщо також хочете додавати необроблені команди/деталі.
|
||||
Мітка з’являється після того, як агент починає змістовну роботу й або залишається зайнятим протягом п’яти секунд, або видає другу робочу подію. Відповіді лише простим текстом не показують чернетку прогресу. Рядки прогресу додаються лише тоді, коли агент видає корисні робочі оновлення, наприклад `🛠️ Exec`, `🔎 Web Search` або `✍️ Write: to /tmp/file`. Типово вони використовують той самий компактний режим пояснення, що й `/verbose`; задайте `agents.defaults.toolProgressDetail: "raw"` під час налагодження, якщо також потрібне додавання сирих команд/подробиць.
|
||||
Фінальна відповідь замінює чернетку, коли це можливо; інакше OpenClaw надсилає фінальну відповідь звичайним способом і очищає або припиняє оновлювати чернетку відповідно до транспорту каналу.
|
||||
|
||||
## Виберіть режим
|
||||
## Вибір режиму
|
||||
|
||||
`channels.<channel>.streaming.mode` керує видимою поведінкою незавершеної роботи:
|
||||
`channels.<channel>.streaming.mode` керує видимою поведінкою під час виконання:
|
||||
|
||||
| Режим | Найкраще для | Що з’являється в чаті |
|
||||
| ---------- | ------------------------------------ | -------------------------------------------------- |
|
||||
| `off` | Тихі канали | Лише фінальна відповідь. |
|
||||
| `partial` | Спостереження за появою тексту відповіді | Одна чернетка, яку редагують із найновішим текстом відповіді. |
|
||||
| `block` | Більші фрагменти попереднього перегляду відповіді | Один попередній перегляд, який оновлюється або доповнюється більшими фрагментами. |
|
||||
| `progress` | Кроки з великою кількістю інструментів або довгим виконанням | Одна чернетка зі статусом, потім фінальна відповідь. |
|
||||
| `off` | Тихих каналів | Лише фінальна відповідь. |
|
||||
| `partial` | Спостереження за появою тексту відповіді | Одна чернетка, відредагована з найновішим текстом відповіді. |
|
||||
| `block` | Більших фрагментів попереднього перегляду відповіді | Один попередній перегляд, який оновлюється або доповнюється більшими фрагментами. |
|
||||
| `progress` | Ходів із багатьма інструментами або тривалим виконанням | Одна статусна чернетка, потім фінальна відповідь. |
|
||||
|
||||
Вибирайте `progress`, коли користувачам важливіше знати, «що відбувається», ніж спостерігати, як текст відповіді транслюється токен за токеном.
|
||||
Вибирайте `progress`, коли користувачам важливіше знати, «що відбувається», ніж бачити потокове надходження тексту відповіді токен за токеном.
|
||||
|
||||
Вибирайте `partial`, коли сама відповідь є сигналом прогресу.
|
||||
|
||||
Вибирайте `block`, коли хочете оновлення чернетки попереднього перегляду більшими текстовими фрагментами. У Discord і Telegram `streaming.mode: "block"` усе ще є потоковим попереднім переглядом, а не звичайною блоковою доставкою. Використовуйте `streaming.block.enabled` або застаріле `blockStreaming`, коли вам потрібні звичайні блокові відповіді.
|
||||
Вибирайте `block`, коли потрібні оновлення чернетки попереднього перегляду більшими текстовими фрагментами. У Discord і Telegram `streaming.mode: "block"` усе ще означає потоковий попередній перегляд, а не звичайну блокову доставку. Використовуйте `streaming.block.enabled` або застарілий `blockStreaming`, коли потрібні звичайні блокові відповіді.
|
||||
|
||||
## Налаштуйте мітки
|
||||
## Налаштування міток
|
||||
|
||||
Мітки прогресу розміщені в `channels.<channel>.streaming.progress`.
|
||||
Мітки прогресу розташовані в `channels.<channel>.streaming.progress`.
|
||||
|
||||
Типова мітка — `auto`, яка вибирає з вбудованого пулу міток OpenClaw у форматі одного слова з трикрапкою:
|
||||
Типова мітка — `auto`, яка вибирає з вбудованого в OpenClaw набору міток з одного слова з трьома крапками:
|
||||
|
||||
```text
|
||||
Thinking...
|
||||
@ -104,7 +104,7 @@ Snapping...
|
||||
Surfacing...
|
||||
```
|
||||
|
||||
Використовуйте фіксовану мітку:
|
||||
Використайте фіксовану мітку:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -121,7 +121,7 @@ Surfacing...
|
||||
}
|
||||
```
|
||||
|
||||
Використовуйте власний автоматичний пул міток:
|
||||
Використайте власний автоматичний набір міток:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -156,9 +156,9 @@ Surfacing...
|
||||
}
|
||||
```
|
||||
|
||||
## Керуйте рядками прогресу
|
||||
## Керування рядками прогресу
|
||||
|
||||
У режимі прогресу рядки прогресу ввімкнено за замовчуванням. Вони походять із реальних подій запуску: запусків інструментів, оновлень елементів, планів завдань, схвалень, виводу команд, підсумків патчів і подібної активності агента.
|
||||
Рядки прогресу ввімкнено типово в режимі прогресу. Вони походять із реальних подій запуску: запусків інструментів, оновлень елементів, планів завдань, схвалень, виводу команд, підсумків патчів і подібної активності агента.
|
||||
|
||||
OpenClaw використовує той самий форматер для чернеток прогресу й `/verbose`:
|
||||
|
||||
@ -172,13 +172,13 @@ OpenClaw використовує той самий форматер для че
|
||||
}
|
||||
```
|
||||
|
||||
`"explain"` є типовим значенням і підтримує стабільність чернеток за допомогою стислих міток на кшталт `🛠️ Exec: check JS syntax for /tmp/app.js`. `"raw"` додає базову команду/деталь, коли вона доступна, що корисно під час налагодження, але створює більше шуму в чаті.
|
||||
`"explain"` є типовим і зберігає чернетки стабільними завдяки стислим міткам на кшталт `🛠️ Exec: check JS syntax for /tmp/app.js`. `"raw"` додає базову команду/подробицю, коли вона доступна, що корисно під час налагодження, але створює більше шуму в чаті.
|
||||
|
||||
Наприклад, та сама команда виглядає по-різному залежно від режиму деталізації:
|
||||
Наприклад, одна й та сама команда виглядає по-різному залежно від режиму деталізації:
|
||||
|
||||
| Режим | Рядок прогресу |
|
||||
| --------- | ------------------------------------------------------------------ |
|
||||
| `explain` | `🛠️ Exec: check JS syntax for /tmp/app.js` |
|
||||
| Режим | Рядок прогресу |
|
||||
| --------- | -------------------------------------------------------------------- |
|
||||
| `explain` | `🛠️ Exec: check JS syntax for /tmp/app.js` |
|
||||
| `raw` | `🛠️ Exec: check JS syntax for /tmp/app.js, node --check /tmp/app.js` |
|
||||
|
||||
Обмежте кількість рядків, що залишаються видимими:
|
||||
@ -198,7 +198,11 @@ OpenClaw використовує той самий форматер для че
|
||||
}
|
||||
```
|
||||
|
||||
Залиште єдину чернетку прогресу, але приховайте рядки інструментів і завдань:
|
||||
Рядки прогресу автоматично ущільнюються, щоб зменшити переливання бульбашки чату під час редагування чернетки.
|
||||
|
||||
OpenClaw типово обрізає довгі рядки прогресу, щоб повторні редагування чернетки не переносилися по-різному під час кожного оновлення. Префікс залишається читабельним, а довгі подробиці, як-от шляхи або сирі команди, скорочуються трьома крапками.
|
||||
|
||||
Залиште одну чернетку прогресу, але приховайте рядки інструментів і завдань:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -215,58 +219,58 @@ OpenClaw використовує той самий форматер для че
|
||||
}
|
||||
```
|
||||
|
||||
З `toolProgress: false` OpenClaw усе одно приглушує старі окремі повідомлення про прогрес інструментів для цього кроку. Канал залишається візуально тихим до фінальної відповіді, окрім мітки, якщо її налаштовано.
|
||||
З `toolProgress: false` OpenClaw усе одно придушує старіші окремі повідомлення прогресу інструментів для цього ходу. Канал залишається візуально тихим до фінальної відповіді, за винятком мітки, якщо її налаштовано.
|
||||
|
||||
## Поведінка каналів
|
||||
|
||||
Кожен канал використовує найохайніший транспорт, який підтримує:
|
||||
Кожен канал використовує найчистіший транспорт, який він підтримує:
|
||||
|
||||
| Канал | Транспорт прогресу | Примітки |
|
||||
| --------------- | -------------------------------------- | --------------------------------------------------------------------- |
|
||||
| Discord | Надіслати одне повідомлення, потім редагувати його. | Фінальний текст редагується на місці, коли вміщується в одне безпечне повідомлення попереднього перегляду. |
|
||||
| Канал | Транспорт прогресу | Примітки |
|
||||
| --------------- | ------------------------------------- | --------------------------------------------------------------------- |
|
||||
| Discord | Надіслати одне повідомлення, потім редагувати його. | Фінальний текст редагується на місці, коли він уміщується в одне безпечне повідомлення попереднього перегляду. |
|
||||
| Matrix | Надіслати одну подію, потім редагувати її. | Конфігурація потокового передавання на рівні облікового запису керує чернетками на рівні облікового запису. |
|
||||
| Microsoft Teams | Нативний потік Teams в особистих чатах. | `streaming.mode: "block"` зіставляється з блоковою доставкою Teams. |
|
||||
| Slack | Нативний потік або редагований допис-чернетка. | Доступність гілки впливає на те, чи можна використовувати нативне потокове передавання. |
|
||||
| Telegram | Надіслати одне повідомлення, потім редагувати його. | Старі видимі чернетки можуть бути замінені, щоб фінальні часові позначки залишалися корисними. |
|
||||
| Mattermost | Редагований допис-чернетка. | Активність інструментів згортається в той самий допис у стилі чернетки. |
|
||||
| Slack | Нативний потік або редагований допис-чернетка. | Доступність треду впливає на те, чи можна використовувати нативне потокове передавання. |
|
||||
| Telegram | Надіслати одне повідомлення, потім редагувати його. | Старіші видимі чернетки можуть замінюватися, щоб фінальні часові позначки залишалися корисними. |
|
||||
| Mattermost | Редагований допис-чернетка. | Активність інструментів згортається в той самий допис у стилі чернетки. |
|
||||
|
||||
Канали без безпечної підтримки редагування зазвичай повертаються до індикаторів набору тексту або доставки лише фінальної відповіді.
|
||||
|
||||
## Фіналізація
|
||||
|
||||
Коли фінальна відповідь готова, OpenClaw намагається зберегти чат охайним:
|
||||
Коли фінальна відповідь готова, OpenClaw намагається зберегти чат чистим:
|
||||
|
||||
- Якщо чернетка може безпечно стати фінальною відповіддю, OpenClaw редагує її на місці.
|
||||
- Якщо канал використовує нативне потокове передавання прогресу, OpenClaw фіналізує цей потік, коли нативний транспорт приймає фінальний текст.
|
||||
- Якщо фінальна відповідь має медіа, запит на схвалення, явну ціль відповіді, забагато фрагментів або невдале редагування/надсилання, OpenClaw надсилає фінальну відповідь через звичайний шлях доставки каналу.
|
||||
- Якщо фінальна відповідь містить медіа, запит на схвалення, явну ціль відповіді, забагато фрагментів або невдале редагування/надсилання, OpenClaw надсилає фінальну відповідь через звичайний шлях доставки каналу.
|
||||
|
||||
Резервний шлях є навмисним. Краще надіслати нову фінальну відповідь, ніж втратити текст, неправильно прив’язати відповідь до гілки або перезаписати чернетку корисним навантаженням, яке канал не може безпечно представити.
|
||||
Резервний шлях є навмисним. Краще надіслати свіжу фінальну відповідь, ніж втратити текст, помилитися з тредом відповіді або перезаписати чернетку корисним навантаженням, яке канал не може безпечно представити.
|
||||
|
||||
## Усунення несправностей
|
||||
|
||||
**Я бачу лише фінальну відповідь.**
|
||||
|
||||
Перевірте, що `channels.<channel>.streaming.mode` установлено на `progress` для облікового запису або каналу, який обробив повідомлення. Деякі шляхи груп або відповідей із цитуванням можуть вимикати попередні перегляди чернеток для кроку, коли канал не може безпечно редагувати правильне повідомлення.
|
||||
Перевірте, що `channels.<channel>.streaming.mode` встановлено в `progress` для облікового запису або каналу, який обробив повідомлення. Деякі шляхи груп або відповідей із цитуванням можуть вимикати попередні перегляди чернеток для ходу, коли канал не може безпечно редагувати правильне повідомлення.
|
||||
|
||||
**Я бачу мітку, але не бачу рядків інструментів.**
|
||||
|
||||
Перевірте `streaming.progress.toolProgress`. Якщо це `false`, OpenClaw зберігає поведінку однієї чернетки, але приховує рядки прогресу інструментів і завдань.
|
||||
Перевірте `streaming.progress.toolProgress`. Якщо це `false`, OpenClaw зберігає поведінку з однією чернеткою, але приховує рядки прогресу інструментів і завдань.
|
||||
|
||||
**Я бачу нове фінальне повідомлення замість відредагованої чернетки.**
|
||||
|
||||
Це безпечний резервний варіант. Таке може статися для відповідей із медіа, довгих відповідей, явних цілей відповіді, старих чернеток Telegram, відсутніх цілей гілок Slack, видалених повідомлень попереднього перегляду або невдалої фіналізації нативного потоку.
|
||||
Це безпечний резервний варіант. Таке може статися для відповідей із медіа, довгих відповідей, явних цілей відповіді, старих чернеток Telegram, відсутніх цілей тредів Slack, видалених повідомлень попереднього перегляду або невдалої фіналізації нативного потоку.
|
||||
|
||||
**Я досі бачу окремі повідомлення про прогрес.**
|
||||
**Я все ще бачу окремі повідомлення прогресу.**
|
||||
|
||||
Режим прогресу приглушує типові окремі повідомлення про прогрес інструментів, коли чернетка активна. Якщо окремі повідомлення все ще з’являються, перевірте, що крок справді використовує режим прогресу, а не `streaming.mode: "off"` або шлях каналу, який не може створити чернетку для цього повідомлення.
|
||||
Режим прогресу придушує типові окремі повідомлення прогресу інструментів, коли чернетка активна. Якщо окремі повідомлення все ще з’являються, перевірте, що хід справді використовує режим прогресу, а не `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)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user