Zaawansowane przepływy pracy w przypadku szablonów


W przypadku Firebase AI Logic konsola Firebase udostępnia interfejs z instrukcjami, który umożliwia określenie zawartości szablonu. Istnieje jednak kilka przypadków użycia, w których może być konieczne bardziej zaawansowane skonfigurowanie szablonu, np.:

Zaawansowane przepływy pracy opisane na tej stronie korzystają z Firebase AI Logic interfejsu REST API.

Ważne informacje o korzystaniu z interfejsu REST API

  • Jeśli szablon jest odblokowany, możesz go zastąpić, używając tego samego identyfikatora szablonu w wywołaniu interfejsu API typu REST. Nie można zastąpić zablokowanego szablonu.

  • Gdy utworzysz szablon promptu serwera za pomocą interfejsu REST API i ustawisz jego lokalizację na global, szablon promptu serwera zostanie automatycznie udostępniony we wszystkich lokalizacjach (w tym global) i będzie można go używać z oboma dostawcami Gemini API. Jeśli jednak podczas tworzenia szablonu za pomocą interfejsu REST API ustawisz inną lokalizację, szablon będzie dostępny tylko w Vertex AI Gemini API. Więcej informacji o ustawianiu konkretnej lokalizacji szablonu znajdziesz w dalszej części tej strony.

    Pamiętaj, że gdy używasz interfejsu z instrukcjami w konsoli Firebase, szablon jest też automatycznie udostępniany we wszystkich lokalizacjach (w tym global), i można go używać z oboma dostawcami Gemini API.

  • Aby uzyskać dostęp do szablonu promptu serwera w żądaniu templateGenerateContent lub templateStreamGenerateContent za pomocą interfejsu REST API, musisz użyć punktu końcowego właściwego dla dostawcy Gemini API (Gemini Developer API | Vertex AI Gemini API).

(Vertex AI Gemini API tylko) Ustawianie konkretnej lokalizacji szablonu

Ta sekcja dotyczy tych sytuacji:

  • Przypadek użycia aplikacji ma wymagania dotyczące lokalizacji.

  • Żądania aplikacji korzystają z Vertex AI Gemini API i określasz lokalizację dostępu do modelu.

Jak opisano wcześniej na tej stronie, szablon promptu serwera jest automatycznie udostępniany we wszystkich regionach dostępnych dla Firebase AI Logic (w tym global), jeśli wykonasz jedną z tych czynności:

  • Utworzysz szablon za pomocą interfejsu z instrukcjami w konsoli Firebase.
  • Utworzysz szablon za pomocą interfejsu REST API i ustawisz jego lokalizację na global.

Oznacza to, że możesz ustawić lokalizację w żądaniu aplikacji na dowolny z dostępnych regionów dla Firebase AI Logic, a szablon będzie dostępny. Nie musisz ustawiać lokalizacji w żądaniu aplikacji na global.

Jeśli jednak chcesz, aby szablon był dostępny tylko w określonej lokalizacji, musisz utworzyć szablon za pomocą interfejsu REST API i wyraźnie ustawić tę lokalizację. Nie ustawiaj lokalizacji na global.

  1. Utwórz szablon, wywołując projects.locations.templates.create punkt końcowy. Określ location szablonu (np. europe-west4) podczas tworzenia PromptTemplate.

  2. W żądaniu aplikacji upewnij się, że lokalizacja, w której uzyskujesz dostęp do modelu jest zgodna z lokalizacją szablonu (europe-west4).

Pamiętaj:

  • Lista szablonów w konsoli Firebase zawiera tylko szablony, które są udostępnione co najmniej w lokalizacji global.

  • Jeśli używasz interfejsu REST API do udostępnienia szablonu w określonej lokalizacji (która nie jest global), lokalizacja, w której uzyskujesz dostęp do modelu w żądaniu aplikacji, musi być zgodna z lokalizacją ustawioną dla szablonu. Jeśli lokalizacje nie są zgodne, żądanie zakończy się niepowodzeniem (z powodu zasad izolacji regionalnej).

Udostępnianie szablonu jako pliku

Zawartość pliku szablonu promptu serwera możesz podać, wywołując projects.locations.templates.create punkt końcowy.