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


Firebase AI Logic için Firebase konsolu, şablonun içeriğini belirtmenize yardımcı olacak 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ı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 şablonların ü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 global dahil tüm konumlarda otomatik olarak sağlandığını ve Gemini API sağlayıcılarının her ikisiyle de kullanılabildiğini unutmayın.

  • REST API üzerinden templateGenerateContent veya templateStreamGenerateContent isteğinde bir 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ıyor ve modele erişmek için bir konum belirtiyorsunuz.

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 değerini (örneğin, 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.

  • Belirli bir konumda (global olmayan) şablon sağlamak için REST API'yi kullanıyorsanı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.