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


Firebase AI Logic için Firebase konsolu, şablonun içeriğini belirtmeniz için size rehberlik eden bir kullanıcı arayüzü sağlar. 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 kullanmayla ilgili ö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 Agent Platform Gemini API (formerly Vertex AI) için 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 aracılığıyla templateGenerateContent veya templateStreamGenerateContent isteğinde bir sunucu istemi şablonuna erişmek için Gemini API sağlayıcınıza özgü uç noktayı kullanmanız gerekir (Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI)).

(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 isteklerinde Agent Platform Gemini API (formerly Vertex AI) kullanılıyor ve modele erişmek için 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 desteklenen 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ılmasını istiyorsanız şablonu REST API aracılığıyla oluşturmanız ve bu 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 sürecinde şablonun location (ör. europe-west4) değerini 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) 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.