Что такое шаблон запроса

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

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

Каждый шаблон запроса состоит из двух видов частей:

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

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

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

Вот шаблон описания продукта с чётко отмеченными переменными частями:

«Напишите описание продукта для {{product_name}} — продукта категории {{product_category}}, предназначенного для {{target_audience}}. Тон должен быть {{tone}}. Длина: {{word_count}} слов. Сделайте акцент на {{key_benefit}}. Не упоминайте цену. Используйте действительный залог. Не используйте маркированные списки.»

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

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

• Действительный залог — потому что Вы выяснили, что результаты в страдательном залоге были слабее
• Без упоминания цены — потому что юридический отдел проверил и одобрил только текст, посвящённый функциям
• Без маркированных списков — потому что руководство по стилю бренда требует связного текста

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

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

• Переменные сущностей — имена, названия продуктов, названия компаний ({{product_name}})
• Переменные аудитории — для кого предназначено содержание ({{target_audience}})
• Переменные стиля — тон, манера речи, уровень сложности текста ({{tone}}, {{reading_level}})
• Переменные содержания — тема, предметная область, ключевые пункты ({{topic}}, {{key_points}})
• Переменные формата — длина, предпочтения по структуре ({{word_count}}, {{format}})

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

Не каждому запросу полезен шаблон. Шаблоны особенно ценны, когда:

• Вы регулярно создаёте один и тот же тип содержания (еженедельные отчёты, описания продуктов, ответы службы поддержки)
• Нескольким членам команды нужно создавать единообразные результаты
• Качество должно оставаться стабильным для множества экземпляров одной и той же задачи
• Задача имеет чёткие, стабильные параметры переменных

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

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

Наиболее понятные шаблоны визуально отделяют неизменяемые инструкции от полей для подстановки. Распространённые соглашения:

• Двойные фигурные скобки для переменных: {{variable}}
• Заглавные буквы для переменных: PRODUCT_NAME
• Теги в стиле XML: <product_name>...</product_name>
• Отдельный раздел «Переменные» в конце шаблона

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

Перед формированием результата по шаблону убедитесь, что все обязательные переменные указаны и имеют допустимые значения. Отсутствующие переменные приводят к неработающим запросам — модель может буквально включить в результат текст заполнителя «{{product_name}}».

Для необязательных переменных с разумными значениями по умолчанию задайте резервные значения:

• Тон: {{tone | default: 'профессиональный и дружелюбный'}}
• Количество слов: {{word_count | default: 200}}

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

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

Простые методы версионирования:

• Называйте файлы шаблонов с указанием номера версии: product_description_v3.txt
• Добавляйте вверху блок комментариев: автор, дата создания, дата последнего изменения, примечания к изменениям
• Сохраняйте старые версии — не перезаписывайте их, а для новых файлов используйте create
• Помечайте тегами основные версии, отправленные в рабочую среду

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

Хорошо документированный шаблон включает:

• Назначение: какой тип результата создаёт этот шаблон?
• Обязательные переменные: что нужно предоставить? Какие значения допустимы?
• Необязательные переменные: для каких переменных заданы значения по умолчанию?
• Пример: образец заполненного запроса и его результата
• Примечания: известные ограничения, особенности или сценарии сбоев

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

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

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

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