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


Firebase AI Logic için Firebase konsolunda, şablonun içeriğini belirtmenize yardımcı olacak bir kullanıcı arayüzü bulunur. Ancak, aşağıdakiler de dahil olmak üzere şablon oluşturmak için daha gelişmiş yöntemlere ihtiyaç duyabileceğiniz çeşitli kullanım alanları vardır:

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

REST API'yi kullanma hakkında önemli bilgiler

  • Bir şablonun kilidi açılırsa 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 istemi şablonu oluşturduğunuzda ve konumunu global olarak ayarladığınızda, sunucu istemi şablonu tüm konumlarda (global dahil) otomatik olarak sağlanır ve Gemini API sağlayıcılarının her ikisiyle de kullanılabilir. Ancak, şablonu REST API aracılığıyla oluştururken başka bir konum ayarlarsanız şablon yalnızca Vertex AI Gemini API 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 tüm konumlarda (global dahil) otomatik olarak sağlandığını ve her iki Gemini API sağlayıcıyla kullanılabildiğini unutmayın.

  • REST API üzerinden templateGenerateContent veya templateStreamGenerateContent isteğinde sunucu istemi şablonuna erişmek için Gemini API sağlayıcınıza özel uç noktayı kullanmanız gerekir (Gemini Developer API | Vertex AI Gemini API).

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

Bu bölüm aşağıdaki durumlarda geçerlidir:

  • Uygulamanızın kullanım alanında konum tabanlı şartlar var.

  • Uygulamanızın isteklerinde Vertex AI Gemini API kullanılır ve modele erişmek için bir konum belirtirsiniz.

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

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

Bu, uygulamanızın isteğinde konumu Firebase AI Logic için kullanılabilen bölgelerden herhangi biri olarak 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 üzerinden oluşturmanız ve söz konusu konumu açıkça ayarlamanız gerekir. Konumu olarak ayarlamayın.global

  1. projects.locations.templates.create uç noktasını çağırarak şablonu oluşturun. PromptTemplate oluşturma sürecinde şablonun location (ör. europe-west4) belirtin.

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

Aşağıdakilere dikkat edin:

  • Firebase konsolundaki şablon listesinde yalnızca global konumunda (en az) sağlanan şablonlar gösterilir.

  • REST API'yi kullanarak belirli bir konumda (global olmayan) şablon sağlarsanı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 istemi şablonu dosyasının içeriğini sağlayabilirsiniz.