Налаштувати промпт агента

Інструкції агента визначають, як AI-асистент формує відповіді: роль, стиль, правила ескалації та формат виводу. У Fast Line Pro їх редагують у блоці Інструкції на картці агента — з вибором режиму редактора під простий або структурований промпт.

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

Потрібно налаштувати стиль відповідей агента (формальний, неформальний, технічний).
Хочете описати роль, правила поведінки та ескалацію для клієнтів.
Треба додати JSON-схему виводу, XML-секції або інструменти в промпт.
Бажаєте персоналізувати відповіді через змінні у форматі {{назва_змінної}}.

Що важливо знати

Інструкції агента — системний промпт, який задає поведінку AI-асистента.
Редактор підтримує три режими: Візуальний, Сирий і Monaco.
Для промптів із XML-тегами, JSON-блоками або схемами виводу оберіть Monaco або Сирий — режим Візуальний для таких текстів недоступний, бо візуальний редактор може пошкодити розмітку при збереженні.
Зміни застосовуються до діалогів лише після Опублікувати на картці агента.

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

Ви увійшли в систему з правами інтегратора.
Ви відкрили модуль Fast Line Pro через Меню → Fast Line Pro.
У системі є агент, інструкції якого потрібно налаштувати.

Режими редактора інструкцій

У заголовку блоку Інструкції перемикач режимів:

Режим	Коли використовувати
Візуальний	Простий промпт зі заголовками, списками та виділенням — без XML-тегів і JSON-блоків. Редагування Markdown у візуальному режимі.
Сирий	Той самий текст, що й у візуальному режимі, але у звичайному текстовому полі з моноширинним шрифтом. Зручно для точного копіювання або правок без підсвітки.
Monaco	Структуровані промпти: XML-секції (`<role>`, `<tools>`), блоки ```json , таблиці Markdown, змінні `{{name}}`. Підсвітка синтаксису та зручна робота з великим текстом.

Автовибір режиму

Якщо в промпті є:

XML-теги (наприклад, <role>),
блоки коду ```json або ```xml ,
«сирий» JSON-об'єкт,

система вимикає Візуальний і відкриває Monaco. Перейти на Сирий можна в будь-який момент вручну.

Рекомендований формат промпту

Для складних агентів (інструменти, роутери, контракти відповіді) поєднуйте Markdown + XML + JSON:

Елемент	Призначення	Приклад
Заголовки Markdown	Структура розділів	`# Роль`, `## Правила`
Списки і жирний	Правила, обмеження	`- Не вигадуйте факти`
Таблиці Markdown	Параметри, порівняння	`\| Канал \| SLA \|`
XML-секції	Логічні блоки промпту	`<role>`, `<primary_objective>`, `<tools>`, `<escalation_policy>`, `<language_rules>`
Блоки ```json	Схема виводу, роутинг	поля відповіді в JSON
Змінні	Дані зі сценарію	`{{client_name}}`, `{{company_name}}`

Змінні в інструкціях — лише у форматі {{назва_змінної}} (подвійні фігурні дужки). Назви мають збігатися зі змінними агента та параметрами дії в сценарії. Детальніше: Налаштувати змінні агента.

Короткий приклад структури

# Консультант підтримки

<role>
Ви — AI-асистент служби підтримки {{company_name}}.
</role>

<primary_objective>
Відповідайте з бази знань. Якщо відповіді немає — ескалуйте оператору.
</primary_objective>

<language_rules>
- Мова: українська
- Тон: дружній, професійний
</language_rules>

```json
{
  "reply": "string",
  "needs_escalation": "boolean"
}
```

Для простих FAQ достатньо режиму Візуальний без XML і JSON.

Покрокова інструкція

У Fast Line Pro відкрийте вкладку Агенти і натисніть назву потрібного агента.
Знайдіть блок Інструкції.
Оберіть режим редактора:
- простий текст → Візуальний або Сирий;
- XML, JSON, таблиці, довгий структурований промпт → Monaco (або дочекайтеся автовідкриття Monaco, якщо в тексті вже є структура).
Введіть або відредагуйте інструкції. За потреби додайте змінні у форматі {{назва_змінної}}.
Якщо у вашій системі увімкнено AI-помічник — натисніть Запитати AI у заголовку блоку. Відкриється помічник із підказкою про Markdown, JSON/XML і режим Monaco.
Перевірте текст у обраному режимі (для структурованих промптів — у Monaco або Сирий).
Натисніть Опублікувати у верхній частині картки агента — інструкції збережено і застосовано до наступних діалогів.

Monaco: що побачите в інтерфейсі

Підсвітка заголовків, XML-тегів, inline-коду, блоків ```json / ```xml , жирного тексту та таблиць.
Код і таблиці — моноширинним шрифтом; inline-код виділено кольором без рожевого фону.
Поле редактора зростає разом із текстом до максимальної висоти, далі прокручується всередині; сторінка прокручується для блоків нижче.

Що відбувається після

Інструкції збережено на картці агента. Після Опублікувати агент використовує новий промпт у діалогах. До публікації у зверненнях залишається попередня версія.

Як переконатися, що все вдалось

Текст інструкцій відображається коректно в обраному режимі (особливо XML і JSON у Monaco).
Після Опублікувати на картці немає незбережених змін.
Тестовий діалог у сценарії відповідає правилам промпту (тон, ескалація, формат).