Шаблоны промптов

Шаблоны промптов — это переиспользуемые тексты с переменными, которые вы (или любой участник аккаунта) заполняете перед запуском. В шаблонах используется синтаксис Liquid: {{ variable }}, {% if %}, {% for %}.

Шаблоны бывают трёх уровней:

• Глобальные — созданы администраторами платформы, доступны всем аккаунтам.
• Аккаунта — созданы участниками вашего аккаунта, видны всем коллегам.
• Личные — видны только создателю.

Управление шаблонами доступно в разделе Шаблоны промптов.

Шаблоны категории «Аккаунта» — это общие ресурсы для всего аккаунта: их видят все участники в списке шаблонов и могут использовать при запуске. Редактировать и удалять такие шаблоны могут владелец и администраторы аккаунта.

Личные шаблоны по-прежнему видны только создателю; глобальные — доступны по правилам платформы.

1. Откройте раздел Шаблоны промптов и нажмите «Новый шаблон».
2. Заполните ключ, название, короткое описание.
3. В поле «Тело шаблона (Liquid)» напишите промпт. Используйте переменные в двойных фигурных скобках: {{ company_name }}, {{ topic }}.
4. Справа от поля — панель «Переменные аккаунта». Клик по имени вставит {{ key }} в курсор.
5. Под полем — карточка «Найденные переменные», которая обновляется по мере ввода и показывает, как система классифицирует каждую переменную.
6. Выберите статус «Опубликован», когда шаблон готов к использованию.

Любая переменная вида {{ name }} в теле шаблона распознаётся системой. Пример:

Компания {{ company_name }} продаёт {{ product_name }}.
Сформулируй короткий питч для аудитории {{ audience }}.

Вопрос пользователя: {{ user_message }}

Система делит переменные на три категории в зависимости от того, откуда берётся значение:

• Переменные аккаунта (company_name, product_name и любые пользовательские ключи) — значения берутся автоматически, заполняются один раз на аккаунт.
• Пользовательские переменные (audience, topic) — их заполняет сам пользователь при запуске шаблона.
• Переменные платформы (user_message) — заполняются автоматически самой платформой. Например, в шаблонных чатах в user_message подставляется текст сообщения.

В списке шаблонов и на карточке шаблона переменные отображаются цветными значками:

Переменные аккаунта — это пары «ключ → значение», которые автоматически подставляются во все Liquid-шаблоны аккаунта. Их достаточно задать один раз.

По умолчанию доступны стандартные ключи: company_name, company_description, product_name, product_description. Вы можете добавить свои (например, brand_color или support_email).

На странице переменных аккаунта для каждого ключа отображается список шаблонов, в которых он используется. Если шаблон ссылается на ключ, который ещё не заполнен, вы увидите предупреждение со ссылкой «Заполнить».

Опубликованный шаблон чата можно запустить из раздела шаблонные чаты или кнопкой «Использовать в чате» на карточке шаблона. Форма автоматически запрашивает только те переменные, которые должен заполнить пользователь — значения из переменных аккаунта и платформы подставляются без участия пользователя.

Шаблоны также используются в инструкциях ботов и агентов — подробнее см. документацию об агентах.