Перейти к основному содержимому

Системные промпты

Системный промпт — это главная инструкция, определяющая поведение агента. Платформа поддерживает гибкую систему шаблонов с переменными, версионированием и предпросмотром собранного промпта.

Инструкции агента​

Основной текст инструкций вводится на странице редактирования агента в секции Инструкции. Это поле содержит базовый промпт, который определяет характер, задачи и ограничения агента.

Пример простого промпта:

Ты — полезный ассистент компании "Рога и Копыта".
Отвечай на вопросы клиентов вежливо и по существу.
Если не знаешь ответа — предложи связаться с менеджером.
Совет

Для редактирования длинных промптов нажмите кнопку раскрытия в правом верхнем углу секции «Инструкции». Откроется модальное окно с полноэкранным редактором.

Подстановка переменных​

В тексте промпта можно использовать переменные в формате {{имя_переменной}}. Переменные подставляются автоматически при выполнении агента.

Доступные системные переменные​

Платформа автоматически предоставляет следующие переменные, связанные с текущим временем:

ПеременнаяОписаниеПример
{{current_date}}Текущая дата2026-03-20
{{current_time}}Текущее время14:30:00
{{current_day}}День неделиЧетверг
{{current_timezone}}Часовой поясEurope/Moscow
{{current_datetime}}Полная дата и время2026-03-20T14:30:00
{{tomorrow}}Завтрашняя дата2026-03-21
{{yesterday}}Вчерашняя дата2026-03-19
{{day_after_tomorrow}}Послезавтрашняя дата2026-03-22

Пользовательские переменные​

Вы можете определять собственные переменные, которые передаются через API или через панель «Переменные» в тестовом чате:

Ты — ассистент для пользователя {{user_name}}.
Текущий город: {{city}}.
Предпочтительный язык: {{language}}.

Для тестирования переменных в чате:

  1. Раскройте панель Переменные над полем ввода.
  2. Нажмите Добавить.
  3. Укажите ключ (например, user_name) и значение (например, Иван).
Примечание

Если переменная не определена, она сохраняется в тексте как есть — {{undefined_var}} не вызовет ошибку, а просто останется в промпте.

Страница «Системный промпт»​

Для более глубокого управления промптом перейдите на страницу Системный промпт (кнопка в заголовке страницы редактирования агента). Здесь вы увидите полную картину того, как собирается финальный промпт.

Сводная панель​

В верхней части страницы отображается сводная информация:

ПоказательОписание
ТокеныОбщее количество токенов в собранном промпте
СекцииКоличество секций, из которых собирается промпт
ИнструментыКоличество подключённых инструментов
КоллегиКоличество агентов-коллег

Кнопка Полный промпт открывает модальное окно с финальным текстом промпта, который будет отправлен в LLM.

Секции промпта​

Промпт агента собирается из нескольких секций. Каждая секция имеет:

  • Имя — идентификатор секции.
  • Источник — откуда секция берёт содержимое (шаблон, система, конфигурация агента).
  • Размер — количество токенов.

Секции отображаются как карточки, показывающие структуру финального промпта.

Автоматические секции​

Помимо пользовательских инструкций, платформа автоматически добавляет в промпт следующие секции:

  • Контекст времени — текущие дата, время, день недели и ближайшие даты.
  • Области памяти — информация о доступных областях памяти (если память включена).
  • Стратегия использования инструментов — инструкции по работе с памятью (если инструменты памяти подключены).
  • Каталог коллег — список агентов-коллег с их ID и описаниями (для мульти-агентной архитектуры).
  • Контекст передачи — информация от предыдущего агента при handoff (при делегировании).

Шаблоны​

Шаблоны — это редактируемые блоки текста, из которых собирается системный промпт. На странице «Системный промпт» они отображаются в секции Шаблоны.

Редактирование шаблона​

  1. Нажмите кнопку редактирования (иконка карандаша) на карточке шаблона.
  2. Отредактируйте текст в текстовом поле.
  3. Изменения отображаются в виде diff (сравнение с текущей версией).
  4. Нажмите Сохранить для применения изменений.

Шаблоны поддерживают синтаксис Jinja2 для условных конструкций и циклов:

{% if scopes.user %}
- user: Personal memory across all conversations
{% endif %}

{% for c in colleagues %}
- {{ c.name }}: {{ c.description }}
{% endfor %}

Предпросмотр​

Каждый шаблон имеет кнопку предпросмотра (иконка глаза), которая показывает результат рендеринга шаблона с текущими данными агента.

Версионирование​

Платформа автоматически сохраняет историю версий каждого шаблона.

Просмотр истории​

  1. Нажмите кнопку истории (иконка часов) на карточке шаблона.
  2. В модальном окне отображается список версий с датами изменений.
  3. Выберите версию для просмотра diff (сравнение с текущей версией).

Откат к предыдущей версии​

  1. Откройте историю версий.
  2. Выберите нужную версию.
  3. Нажмите Откатить к v{N}.
Внимание

Откат создаёт новую версию с содержимым выбранной старой версии. История не удаляется.

Рекомендации по написанию промптов​

Структура​

Хорошо структурированный промпт обычно содержит:

  1. Роль и контекст — кто агент и в каком контексте работает.
  2. Задачи — что агент должен делать.
  3. Ограничения — чего агент делать не должен.
  4. Формат ответа — как агент должен отвечать.
  5. Примеры — образцы желаемого поведения.

Пример промпта​

Ты — менеджер по продажам компании "TechStore".

## Твои задачи:
- Помогать клиентам выбрать подходящий товар
- Отвечать на вопросы о характеристиках товаров
- Оформлять заказы через соответствующие инструменты

## Правила:
- Всегда будь вежлив и профессионален
- Не обсуждай конкурентов
- Если товар отсутствует, предложи альтернативу
- Используй базу знаний для поиска информации о товарах

## Формат ответа:
- Отвечай кратко и по существу
- Используй списки для перечисления характеристик
- В конце каждого ответа спрашивай, нужна ли ещё помощь
Совет

Используйте markdown-разметку в промптах — заголовки, списки и выделение помогают LLM лучше структурировать понимание инструкций. Подробнее о выборе моделей: Выбор LLM-модели.