---
title: "Як працювати з турами інстансу"
description: "Список турів, YAML-редактор, імпорт і експорт, вставка в документ бази знань і запуск покрокового супроводу."
---

# Як працювати з турами інстансу?

Коли в **Constructor** увімкнено **«Базу знань»**, розділ **«Тури інстансу»** дозволяє створювати покрокові сценарії в інтерфейсі, зберігати їх на інстансі та **запускати з документів** або за прямим посиланням.

## Коли знадобиться

- Потрібно провести колегу по новому процесу в інтерфейсі без довгого текстового опису.
- Треба **оновити** кроки туру після зміни меню або налаштувань на інстансі.
- У внутрішній інструкції в **«Базі знань»** хочете додати кнопку **«Запустити тур»** поруч із текстом.

## Перед початком

- У меню має бути **«База знань»**; зі списку документів натисніть **«Тури»**.
- **Створювати та редагувати** тури можуть користувачі з правом **«Керувати UI-турами інстансу»** у **Налаштування → Ролі** або root; окремий тур можна довірити **ролям редагування** в його налаштуваннях.
- Нові тури за замовчуванням **не публічні** — оберіть ролі читання, якщо тур мають бачити інші користувачі.
- Якщо **«Бази знань»** немає в меню, **адміністратор** має увімкнути **Instance Docs** у **Налаштування → Налаштування інстансу** (блок перемикачів функцій). Детальніше: [налаштування інстансу](../../settings/how-to/configure-instance.md).

## Відкрити список турів

1. Відкрийте **«Базу знань»**.
2. Натисніть **«Тури»** у верхній панелі — відкриється **«Тури інстансу»**.
3. Скористайтеся **пошуком**, фільтром **статусу** (чернетка / готовий) або **архіву** (активні / в архіві / усі).

## Створити або змінити тур

1. Натисніть **«Новий тур»** (якщо кнопка доступна вашій ролі).
2. Заповніть **Tour ID** (латиниця, унікальний ідентифікатор) і назву.
3. У полі **YAML** опишіть кроки, маршрути в інтерфейсі та елементи, на які вказує кожен крок — за тим самим форматом, що й у продуктових турах платформи.
4. Натисніть **«Перевірити YAML»** — система покаже помилки або кількість кроків.
5. Натисніть **«Зберегти»**. Статус **«Готовий»** дозволяє запуск; **«Чернетка»** — тур не запускається з картки.

**Імпорт:** кнопка **«Імпорт YAML»** — оберіть файл `.yaml` / `.tour.yaml`.  
**Експорт:** у рядку туру — **«Експорт YAML»** для резервної копії або переносу між інстансами (за політикою вашої організації).

## Архівувати тур

У меню дій туру оберіть **«Архівувати»** — він зникне зі списку активних, але залишиться в фільтрі **«В архіві»**. **«Відновити з архіву»** повертає тур у робочий список.

## Вставити тур у документ бази знань

1. Відкрийте **редагування** документа в **«Базі знань»**.
2. У панелі редактора натисніть **«Вставити тур»**.
3. Оберіть тур зі списку — у текст додасться посилання виду `[[tour:your-tour-id|Підпис кнопки]]`.
4. Збережіть документ. У **перегляді** з’явиться картка з кнопкою **«Запустити тур»**.

Якщо тур **не знайдено**, **чернетка** або **немає доступу** — на картці буде відповідний статус замість активної кнопки.

## Запустити тур

- **З документа** — натисніть **«Запустити тур»** на картці в статті.
- **Зі списку турів** — відкрийте рядок або кнопку **«Відкрити тур»** (для готових турів з увімкненим посиланням).

Відкриється покроковий супровід у **Constructor** (той самий механізм, що й тури **AI Помічника** за посиланням).

## Пов’язані матеріали

- [Що таке тури інстансу](../explanation/what-is-instance-tours.md)
- [Як працювати з базою знань інстансу](./use-instance-knowledge-base.md)
- [Як користуватися AI Помічником](./use-ai-assistant.md)
- [Налаштування інстансу](../../settings/how-to/configure-instance.md)