Zaawansowane przepływy pracy w przypadku szablonów


W przypadku Firebase AI Logic konsola Firebase udostępnia interfejs z instrukcjami, który pomaga określić zawartość szablonu. Istnieje jednak kilka przypadków użycia, w których możesz potrzebować bardziej zaawansowanych sposobów konfigurowania szablonu, m.in.:

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

Ważne informacje o korzystaniu z interfejsu API REST

  • Jeśli szablon jest odblokowany, możesz go zastąpić, używając tego samego identyfikatora szablonu w wywołaniu interfejsu API 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 w global) i będzie dostępny do użycia z obydwoma dostawcami Gemini API. Jeśli jednak podczas tworzenia szablonu za pomocą interfejsu API REST ustawisz inną lokalizację, szablon będzie dostępny tylko dla Agent Platform Gemini API (formerly Vertex AI). Więcej informacji o ustawianiu konkretnej lokalizacji dla szablonu znajdziesz w dalszej części tej strony.

    Pamiętaj, że gdy korzystasz z interfejsu z instrukcjami w Firebase konsoli, szablon jest też automatycznie udostępniany we wszystkich lokalizacjach (w tym w 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 specyficznego dla Twojego dostawcy Gemini API (Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI)).

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

Ta sekcja dotyczy tych sytuacji:

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

  • Żądania aplikacji korzystają z 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 dla 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 REST i ustaw jego lokalizację na global.

Oznacza to, że w żądaniu aplikacji możesz ustawić lokalizację w dowolnym z regionów dostępnych dla Firebase AI Logic, a szablon będzie dostępny. Nie musisz ustawiać lokalizacji w żądaniu wysyłanym przez aplikację do global.

Jeśli jednak szablon ma być dostępny tylko w określonej lokalizacji, musisz utworzyć go za pomocą interfejsu REST API i  jawnie ustawić tę lokalizację. Nie ustawiaj lokalizacji jako 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 (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 są zgodne, żądanie zakończy się niepowodzeniem (z powodu zasad izolacji regionalnej).

Prześlij szablon jako plik

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