Промпты и библиотека сценариев в SenDev: AI Core

Страница «Промпты» предназначена для централизованного управления шаблонами AI-запросов. Вместо того чтобы хранить длинные инструкции внутри каждого функционального модуля, AI Core позволяет создать сценарий один раз и затем использовать его из разных частей сайта.

Для пользователя это означает, что формулировку задачи можно улучшать и дополнять в одном месте без изменения интерфейса подключённого модуля.

[Скриншот 1: библиотека промптов в режиме плитки или списка]

Что такое промпт в AI Core

Промпт — это шаблон инструкции для AI. В нём могут находиться постоянный текст и переменные, которые подставляются непосредственно перед запросом.

Например, один и тот же сценарий может использовать название товара, исходный текст, целевую аудиторию или другие данные, полученные из функционального модуля.

AI Core связывает шаблон со стабильным сценарием. Именно сценарий является основным ориентиром для интеграции. Текст промпта можно менять, сохраняя тот же сценарий.

Стандартная библиотека

После установки модуль создаёт стартовый набор промптов для типовых задач. В библиотеке есть сценарии для работы с текстом и отдельные сценарии генерации изображений.

Для изображений в стандартной поставке предусмотрены, в частности:

• image.article_illustration — иллюстрация для статьи;
• image.product_hero — основное изображение товара или предложения;
• image.social_cover — обложка для публикации или социальных сетей.

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

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

Команда «Проверить и добавить отсутствующие промпты» сравнивает текущую библиотеку с набором, поставляемым вместе с модулем, и добавляет недостающие записи.

Это полезно после обновления AI Core или случайного удаления стандартного шаблона.

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

Фильтры библиотеки

Когда промптов становится много, используйте фильтры в верхней части страницы.

Раздел

Позволяет отобрать шаблоны по тематике. В поставке предусмотрены категории:

• Все;
• Учёба;
• Работа с текстом;
• Маркетинг;
• IT и разработка;
• Данные;
• Идеи;
• Документы;
• Креатив и искусство;
• Бизнес и финансы;
• Переводы и языки;
• SEO и контент;
• Путешествия.

Категория нужна прежде всего для удобства администратора и не меняет способ выполнения самого AI-запроса.

Поиск

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

Вид «Плитка» и «Список»

Плитка удобна для просмотра библиотеки по смыслу и кратким описаниям. Список лучше подходит для административной работы, когда нужно быстро сравнить коды, версии, сценарии, активность и другие параметры.

Показать и Сбросить

Кнопка «Показать» применяет выбранные условия. «Сбросить» возвращает полный список.

Что видно у промпта

В зависимости от выбранного представления отображаются:

• категория;
• ID;
• версия;
• название;
• сценарий;
• краткий фрагмент шаблона;
• признак стандартного варианта;
• активность;
• действия редактирования и удаления.

Создание и редактирование промпта

[Скриншот 2: форма редактирования промпта с переменными в шаблоне]

Раздел

Выберите тематическую категорию, в которой пользователю будет проще найти шаблон. Если промпт относится к конкретной задаче рабочего модуля, выбирайте ближайший по смыслу раздел.

Код

Служит уникальным обозначением конкретной записи промпта. Используйте понятный и стабильный код.

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

Сценарий

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

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

Для графических сценариев используется префикс image.. Это помогает отделять задачи генерации изображений от текстовых.

Название

Отображаемое название для администратора. Оно должно объяснять назначение шаблона без необходимости открывать его содержимое.

Версия

Версия помогает контролировать значимые изменения шаблона. Для небольшой корректировки формулировки достаточно сохранить существующую запись. Если меняется логика задачи, структура результата или требования к входным данным, лучше увеличить версию.

Версионирование особенно полезно, когда один сценарий применяется в рабочем процессе и важно понимать, какая редакция промпта использовалась ранее.

По умолчанию

Признак указывает, что промпт является основным вариантом для своего сценария/набора. Если существует несколько редакций, значение по умолчанию помогает AI Core выбрать нужную.

Не следует без необходимости отмечать несколько конкурирующих записей как основные.

Активен

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

Шаблон

Основной текст инструкции, который получит AI. Пишите его так, чтобы задача была однозначной: укажите роль, требуемое действие, ограничения и желаемый формат результата, если это важно.

Не стоит добавлять в каждый промпт повторяющиеся сведения о конкретном провайдере. AI Core отделяет задачу от подключения, поэтому один шаблон может работать с разными совместимыми моделями.

Переменные в шаблоне

Переменные записываются в двойных фигурных скобках, например:

• {{TEXT}} — исходный текст;
• {{PRODUCT_NAME}} — название товара;
• {{AUDIENCE}} — целевая аудитория.

Фактический набор переменных не ограничен этими примерами. AI Core определяет переменные из шаблона и может показать для них поля в «Песочнице».

При создании собственного шаблона используйте понятные имена переменных. Тогда администратору будет проще понять, какие данные необходимо передать.

Как писать удобный промпт

Для стабильной работы используйте следующую структуру:

1. Сначала задача. Коротко укажите, что необходимо сделать.
2. Затем исходные данные. Разместите переменные в понятном контексте.
3. После этого ограничения. Например, объём, тональность, запрет на выдуманные факты.
4. В конце формат результата. Если нужен список, краткий текст, JSON или определённая структура, укажите это явно.

Чем точнее шаблон, тем меньше зависимость результата от случайной интерпретации модели.

Промпты для изображений

Для графического сценария шаблон должен описывать не только предмет изображения, но и его назначение. Например, иллюстрация статьи и товарный hero-баннер требуют разной композиции.

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

История изменений

В версии 1.1.0 AI Core сохраняет служебные ревизии промптов при значимых административных операциях. Это снижает риск потери предыдущего содержимого при редактировании.

История не заменяет осознанное версионирование. Если новая редакция должна существовать параллельно со старой и использоваться отдельно, создайте отдельную версию, а не рассчитывайте только на техническую историю изменений.

Удаление промпта

Перед удалением проверьте, не используется ли сценарий в другом модуле. Сам факт, что промпт давно не редактировался, не означает, что он не вызывается.

Если шаблон временно не нужен, безопаснее сначала отключить его. Удаление используйте для действительно ненужных записей.

Если удалён стандартный промпт, его можно вернуть командой проверки стандартной библиотеки.

Проверка промпта в «Песочнице»

После создания или изменения шаблона рекомендуется сразу проверить его:

1. Откройте «Песочницу».
2. Выберите режим — текст или изображение.
3. Выберите активного провайдера.
4. Выберите нужный сценарий.
5. Заполните появившиеся переменные.
6. Проверьте предварительно собранный промпт.
7. Выполните запрос.
8. Оцените результат и при необходимости вернитесь к редактированию шаблона.

Так можно улучшать промпт без ожидания, пока его вызовет другой модуль.

Если сценарий не появляется в «Песочнице»

Проверьте:

• промпт активен;
• его сценарий соответствует выбранному режиму;
• для изображений используется корректный графический сценарий;
• есть активный совместимый провайдер;
• фильтры библиотеки не создают ошибочного впечатления, что запись отсутствует.

Рекомендуемый порядок работы с библиотекой

1. Не удаляйте стандартные промпты сразу после установки.
2. Найдите ближайший по задаче готовый сценарий.
3. Если задача отличается существенно — создайте отдельный промпт со своим кодом и сценарием.
4. Используйте переменные вместо копирования шаблона для каждого объекта.
5. После изменения тестируйте результат в «Песочнице».
6. Для серьёзных изменений увеличивайте версию.
7. Периодически проверяйте недостающие стандартные промпты после обновления AI Core.

[Скриншот 3: пример выбора промпта в «Песочнице» и подставленных переменных]

Итог

Библиотека промптов отделяет бизнес-задачу от конкретного AI-сервиса. Главное правило — сохранять стабильный сценарий, использовать понятные переменные и проверять каждое значимое изменение через «Песочницу». Это позволяет менять формулировки централизованно, не переписывая интеграцию в функциональных модулях.