From 1195ae8f489c6382bf58051ecf79cf4f3bd47f55 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Fri, 1 May 2026 19:20:06 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/concepts/compaction.md | 104 ++++++++++++++++----------------- 1 file changed, 50 insertions(+), 54 deletions(-) diff --git a/docs/uk/concepts/compaction.md b/docs/uk/concepts/compaction.md index 53208dd6f..3802c4501 100644 --- a/docs/uk/concepts/compaction.md +++ b/docs/uk/concepts/compaction.md @@ -1,46 +1,46 @@ --- read_when: - - Ви хочете зрозуміти автоматичну Compaction і /compact - - Ви налагоджуєте тривалі сеанси, які досягають обмежень контексту -summary: Як OpenClaw підсумовує довгі розмови, щоб залишатися в межах обмежень моделі + - Ви хочете зрозуміти автоматичне стискання і /compact + - Ви налагоджуєте довгі сеанси, що досягають обмежень контексту +summary: Як OpenClaw узагальнює довгі розмови, щоб залишатися в межах обмежень моделі title: Compaction x-i18n: - generated_at: "2026-04-28T11:08:34Z" + generated_at: "2026-05-01T19:19:30Z" model: gpt-5.5 provider: openai - source_hash: 9beac513a8226a7dd107cdc3a7bfd7550d87e98648004c80487db968c57742d4 + source_hash: 2f8e6f372508a0f5421654d3e2a694695eb8a7fda4e3928159bf8f08b2a2156b source_path: concepts/compaction.md workflow: 16 --- -Кожна модель має контекстне вікно: максимальну кількість токенів, які вона може обробити. Коли розмова наближається до цього ліміту, OpenClaw **Compaction** старіші повідомлення в підсумок, щоб чат міг продовжуватися. +Кожна модель має вікно контексту: максимальну кількість токенів, яку вона може обробити. Коли розмова наближається до цього ліміту, OpenClaw **ущільнює** старіші повідомлення в підсумок, щоб чат міг продовжуватися. ## Як це працює -1. Старіші кроки розмови узагальнюються в компактний запис. -2. Підсумок зберігається в транскрипті сесії. -3. Нещодавні повідомлення залишаються без змін. +1. Старіші ходи розмови підсумовуються в компактний запис. +2. Підсумок зберігається в транскрипті сеансу. +3. Останні повідомлення зберігаються без змін. -Коли OpenClaw розділяє історію на фрагменти Compaction, він зберігає виклики інструментів асистента разом із відповідними записами `toolResult`. Якщо точка розділення потрапляє всередину блоку інструмента, OpenClaw пересуває межу так, щоб пара залишалася разом, а поточний неузагальнений хвіст зберігався. +Коли OpenClaw розбиває історію на фрагменти Compaction, він зберігає виклики інструментів асистента разом із відповідними записами `toolResult`. Якщо точка розбиття потрапляє всередину блоку інструмента, OpenClaw зміщує межу, щоб пара залишалася разом, а поточний непідсумований хвіст зберігався. -Повна історія розмови залишається на диску. Compaction змінює лише те, що модель бачить під час наступного кроку. +Повна історія розмови залишається на диску. Compaction змінює лише те, що модель бачить на наступному ході. ## Автоматичний Compaction -Автоматичний Compaction увімкнено за замовчуванням. Він запускається, коли сесія наближається до ліміту контексту, або коли модель повертає помилку переповнення контексту (у цьому випадку OpenClaw виконує Compaction і повторює спробу). +Автоматичний Compaction увімкнено за замовчуванням. Він запускається, коли сеанс наближається до ліміту контексту або коли модель повертає помилку переповнення контексту (у такому разі OpenClaw виконує Compaction і повторює спробу). Ви побачите: - `🧹 Auto-compaction complete` у докладному режимі. -- `/status` показує `🧹 Compactions: `. +- `/status`, що показує `🧹 Compactions: `. Перед Compaction OpenClaw автоматично нагадує агенту зберегти важливі нотатки у файли [пам’яті](/uk/concepts/memory). Це запобігає втраті контексту. - - OpenClaw виявляє переповнення контексту за такими шаблонами помилок провайдерів: + + OpenClaw виявляє переповнення контексту за такими шаблонами помилок провайдера: - `request_too_large` - `context length exceeded` @@ -60,15 +60,15 @@ x-i18n: /compact Focus on the API design decisions ``` -Коли встановлено `agents.defaults.compaction.keepRecentTokens`, ручний Compaction дотримується цієї точки відсікання Pi й зберігає нещодавній хвіст у перебудованому контексті. Без явного бюджету збереження ручний Compaction поводиться як жорстка контрольна точка й продовжує лише з нового підсумку. +Коли `agents.defaults.compaction.keepRecentTokens` задано, ручний Compaction враховує цю точку відсікання Pi та зберігає нещодавній хвіст у перебудованому контексті. Без явного бюджету збереження ручний Compaction поводиться як жорстка контрольна точка й продовжує лише з нового підсумку. ## Конфігурація -Налаштуйте Compaction у `agents.defaults.compaction` у вашому `openclaw.json`. Найпоширеніші параметри наведено нижче; повну довідку див. у [поглибленому огляді керування сесіями](/uk/reference/session-management-compaction). +Налаштуйте Compaction у `agents.defaults.compaction` у вашому `openclaw.json`. Найпоширеніші параметри наведено нижче; повну довідку див. у [поглибленому огляді керування сеансами](/uk/reference/session-management-compaction). ### Використання іншої моделі -За замовчуванням Compaction використовує основну модель агента. Установіть `agents.defaults.compaction.model`, щоб делегувати узагальнення потужнішій або спеціалізованій моделі. Перевизначення приймає будь-який рядок `provider/model-id`: +За замовчуванням Compaction використовує основну модель агента. Установіть `agents.defaults.compaction.model`, щоб делегувати підсумовування потужнішій або спеціалізованій моделі. Перевизначення приймає будь-який рядок `provider/model-id`: ```json { @@ -82,7 +82,7 @@ x-i18n: } ``` -Це також працює з локальними моделями, наприклад із другою моделлю Ollama, призначеною для узагальнення: +Це також працює з локальними моделями, наприклад із другою моделлю Ollama, призначеною для підсумовування: ```json { @@ -96,34 +96,30 @@ x-i18n: } ``` -Якщо не задано, Compaction використовує основну модель агента. +Якщо не задано, Compaction починається з активної моделі сеансу. Якщо підсумовування завершується помилкою провайдера, придатною для резервної моделі, OpenClaw повторює цю спробу Compaction через наявний ланцюжок резервних моделей сеансу. Вибір резервної моделі тимчасовий і не записується назад у стан сеансу. Явне перевизначення `agents.defaults.compaction.model` залишається точним і не успадковує резервний ланцюжок сеансу. ### Збереження ідентифікаторів -Узагальнення Compaction за замовчуванням зберігає непрозорі ідентифікатори (`identifierPolicy: "strict"`). Перевизначте на `identifierPolicy: "off"`, щоб вимкнути це, або використайте `identifierPolicy: "custom"` разом із `identifierInstructions` для власних вказівок. +Підсумовування Compaction за замовчуванням зберігає непрозорі ідентифікатори (`identifierPolicy: "strict"`). Перевизначте на `identifierPolicy: "off"`, щоб вимкнути, або використайте `identifierPolicy: "custom"` разом з `identifierInstructions` для власних вказівок. -### Обмежувач байтів активного транскрипта +### Захист розміру активного транскрипта в байтах -Коли встановлено `agents.defaults.compaction.maxActiveTranscriptBytes`, OpenClaw запускає звичайний локальний Compaction перед виконанням, якщо активний JSONL досягає цього розміру. Це корисно для довготривалих сесій, де керування контекстом на боці провайдера може підтримувати здоровий контекст моделі, тоді як локальний транскрипт продовжує зростати. Це не розділяє сирі байти JSONL; натомість просить звичайний конвеєр Compaction створити семантичний підсумок. +Коли задано `agents.defaults.compaction.maxActiveTranscriptBytes`, OpenClaw запускає звичайний локальний Compaction перед виконанням, якщо активний JSONL досягає цього розміру. Це корисно для довготривалих сеансів, де керування контекстом на боці провайдера може підтримувати контекст моделі в нормальному стані, тоді як локальний транскрипт продовжує зростати. Це не розбиває сирі байти JSONL; воно просить звичайний конвеєр Compaction створити семантичний підсумок. -Обмежувач байтів потребує `truncateAfterCompaction: true`. Без ротації транскрипта активний файл не зменшиться, і обмежувач залишиться неактивним. +Захист за байтами потребує `truncateAfterCompaction: true`. Без ротації транскрипта активний файл не зменшиться, і захист залишиться неактивним. ### Наступні транскрипти -Коли ввімкнено `agents.defaults.compaction.truncateAfterCompaction`, OpenClaw не переписує наявний транскрипт на місці. Він створює новий активний наступний транскрипт із підсумку Compaction, збереженого стану й неузагальненого хвоста, а попередній JSONL залишає як архівне джерело контрольної точки. -Наступні транскрипти також відкидають точні дублікати довгих користувацьких кроків, що надходять -усередині короткого вікна повторної спроби, щоб шквали повторних спроб каналу не переносилися в -наступний активний транскрипт після Compaction. +Коли ввімкнено `agents.defaults.compaction.truncateAfterCompaction`, OpenClaw не перезаписує наявний транскрипт на місці. Він створює новий активний наступний транскрипт із підсумку Compaction, збереженого стану та непідсумованого хвоста, а потім залишає попередній JSONL як архівне джерело контрольної точки. +Наступні транскрипти також відкидають точні дублікати довгих користувацьких ходів, які надходять у межах короткого вікна повторної спроби, щоб сплески повторних спроб каналу не переносилися в наступний активний транскрипт після Compaction. -Контрольні точки перед Compaction зберігаються лише поки вони залишаються нижче за обмеження OpenClaw -на розмір контрольної точки; завеликі активні транскрипти все одно проходять Compaction, але OpenClaw -пропускає великий налагоджувальний знімок замість подвоєння використання диска. +Контрольні точки до Compaction зберігаються лише доки вони залишаються нижче обмеження OpenClaw на розмір контрольної точки; завеликі активні транскрипти все одно проходять Compaction, але OpenClaw пропускає великий знімок для налагодження замість подвоєння використання диска. -### Сповіщення Compaction +### Сповіщення про Compaction -За замовчуванням Compaction виконується без повідомлень. Установіть `notifyUser`, щоб показувати короткі статусні повідомлення, коли Compaction починається й завершується: +За замовчуванням Compaction виконується тихо. Установіть `notifyUser`, щоб показувати короткі повідомлення про стан, коли Compaction починається й завершується: ```json5 { @@ -139,7 +135,7 @@ x-i18n: ### Скидання пам’яті -Перед Compaction OpenClaw може виконати **тихий крок скидання пам’яті**, щоб зберегти довготривалі нотатки на диск. Установіть `agents.defaults.compaction.memoryFlush.model`, коли цей службовий крок має використовувати локальну модель замість активної моделі розмови: +Перед Compaction OpenClaw може виконати **тихий хід скидання пам’яті**, щоб зберегти довговічні нотатки на диск. Установіть `agents.defaults.compaction.memoryFlush.model`, коли цей службовий хід має використовувати локальну модель замість активної моделі розмови: ```json { @@ -155,13 +151,13 @@ x-i18n: } ``` -Перевизначення моделі скидання пам’яті є точним і не успадковує ланцюжок резервних варіантів активної сесії. Докладніше про це й конфігурацію див. у [пам’яті](/uk/concepts/memory). +Перевизначення моделі скидання пам’яті є точним і не успадковує резервний ланцюжок активного сеансу. Докладніше та конфігурацію див. у [Пам’яті](/uk/concepts/memory). -## Підключні провайдери Compaction +## Підключувані провайдери Compaction -Plugins можуть зареєструвати власного провайдера Compaction через `registerCompactionProvider()` в API Plugin. Коли провайдера зареєстровано й налаштовано, OpenClaw делегує узагальнення йому замість вбудованого конвеєра LLM. +Плагіни можуть реєструвати власного провайдера Compaction через `registerCompactionProvider()` в API плагіна. Коли провайдера зареєстровано й налаштовано, OpenClaw делегує підсумовування йому замість вбудованого LLM-конвеєра. -Щоб використати зареєстрованого провайдера, задайте його ідентифікатор у вашій конфігурації: +Щоб використати зареєстрованого провайдера, задайте його id у своїй конфігурації: ```json { @@ -175,35 +171,35 @@ Plugins можуть зареєструвати власного провайд } ``` -Установлення `provider` автоматично примусово задає `mode: "safeguard"`. Провайдери отримують ті самі інструкції Compaction і політику збереження ідентифікаторів, що й вбудований шлях, а OpenClaw усе одно зберігає контекст нещодавніх кроків і суфікс контексту розділених кроків після виводу провайдера. +Установлення `provider` автоматично примусово вмикає `mode: "safeguard"`. Провайдери отримують ті самі інструкції Compaction і політику збереження ідентифікаторів, що й вбудований шлях, а OpenClaw усе ще зберігає контекст суфікса нещодавніх ходів і розбитих ходів після виводу провайдера. -Якщо провайдер зазнає помилки або повертає порожній результат, OpenClaw повертається до вбудованого узагальнення LLM. +Якщо провайдер зазнає невдачі або повертає порожній результат, OpenClaw повертається до вбудованого підсумовування LLM. -## Compaction проти обрізання +## Compaction і обрізання -| | Compaction | Обрізання | -| ---------------- | ------------------------------ | ---------------------------------- | -| **Що робить** | Узагальнює старішу розмову | Обрізає старі результати інструментів | -| **Збережено?** | Так (у транскрипті сесії) | Ні (лише в пам’яті, для кожного запиту) | -| **Область** | Уся розмова | Лише результати інструментів | +| | Compaction | Обрізання | +| ---------------- | ----------------------------- | -------------------------------- | +| **Що робить** | Підсумовує старішу розмову | Обрізає старі результати інструментів | +| **Збережено?** | Так (у транскрипті сеансу) | Ні (лише в пам’яті, для кожного запиту) | +| **Область** | Уся розмова | Лише результати інструментів | -[Обрізання сесії](/uk/concepts/session-pruning) — це легший доповнювальний механізм, який обрізає вивід інструментів без узагальнення. +[Обрізання сеансу](/uk/concepts/session-pruning) — це легше доповнення, яке обрізає вивід інструментів без підсумовування. ## Усунення несправностей -**Compaction відбувається занадто часто?** Контекстне вікно моделі може бути малим, або виводи інструментів можуть бути великими. Спробуйте ввімкнути [обрізання сесії](/uk/concepts/session-pruning). +**Compaction відбувається занадто часто?** Вікно контексту моделі може бути малим, або виводи інструментів можуть бути великими. Спробуйте ввімкнути [обрізання сеансу](/uk/concepts/session-pruning). **Після Compaction контекст здається застарілим?** Використайте `/compact Focus on `, щоб спрямувати підсумок, або ввімкніть [скидання пам’яті](/uk/concepts/memory), щоб нотатки зберігалися. -**Потрібен чистий аркуш?** `/new` починає нову сесію без Compaction. +**Потрібен чистий аркуш?** `/new` запускає новий сеанс без Compaction. -Для розширеної конфігурації (резервні токени, збереження ідентифікаторів, власні рушії контексту, серверний 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): hooks життєвого циклу Compaction (`before_compaction`, `after_compaction`). +- [Сеанс](/uk/concepts/session): керування сеансом і життєвий цикл. +- [Обрізання сеансу](/uk/concepts/session-pruning): обрізання результатів інструментів. +- [Контекст](/uk/concepts/context): як контекст будується для ходів агента. +- [Хуки](/uk/automation/hooks): хуки життєвого циклу Compaction (`before_compaction`, `after_compaction`).