Расширенные рабочие процессы для шаблонов


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

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

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

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

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

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

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

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

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

  • В сценарии использования вашего приложения предусмотрены требования, основанные на определении местоположения.

  • Запросы вашего приложения используют API Vertex AI Gemini , и вы указываете местоположение для доступа к модели .

Как описано ранее на этой странице, шаблон серверного приглашения автоматически предоставляется для всех доступных регионов 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. В запросе вашего приложения убедитесь, что место, где вы обращаетесь к модели, совпадает с местоположением шаблона ( europe-west4 ).

Обратите внимание на следующее:

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

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

Предоставьте шаблон в виде файла.

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