# Версії та чернетки

Фіксуйте агента перед зміною, експериментуйте в чернетці, відкочуйтеся в один клік

> Full REST + WebSocket API reference: https://api.happ.tools/reference

**Версія** — знімок агента: промпт, налаштування, модель, інструменти, база знань і аудитор, — до якого можна повернутися. **Чернетка** — прихована копія агента для експериментів: перевірте її, потім опублікуйте в основну версію.

Обидві — на панелі **Versions** у верхній панелі агента; **Open full history** показує всі версії з різницею змін.

<VersionsPageDemo />

## Версії [#версії]

**Зберегти** лише тримає поточний стан агента в роботі — версію воно не створює. Щоб зафіксувати точку, до якої можна відкотитися:

1. **Versions** > **Create version**. Кнопка показує незафіксовану зміну (`+N −M`) і неактивна, якщо з останньої версії нічого не змінилося.
2. Опишіть, **що змінилося** — наприклад, «Переписав розділ промпту про доставку» — і створіть версію.

Happ також фіксує версії сам: при створенні агента чи чернетки, перед відкатом чи публікацією (**auto-save**) і коли AI-агент редагує його через [MCP-сервер](/docs/settings/mcp) (**AI edit**).

### Історія [#історія]

**Open full history** показує останні 50 версій з їхнім походженням — **saved**, **auto-save**, **rollback**, **published**, **AI edit** — автором і нотаткою. Оберіть версію, щоб побачити різницю з попередньою, згруповану за розділами: промпт, налаштування, модель і провайдер, інструменти, база знань, аудитор. **Call this version** робить тестовий дзвінок на голосі цієї версії, не чіпаючи живого агента.

### Відкат [#відкат]

**Restore** на версії замінює нею конфігурацію агента. Поточний стан спершу автозберігається, а відкат додається зверху як нова версія **rollback** — історія рухається лише вперед, нічого не губиться. Голосовий агент пересинхронізується, а змінені документи бази знань переіндексуються самі.

## Чернетки [#чернетки]

Чернетка працює в плейграунді й у [тестах](/docs/agents/tests), але **не підключена до каналів і телефонів** — клієнти до неї не потрапляють.

1. **Versions** > меню гілок > **New draft from here**, дайте назву (за замовчуванням «Dev»).
2. Редагуйте чернетку на тих самих екранах, що й агента. Голосові налаштування в чернетці лише для читання; текстову модель змінювати можна.
3. Перевірте: **Тест** у верхній панелі або **Тест** > **Run on** > чернетка.
4. **Make this draft live** показує різницю з основною версією і публікує: промпт, налаштування, інструменти й аудитор чернетки перезаписують основну версію, фіксується версія **published**, а чернетка видаляється.

Щоб почати чернетку зі старішої версії, відкрийте її в історії і оберіть &#x2A;*⋯** > **Draft from here**.

Обмеження: до **3 чернеток** на агента, чернетка з чернетки неможлива. База знань спільна з основною версією і в чернетці лише для читання. Інструменти, що створюють замовлення чи ліди у вашій CRM, у чернетку не копіюються — експерименти не створять реальних записів. Якщо основна версія змінилася після створення чернетки, публікація попередить: ці зміни буде перезаписано.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Далі [#далі]

* [Тест](/docs/agents/tests) — доведіть, що чернетка краща, перш ніж публікувати
* [Агенти](/docs/agents) — що є в налаштуваннях агента
* [MCP](/docs/settings/mcp) — дайте Claude чи Cursor редагувати агента, кожна правка — у версіях