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 Firebase AI Logic REST API.

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

  • Gdy utworzysz szablon promptu serwera za pomocą interfejsu API REST 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 w przypadku Vertex AI Gemini API. 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 konsoli Firebase, 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 REST, musisz użyć punktu końcowego specyficznego dla dostawcy Gemini API (Gemini Developer API | Vertex AI Gemini API).

(Vertex AI Gemini API) 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, 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 dostępnych 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 chcesz, aby szablon był dostępny tylko w określonej lokalizacji, musisz utworzyć go za pomocą interfejsu REST API i wyraźnie 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, z 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ą (co najmniej) udostępnione w lokalizacji global.

  • Jeśli używasz interfejsu REST API do udostępniania 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).

Prześlij szablon jako plik.

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