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żesz potrzebować bardziej zaawansowanych sposobów konfigurowania szablonu, takich jak:

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

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. Zablokowanego szablonu nie można zastąpić.

  • 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 dostępny do użycia z obydwoma dostawcami Gemini API. Jeśli jednak podczas tworzenia szablonu za pomocą interfejsu REST API ustawisz inną lokalizację, szablon będzie dostępny tylko dla Agent Platform Gemini API (formerly Vertex AI). Więcej informacji o ustawianiu konkretnej lokalizacji w szablonie znajdziesz w dalszej części tego artykułu.

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

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

(Tylko Agent Platform Gemini API (formerly Vertex AI)) Ustawianie konkretnej lokalizacji dla szablonu

Ta sekcja dotyczy tych sytuacji:

  • Przypadek użycia aplikacji ma wymagania związane z lokalizacją.

  • Żądania aplikacji używają Agent Platform Gemini API (formerly Vertex AI), a Ty określasz lokalizację dostępu do modelu.

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

  • Utwórz szablon za pomocą interfejsu z instrukcjami w konsoli Firebase.
  • Utwórz szablon za pomocą interfejsu API typu REST i ustaw 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ć go za pomocą interfejsu API typu REST i wyraźnie ustawić tę lokalizację. Nie ustawiaj lokalizacji na global.

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

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

Pamiętaj:

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

  • Jeśli używasz interfejsu REST API do udostępniania szablonu w określonej lokalizacji (innej niż 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 będą się zgadzać, żądanie nie powiedzie się (ze względu na zasady izolacji regionalnej).

Podaj szablon jako plik

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