Şablonlar için gelişmiş iş akışları


Firebase AI Logic için Firebase konsolu, şablonun içeriğini belirtmenize olanak tanıyan rehberli bir kullanıcı arayüzü sunar. Ancak şablon oluşturmak için daha gelişmiş yöntemlere ihtiyaç duyabileceğiniz çeşitli kullanım alanları vardır. Örneğin:

Bu sayfada açıklanan gelişmiş iş akışları, Firebase AI Logic REST API'yi kullanır.

REST API'yi kullanmayla ilgili önemli bilgiler

  • Bir şablonun kilidi açıksa REST API çağrınızda aynı şablon kimliğini kullanarak şablonun üzerine yazabilirsiniz. Kilitli bir şablonun üzerine yazılamaz.

  • REST API aracılığıyla bir sunucu istem şablonu oluşturduğunuzda ve konumunu global olarak ayarladığınızda sunucu istem şablonu, global dahil tüm konumlarda otomatik olarak sağlanır ve her iki Gemini API sağlayıcıyla da kullanılabilir. Ancak şablonu REST API aracılığıyla oluştururken başka bir konum ayarlarsanız şablon yalnızca Agent Platform Gemini API (formerly Vertex AI) tarafından kullanılabilir. Şablon için belirli bir konum ayarlama hakkında daha fazla bilgiyi bu sayfanın ilerleyen bölümlerinde bulabilirsiniz.

    Firebase konsolunda rehberli kullanıcı arayüzünü kullandığınızda şablonun global dahil tüm konumlarda otomatik olarak sağlandığını ve her iki Gemini API sağlayıcıyla da kullanılabileceğini unutmayın.

  • REST API aracılığıyla bir templateGenerateContent veya templateStreamGenerateContent isteğinde sunucu istem şablonuna erişmek için Gemini API sağlayıcınıza özel uç noktayı (Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI)) kullanmanız gerekir.

(Yalnızca Agent Platform Gemini API (formerly Vertex AI)) Şablon için belirli bir konum ayarlama

Bu bölüm aşağıdaki durumlar için geçerlidir:

  • Uygulamanızın kullanım alanında konuma dayalı şartlar var.

  • Uygulamanızın istekleri Agent Platform Gemini API (formerly Vertex AI) kullanır ve bir modele erişmek için konum belirtirsiniz.

Bu sayfanın önceki bölümlerinde açıklandığı gibi, aşağıdaki işlemlerden birini yaparsanız sunucu istem şablonu, Firebase AI Logic için desteklenen tüm bölgelerde (global dahil) otomatik olarak sağlanır:

  • Firebase konsolundaki rehberli kullanıcı arayüzünü kullanarak şablonu oluşturun.
  • REST API aracılığıyla şablonu oluşturun ve konumunu global olarak ayarlayın.

Bu, uygulamanızın isteğindeki konumu Firebase AI Logic için kullanılabilir bölgelerden herhangi birine ayarlayabileceğiniz ve şablonun kullanılabileceği anlamına gelir. Uygulamanızın global isteğinde konumu ayarlamanız gerekmez.

Ancak şablonunuzun yalnızca belirli bir konumda kullanılabilir olmasını istiyorsanız şablonu REST API aracılığıyla oluşturmanız ve söz konusu konumu açıkça ayarlamanız gerekir. Konumu global olarak ayarlamayın.

  1. projects.locations.templates.create uç noktasını çağırarak şablonu oluşturun. PromptTemplate oluşturma işleminin bir parçası olarak şablonun location değerini (ör. europe-west4) belirtin.

  2. Uygulamanızın isteğinde, modele eriştiğiniz konumun şablonun konumuyla (eu) eşleştiğinden emin olun.

Aşağıdakilere dikkat edin:

  • Firebase konsolundaki şablon listesinde yalnızca global konumunda (en azından) temel hazırlığı yapılmış şablonlar gösterilir.

  • Belirli bir konumda (global olmayan) şablon sağlamak için REST API'yi kullanırsanız uygulamanızın isteğinde modele eriştiğiniz konum, şablon için ayarlanan konumla eşleşmelidir. Konumlar eşleşmezse istek başarısız olur (bölgesel izolasyon politikaları nedeniyle).

Şablonu dosya olarak sağlama

projects.locations.templates.create uç noktasını çağırarak bir sunucu istem şablonu dosyasının içeriğini sağlayabilirsiniz.