На этой странице описаны рекомендации и важные моменты, которые следует учитывать при работе с шаблонами запросов к серверу, в том числе пока не поддерживаемые функции. Обратите внимание, что многие из этих функций станут доступны по мере развития шаблонов запросов на сервере, поэтому следите за примечаниями к выпуску.
Рекомендации
Многие из этих рекомендаций также описаны в разделе Как управлять шаблонами.
Как создавать версии шаблонов
Создайте идентификаторы шаблонов с версией, в которой используется семантическое управление версиями.
Используйте Firebase Remote Config, чтобы легко менять шаблон и другие значения в запросе.
Как защитить шаблон
Не редактируйте шаблоны, которые используются в рабочей среде, если вы не протестировали изменения.
Заблокируйте шаблон перед публикацией.
Блокировка шаблона защищает от случайного редактирования, но не запрещает его полностью. Участник проекта с соответствующими разрешениями всегда может разблокировать шаблон, чтобы отредактировать его.
Мы рекомендуем блокировать шаблоны, которые активно используются в коде, особенно в производственном.
Как защитить использование Gemini API
Используйте надежную проверку входных данных, которая поможет:
- Помогает защититься от внедрения запросов.
- Помогает убедиться, что запросы выполняются, а ответы соответствуют ожиданиям.
Включите для проекта Firebase режим использования только шаблонов, чтобы все запросы Gemini API через Firebase AI Logic должны были использовать шаблон запроса к серверу.
Функции, которые пока не поддерживаются шаблонами запросов на сервере
Многие из этих функций станут доступны по мере развития шаблонов запросов на сервере, поэтому следите за примечаниями к выпуску.
Возможности Firebase AI Logic пока не поддерживаются шаблонами
Следующие стандартные функции Firebase AI Logic пока не поддерживаются в шаблонах запросов на стороне сервера:
- Двунаправленная трансляция (Gemini Live API)
- Гибридный или встроенный вывод
- Как ограничить список перечислений в ответе
Также обратите внимание, что если вы используете мониторинг ИИ в консоли Firebase, идентификатор шаблона пока не заполняется ни в одной записи.
Распространенные элементы Dotprompt, которые пока не поддерживаются шаблонами
Шаблоны запросов для серверов скорее всего в ближайшее время будут поддерживать следующие распространенные элементы Dotprompt:
Используйте спецификацию схемы JSON для входных и выходных схем в вашем frontmatter.
- Обратите внимание, что эта спецификация не поддерживается и в запросах шаблонов, не относящихся к серверу. В настоящее время поддерживается только спецификация схемы OpenAPI.
Объявление определения поля с подстановочным знаком с помощью
*.Использование
@keyили итерация по полям объекта (в этом случае@keyимеет смысл).Используйте
@root, чтобы ссылаться на контекст корневой переменной независимо от текущего значенияthis.
Шаблоны запросов на сервере скорее всего не будут поддерживать следующие распространенные элементы Dotprompt:
- Используйте частичные шаблоны – фрагменты шаблонов, которые можно включать в другие шаблоны.
Дополнительные рекомендации
По умолчанию при использовании управляемого интерфейса в консоли Firebase мы предоставляем шаблон во всех поддерживаемых регионах для Firebase AI Logic. Если вы используете параметр Agent Platform Gemini API (formerly Vertex AI) и вам нужны ограничения на основе местоположения, вы можете указать местоположение для шаблона с помощью REST API.
Если вы хотите предоставить шаблон запроса к серверу в виде файла (вместо того чтобы использовать пошаговый интерфейс консоли Firebase), вы можете использовать REST API. Обратите внимание, что шаблоны запросов на сервере не поддерживают схемы, определенные в коде приложения и переданные в шаблон.
Несмотря на то что шаблон находится на сервере, он не может напрямую взаимодействовать с другими серверными ресурсами проекта Firebase (например, с базой данных), кроме URL Cloud Storage for Firebase (которые можно указать в качестве входных переменных).