Инженерия генеративного ИИ
Изучите, как регистрировать, версионировать, настраивать, утверждать, развертывать, отслеживать, откатывать и выводить из эксплуатации запросы, используемые в производственных системах AI.
16 терминов
Ресурсы и реестр
Prompt asset
Запрос и связанные с ним метаданные, переменные, примеры, конфигурация, тесты и информация о владельце.
Рассматривайте производственные запросы как управляемые активы приложения, а не как анонимный скопированный текст.
Ресурс включает шаблон, схему, владельца, привязку модели, набор тестов, уровень риска и примечания к выпуску.Ресурсы и реестр
Prompt registry or store
Централизованный каталог, в котором можно находить, версионировать, сравнивать и извлекать ресурсы запросов.
Используйте это для предотвращения разброса производственных запросов по исходным файлам, документам и личным заметкам.
Поиск в реестре по сценарию использования, владельцу, статусу, семейству моделей и среде.Ресурсы и реестр
Prompt ID
Стабильный идентификатор для запроса, используемого в разных версиях.
Используйте это в коде, телеметрии и процессах утверждения, где версии идентифицируют точный контент.
prompt_id: support.case_summaryЖизненный цикл версии
Prompt version
Идентифицируемая версия содержимого запроса и соответствующей конфигурации.
Используйте неизменяемые версии для воспроизводимых оценок, развертываний, инцидентов и откатов.
support.case_summary@17 с кратким описанием sha256:...Жизненный цикл версии
Draft and published version
Рабочая версия, которую можно изменять, в отличие от утвержденной неизменяемой версии, доступной для приложений.
Используйте черновики для итераций и публикуйте только после прохождения необходимых тестов и утверждений.
Черновик 18 остается доступным для редактирования; производственная версия продолжает ссылаться на опубликованную версию 17.Конфигурация
Prompt variable
Именованный заполнитель, заполняемый данными, специфичными для запроса, во время выполнения.
Определите типы, обязательные поля, экранирование, ограничения по длине и уровень доверия для каждой переменной.
Не размещайте секреты в переменных запроса, если это не требуется и не защищено утвержденным дизайном.
Summarize {{case_notes}} for {{audience}} using {{output_schema}}.Конфигурация
Prompt configuration
Модель, параметры вывода, определения инструментов, схема вывода и другие настройки, связанные с запросом.
Настройки версии, которые могут существенно изменить поведение вместе с текстом запроса.
Конфигурация: семейство моделей, температура, максимальный объем вывода, версия схемы, включенные инструменты, время ожидания.Конфигурация
Model binding
Объявленная модель или семейство моделей, относительно которых разрабатывается и тестируется версия запроса.
Используйте это для предотвращения несанкционированного изменения поведения модели при ее переносе.
Запрос v17 одобрен только для семейства моделей A версии 2026-05.Доставка
Environment promotion
Перемещение версии запроса, прошедшей проверку, через среды разработки, тестирования и производства.
Используйте ту же неизменяемую версию вместо ручного копирования текста между средами.
dev -> evaluation passed -> staging approval -> productionДоставка
Prompt deployment
Предоставление выбранной версии и конфигурации запроса для приложения или рабочего процесса.
Развертывайте с использованием идентификатора, с проверками работоспособности, возможностями мониторинга и документированным путем восстановления.
Разверните support.case_summary@17 для 10% трафика, на который она распространяется, затем отслеживайте метрики выпуска.Доставка
Prompt rollback
Возврат трафика к ранее одобренной версии запроса после обнаружения проблемы.
Подготовьте и отрепетируйте откат перед выпуском в производственную среду.
Если точность определения обязательных полей падает ниже порога, восстановите версию 16 без ее редактирования.Управление
Prompt change approval
Задокументированное решение об утверждении версии запроса для определенного использования и среды.
Требуется пропорциональное одобрение для действий, видимых извне, регулируемых, финансовых или связанных с безопасностью.
Записи об утверждении содержат информацию о рецензенте, области применения, доказательствах, ограничениях, версии и дате истечения срока действия.Управление
Prompt ownership
Назначьте ответственность за качество, доступ, проверку, инциденты, обновления и вывод из эксплуатации запроса.
Назначьте владельца службы и резервного сотрудника до использования запроса в производственной среде.
Владелец: Support Platform; рецензент: Compliance; следующий просмотр: 2026-10-01.Управление
Prompt audit log
Неизменяемая история изменений запросов, утверждений, развертываний, доступа и отката.
Используйте это для расследования инцидентов и демонстрации того, кто, когда и почему что изменил.
Записывайте ID актора, метку времени, запрос, версии до и после, действие, тикет и среду.Наблюдаемость
Prompt trace
Запись на уровне запроса, связывающая версию запроса, входные данные, конфигурацию модели, активность инструментов, вывод и сигналы оценки.
Используйте это для отладки и анализа производительности с соответствующим минимизацией и контролем доступа.
Отслеживание может содержать личные, конфиденциальные или защищенные авторским правом материалы; своевременно минимизируйте, удаляйте, ограничивайте и прекращайте их использование.
trace_id связывает запрос v17, скрытые входные данные, версию модели, задержку, использование токенов и результат проверки.Жизненный цикл версии
Prompt deprecation
Отметка версии запроса или ресурса как запланированной к выводу из эксплуатации и не рекомендуемой для нового использования.
Опубликуйте руководство по миграции, определите пользователей, установите срок и сохраните доказательства отката перед удалением.
Откажите от v12 1 августа, переведите всех пользователей на v17 и архивируйте запись оценки.| Запись | Почему это важно |
|---|---|
| ID запроса, неизменяемая версия и контрольная сумма содержимого | Определяет точный ресурс, используемый для оценки или запроса. |
| Модель, параметры, схемы, инструменты и контракт для переменных | Обеспечивает воспроизводимость поведения и определяет требования совместимости. |
| Владелец, утверждение, доказательство тестирования, среда и время выпуска. | Показывает авторитет, готовность и операционную ответственность. |
| Отслеживание политики, пороговых значений мониторинга и целевого объекта отката. | Поддерживает обнаружение, диагностику и восстановление после инцидентов. |
Система контроля версий полезна, но для производственной работы также необходимы метаданные, специфичные для запроса, доказательства оценки, утверждения, продвижение среды, отслеживание запросов, информация о владельцах, ссылки на устаревшие версии и откат. Это можно реализовать с помощью кода или предоставить через реестр запросов.
В минимальном объеме записывайте настройки и зависимости, которые могут изменить поведение, такие как версия модели, поддерживаемые параметры, схема вывода, определения инструментов и контракт переменных. Является ли использование одной и той же версии номером реализации – это вопрос реализации, но точная комбинация должна быть воспроизводимой.
Не храните ненужные личные данные, учетные данные, секреты, конфиденциальные исходные материалы или неограниченный контент, защищенный авторским правом. Применяйте ограничение цели, удаление, контроль доступа, ограничения хранения, удаление и юридические или договорные требования.
Официальное руководство по многократному использованию запросов, переменных, вариантов, тестированию, версиям и интеграции с приложениями.
Официальная документация API для создания и перечисления управляемых версий запросов.
Создайте роль, инструкции, примеры, ограничения, шаблон для повторного использования и контракт на вывод.
Генерируйте доказательства оценки перед утверждением и публикацией версии.
Отслеживайте качество системы, регрессии, оценку человеком, задержку и стоимость после развертывания.
Примените средства защиты конфиденциальности, контроля доступа, защиты от инъекций, механизмы безопасности, модерацию и тестирование на проникновение.