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


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

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

Важная информация об использовании 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.