chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
7b630b7e6d
commit
45dad4e620
@ -1,58 +1,58 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете зрозуміти автостиснення та /compact
|
||||
- Ви налагоджуєте довгі сесії, які впираються в ліміти контексту
|
||||
summary: Як OpenClaw підсумовує довгі розмови, щоб залишатися в межах лімітів моделі
|
||||
title: Стиснення
|
||||
- Ви хочете зрозуміти автоматичний Compaction і `/compact`
|
||||
- Ви налагоджуєте довгі сесії, які досягають лімітів контексту
|
||||
summary: Як OpenClaw підсумовує довгі розмови, щоб залишатися в межах обмежень моделі
|
||||
title: Compaction
|
||||
x-i18n:
|
||||
generated_at: "2026-04-07T17:57:31Z"
|
||||
generated_at: "2026-04-20T18:56:56Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: e6590b82a8c3a9c310998d653459ca4d8612495703ca0a8d8d306d7643142fd1
|
||||
source_hash: 382e4a879e65199bd98d7476bff556571e09344a21e909862a34e6029db6d765
|
||||
source_path: concepts/compaction.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Стиснення
|
||||
# Compaction
|
||||
|
||||
Кожна модель має контекстне вікно — максимальну кількість токенів, яку вона може обробити.
|
||||
Коли розмова наближається до цього ліміту, OpenClaw **стискає** старіші повідомлення
|
||||
у підсумок, щоб чат міг продовжуватися.
|
||||
Кожна модель має вікно контексту — максимальну кількість токенів, яку вона може обробити.
|
||||
Коли розмова наближається до цього ліміту, OpenClaw **ущільнює** старіші повідомлення
|
||||
у зведення, щоб чат міг продовжуватися.
|
||||
|
||||
## Як це працює
|
||||
|
||||
1. Старіші ходи розмови підсумовуються в компактний запис.
|
||||
2. Підсумок зберігається в транскрипті сесії.
|
||||
3. Недавні повідомлення зберігаються без змін.
|
||||
2. Зведення зберігається в транскрипті сесії.
|
||||
3. Нещодавні повідомлення зберігаються без змін.
|
||||
|
||||
Коли OpenClaw ділить історію на фрагменти для стиснення, він зберігає виклики
|
||||
Коли OpenClaw розбиває історію на фрагменти Compaction, він зберігає виклики
|
||||
інструментів асистента в парі з відповідними записами `toolResult`. Якщо точка
|
||||
розділення потрапляє всередину блоку інструмента, OpenClaw зміщує межу, щоб пара
|
||||
залишалася разом і поточний непідсумований хвіст зберігався.
|
||||
розбиття потрапляє всередину блоку інструменту, OpenClaw зсуває межу, щоб пара
|
||||
залишалася разом, а поточний непідсумований хвіст зберігався.
|
||||
|
||||
Повна історія розмови залишається на диску. Стиснення змінює лише те, що
|
||||
Повна історія розмови залишається на диску. Compaction змінює лише те, що
|
||||
модель бачить на наступному ході.
|
||||
|
||||
## Автостиснення
|
||||
## Автоматичний Compaction
|
||||
|
||||
Автостиснення увімкнене за замовчуванням. Воно запускається, коли сесія
|
||||
Автоматичний Compaction увімкнено за замовчуванням. Він запускається, коли сесія
|
||||
наближається до ліміту контексту, або коли модель повертає помилку переповнення
|
||||
контексту (у такому разі OpenClaw стискає і повторює спробу). Типові ознаки
|
||||
переповнення включають
|
||||
контексту (у такому разі OpenClaw виконує Compaction і повторює спробу). Типові
|
||||
ознаки переповнення включають
|
||||
`request_too_large`, `context length exceeded`, `input exceeds the maximum
|
||||
number of tokens`, `input token count exceeds the maximum number of input
|
||||
tokens`, `input is too long for the model` і `ollama error: context length
|
||||
exceeded`.
|
||||
|
||||
<Info>
|
||||
Перед стисненням OpenClaw автоматично нагадує агенту зберегти важливі
|
||||
Перед Compaction OpenClaw автоматично нагадує агенту зберегти важливі
|
||||
нотатки у файли [memory](/uk/concepts/memory). Це запобігає втраті контексту.
|
||||
</Info>
|
||||
|
||||
Використовуйте параметр `agents.defaults.compaction` у вашому `openclaw.json`, щоб налаштувати поведінку стиснення (режим, цільову кількість токенів тощо).
|
||||
Підсумовування під час стиснення за замовчуванням зберігає непрозорі ідентифікатори (`identifierPolicy: "strict"`). Ви можете перевизначити це за допомогою `identifierPolicy: "off"` або надати власний текст через `identifierPolicy: "custom"` і `identifierInstructions`.
|
||||
Використовуйте налаштування `agents.defaults.compaction` у вашому `openclaw.json`, щоб налаштувати поведінку Compaction (режим, цільову кількість токенів тощо).
|
||||
Підсумовування Compaction за замовчуванням зберігає непрозорі ідентифікатори (`identifierPolicy: "strict"`). Ви можете змінити це за допомогою `identifierPolicy: "off"` або надати власний текст через `identifierPolicy: "custom"` і `identifierInstructions`.
|
||||
|
||||
За бажанням ви можете вказати іншу модель для підсумовування під час стиснення через `agents.defaults.compaction.model`. Це корисно, коли ваша основна модель є локальною або малою моделлю, а ви хочете, щоб підсумки стиснення створювала потужніша модель. Перевизначення приймає будь-який рядок `provider/model-id`:
|
||||
Ви також можете за бажанням вказати іншу модель для підсумовування Compaction через `agents.defaults.compaction.model`. Це корисно, коли ваша основна модель є локальною або малою моделлю, а ви хочете, щоб зведення Compaction створювалися більш потужною моделлю. Перевизначення приймає будь-який рядок `provider/model-id`:
|
||||
|
||||
```json
|
||||
{
|
||||
@ -66,7 +66,7 @@ exceeded`.
|
||||
}
|
||||
```
|
||||
|
||||
Це також працює з локальними моделями, наприклад із другою моделлю Ollama, призначеною для підсумовування, або спеціалістом зі стиснення, налаштованим під конкретну задачу:
|
||||
Це також працює з локальними моделями, наприклад із другою моделлю Ollama, виділеною для підсумовування, або зі спеціалістом Compaction, донавченим під це завдання:
|
||||
|
||||
```json
|
||||
{
|
||||
@ -80,11 +80,11 @@ exceeded`.
|
||||
}
|
||||
```
|
||||
|
||||
Якщо значення не задано, для стиснення використовується основна модель агента.
|
||||
Якщо значення не задано, Compaction використовує основну модель агента.
|
||||
|
||||
## Підключувані провайдери стиснення
|
||||
## Підключувані провайдери Compaction
|
||||
|
||||
Plugins можуть реєструвати власний провайдер стиснення через `registerCompactionProvider()` в API плагіна. Коли провайдер зареєстрований і налаштований, OpenClaw делегує підсумовування йому замість вбудованого LLM-конвеєра.
|
||||
Плагіни можуть реєструвати власний провайдер Compaction через `registerCompactionProvider()` в API плагіна. Коли провайдер зареєстровано та налаштовано, OpenClaw делегує йому підсумовування замість вбудованого LLM-конвеєра.
|
||||
|
||||
Щоб використовувати зареєстрований провайдер, задайте ідентифікатор провайдера у своїй конфігурації:
|
||||
|
||||
@ -100,24 +100,24 @@ Plugins можуть реєструвати власний провайдер с
|
||||
}
|
||||
```
|
||||
|
||||
Встановлення `provider` автоматично примусово вмикає `mode: "safeguard"`. Провайдери отримують ті самі інструкції зі стиснення та політику збереження ідентифікаторів, що й у вбудованому шляху, а OpenClaw усе одно зберігає контекст недавніх ходів і розділених ходів у суфіксі після виходу провайдера. Якщо провайдер зазнає збою або повертає порожній результат, OpenClaw повертається до вбудованого LLM-підсумовування.
|
||||
Установлення `provider` автоматично примусово вмикає `mode: "safeguard"`. Провайдери отримують ті самі інструкції Compaction і політику збереження ідентифікаторів, що й у вбудованому шляху, а OpenClaw, як і раніше, зберігає контекст суфікса нещодавніх ходів і розділених ходів після вихідних даних провайдера. Якщо провайдер завершується з помилкою або повертає порожній результат, OpenClaw повертається до вбудованого LLM-підсумовування.
|
||||
|
||||
## Автостиснення (увімкнено за замовчуванням)
|
||||
## Автоматичний Compaction (увімкнено за замовчуванням)
|
||||
|
||||
Коли сесія наближається до контекстного вікна моделі або перевищує його, OpenClaw запускає автостиснення і може повторити початковий запит, використовуючи стиснений контекст.
|
||||
Коли сесія наближається до вікна контексту моделі або перевищує його, OpenClaw запускає автоматичний Compaction і може повторити початковий запит, використовуючи ущільнений контекст.
|
||||
|
||||
Ви побачите:
|
||||
|
||||
- `🧹 Auto-compaction complete` у докладному режимі
|
||||
- `/status`, що показує `🧹 Compactions: <count>`
|
||||
- `/status`, де показано `🧹 Compactions: <count>`
|
||||
|
||||
Перед стисненням OpenClaw може виконати **тихий скид memory**, щоб зберегти
|
||||
довготривалі нотатки на диск. Докладніше про деталі та конфігурацію див. у [Memory](/uk/concepts/memory).
|
||||
Перед Compaction OpenClaw може виконати **тихий скид пам’яті**, щоб зберегти
|
||||
довготривалі нотатки на диск. Докладніше про це та налаштування дивіться у [Memory](/uk/concepts/memory).
|
||||
|
||||
## Ручне стиснення
|
||||
## Ручний Compaction
|
||||
|
||||
Введіть `/compact` у будь-якому чаті, щоб примусово запустити стиснення. Додайте інструкції, щоб спрямувати
|
||||
підсумок:
|
||||
Введіть `/compact` у будь-якому чаті, щоб примусово виконати Compaction. Додайте інструкції, щоб спрямувати
|
||||
зведення:
|
||||
|
||||
```
|
||||
/compact Focus on the API design decisions
|
||||
@ -125,8 +125,8 @@ Plugins можуть реєструвати власний провайдер с
|
||||
|
||||
## Використання іншої моделі
|
||||
|
||||
За замовчуванням для стиснення використовується основна модель вашого агента. Ви можете використовувати більш
|
||||
потужну модель для кращих підсумків:
|
||||
За замовчуванням Compaction використовує основну модель вашого агента. Ви можете використовувати більш
|
||||
потужну модель для кращих зведень:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -140,10 +140,10 @@ Plugins можуть реєструвати власний провайдер с
|
||||
}
|
||||
```
|
||||
|
||||
## Сповіщення про початок стиснення
|
||||
## Сповіщення Compaction
|
||||
|
||||
За замовчуванням стиснення виконується без повідомлень. Щоб показувати коротке сповіщення, коли стиснення
|
||||
починається, увімкніть `notifyUser`:
|
||||
За замовчуванням Compaction виконується без повідомлень. Щоб показувати короткі сповіщення, коли Compaction
|
||||
починається і коли він завершується, увімкніть `notifyUser`:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -157,39 +157,39 @@ Plugins можуть реєструвати власний провайдер с
|
||||
}
|
||||
```
|
||||
|
||||
Коли цю опцію ввімкнено, користувач бачить коротке повідомлення (наприклад, "Compacting
|
||||
context...") на початку кожного запуску стиснення.
|
||||
Коли цю опцію увімкнено, користувач бачить короткі повідомлення про стан під час кожного запуску Compaction
|
||||
(наприклад, "Compacting context..." і "Compaction complete").
|
||||
|
||||
## Стиснення проти обрізання
|
||||
## Compaction vs pruning
|
||||
|
||||
| | Стиснення | Обрізання |
|
||||
| ---------------- | ---------------------------- | --------------------------------- |
|
||||
| **Що це робить** | Підсумовує старішу розмову | Обрізає старі результати інструментів |
|
||||
| **Зберігається?**| Так (у транскрипті сесії) | Ні (лише в пам’яті, для кожного запиту) |
|
||||
| **Обсяг** | Уся розмова | Лише результати інструментів |
|
||||
| | Compaction | Pruning |
|
||||
| ---------------- | --------------------------- | --------------------------------- |
|
||||
| **Що це робить** | Підсумовує старішу розмову | Обрізає старі результати інструментів |
|
||||
| **Зберігається?**| Так (у транскрипті сесії) | Ні (лише в пам’яті, для запиту) |
|
||||
| **Обсяг** | Уся розмова | Лише результати інструментів |
|
||||
|
||||
[Обрізання сесії](/uk/concepts/session-pruning) — це легше доповнення, яке
|
||||
[Session pruning](/uk/concepts/session-pruning) — це легше доповнення, яке
|
||||
обрізає вивід інструментів без підсумовування.
|
||||
|
||||
## Усунення неполадок
|
||||
## Усунення проблем
|
||||
|
||||
**Стиснення відбувається надто часто?** Контекстне вікно моделі може бути малим, або результати
|
||||
**Compaction відбувається надто часто?** Вікно контексту моделі може бути малим, або виводи
|
||||
інструментів можуть бути великими. Спробуйте увімкнути
|
||||
[обрізання сесії](/uk/concepts/session-pruning).
|
||||
[session pruning](/uk/concepts/session-pruning).
|
||||
|
||||
**Після стиснення контекст здається застарілим?** Використайте `/compact Focus on <topic>`, щоб
|
||||
спрямувати підсумок, або увімкніть [скид memory](/uk/concepts/memory), щоб нотатки
|
||||
**Після Compaction контекст здається застарілим?** Використайте `/compact Focus on <topic>`, щоб
|
||||
спрямувати зведення, або ввімкніть [memory flush](/uk/concepts/memory), щоб нотатки
|
||||
зберігалися.
|
||||
|
||||
**Потрібен чистий аркуш?** `/new` починає нову сесію без стиснення.
|
||||
**Потрібно почати з чистого аркуша?** `/new` запускає нову сесію без Compaction.
|
||||
|
||||
Для розширеної конфігурації (резерв токенів, збереження ідентифікаторів, власні
|
||||
рушії контексту, серверне стиснення OpenAI) див. розділ
|
||||
[Поглиблений огляд керування сесіями](/uk/reference/session-management-compaction).
|
||||
Для розширеної конфігурації (резерв токенів, збереження ідентифікаторів, спеціальні
|
||||
рушії контексту, серверний Compaction OpenAI) дивіться
|
||||
[Поглиблений розбір керування сесіями](/uk/reference/session-management-compaction).
|
||||
|
||||
## Пов’язане
|
||||
|
||||
- [Сесія](/uk/concepts/session) — керування сесією та її життєвий цикл
|
||||
- [Обрізання сесії](/uk/concepts/session-pruning) — обрізання результатів інструментів
|
||||
- [Контекст](/uk/concepts/context) — як формується контекст для ходів агента
|
||||
- [Hooks](/uk/automation/hooks) — хуки життєвого циклу стиснення (before_compaction, after_compaction)
|
||||
- [Session](/uk/concepts/session) — керування сесією та її життєвий цикл
|
||||
- [Session Pruning](/uk/concepts/session-pruning) — обрізання результатів інструментів
|
||||
- [Context](/uk/concepts/context) — як будується контекст для ходів агента
|
||||
- [Hooks](/uk/automation/hooks) — хуки життєвого циклу Compaction (`before_compaction`, `after_compaction`)
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue
Block a user