Дополнительные возможности для шаблонов


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

В описанных на этой странице расширенных рабочих процессах используется Firebase AI Logic REST API.

Важная информация об использовании REST API

  • Если шаблон разблокирован, его можно перезаписать, используя тот же идентификатор шаблона в вызове REST API. Заблокированный шаблон нельзя перезаписать.

  • Если вы создадите шаблон запроса на сервере с помощью REST API и зададите для него местоположение global, то шаблон запроса на сервере будет автоматически инициализирован во всех местоположениях (включая global) и будет доступен для использования обоими поставщиками Gemini API. Однако если при создании шаблона с помощью REST API вы зададите другое местоположение, шаблон будет доступен только в Agent Platform Gemini API (formerly Vertex AI). Подробнее о том, как задать определенное местоположение для шаблона…

    Обратите внимание, что при использовании управляемого интерфейса в консоли Firebase шаблон также автоматически инициализируется во всех местоположениях (включая global) и доступен для использования с обоими поставщиками Gemini API.

  • Чтобы получить доступ к шаблону запроса на сервере в запросе templateGenerateContent или templateStreamGenerateContent через REST API, необходимо использовать конечную точку, относящуюся к вашему поставщику Gemini API (Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI)).

(Только Agent Platform Gemini API (formerly Vertex AI)) Как задать определенное местоположение для шаблона

Этот раздел относится к следующим ситуациям:

  • В вашем приложении есть функции, требующие доступа к местоположению.

  • В запросах вашего приложения используется Agent Platform Gemini API (formerly Vertex AI), и вы указываете местоположение для доступа к модели.

Как описано выше, шаблон запроса к серверу автоматически предоставляется во всех поддерживаемых регионах для Firebase AI Logic (включая global), если вы выполните одно из следующих действий:

  • Создайте шаблон с помощью интерфейса Firebase.
  • Создайте шаблон с помощью REST API и задайте для него местоположение global.

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

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

  1. Создайте шаблон, вызвав конечную точку projects.locations.templates.create. Укажите location шаблона (например, europe-west4) при создании PromptTemplate.

  2. В запросе приложения убедитесь, что местоположение, в котором вы получаете доступ к модели, совпадает с местоположением шаблона (eu).

Обратите внимание:

  • В списке шаблонов в консоли Firebase показываются только те шаблоны, которые (как минимум) подготовлены в местоположении global.

  • Если вы используете REST API для инициализации шаблона в определенном местоположении (не global), то местоположение, в котором вы получаете доступ к модели в запросе приложения, должно совпадать с местоположением, заданным для шаблона. Если местоположения не совпадают, запрос будет отклонен (из-за правил региональной изоляции).

Как предоставить шаблон в виде файла

Вы можете предоставить содержимое файла шаблона запроса к серверу, вызвав конечную точку projects.locations.templates.create.