Firebase AI Logic için Firebase konsolu, şablonun içeriğini belirtmenize yardımcı olacak bir kullanıcı arayüzü sunar.
Sunucu istemi şablonları, Dotprompt tabanlı bir sözdizimi ve biçim kullanır. Bu sayfada, şablon biçimi ve söz dizimiyle ilgili ayrıntılı açıklamaların yanı sıra örnekler de bulabilirsiniz.
Gemini modeline gönderilen örnek bir istekteki en önemli bileşenler şunlardır:
---
model: 'gemini-3.5-flash'
---
{{role "system"}}
All output must be a clearly structured invoice document.
Use a tabular or clearly delineated list format for line items.
{{role "user"}}
Create an example customer invoice for a customer named {{customerName}}.
Üçlü tireler arasındaki üst bölümde model adı ve isteğe bağlı olarak, istekte göndermek istediğiniz model yapılandırması, giriş doğrulama veya şema yer alır. Anahtar/değer çiftleri olarak yazılır ve genellikle YAML frontmatter olarak adlandırılır.
Şablonun gövdesinde istem bulunur. Ayrıca, isteğe bağlı olarak sistem talimatları ve giriş değerleri de içerebilir (Handlebars söz dizimi kullanılarak).
Bu sayfada, şablon biçimi ve söz dizimi ile ilgili ayrıntılı açıklamaların yanı sıra aşağıdakilerle ilgili örnekler verilmektedir:
Düşünme yapılandırması (Thinking configuration)
Bu sayfadaki tüm örneklerde gemini-3.5-flash kullanan şablonlar gösterilmektedir ancak Firebase AI Logic tarafından desteklenen herhangi bir Gemini modelini (Gemini Live modelleri hariç) kullanabilirsiniz.
Hello world
Aşağıda, sunucu istemi şablonunun en basit örneği verilmiştir:
Yapılandırma (ön sayfa)
---
model: 'gemini-3.5-flash'
---
İstem ve (geçerliyse) sistem talimatları
Write a story about a magic backpack.
Yanıt oluşturmayı kontrol etme
Kullanım alanınıza ve ihtiyaç duyduğunuz kontrol düzeyine bağlı olarak yanıt oluşturma sürecini çeşitli şekillerde kontrol edebilirsiniz.
Model yapılandırması
Modelin yanıt oluşturma şeklini kontrol etmek için model yapılandırması ayarlayın. Örneğin, yanıt varyasyonlarının sayısı (candidateCount), maksimum çıkış parçası vb.
Yapılandırma (ön sayfa)
---
model: 'gemini-3.5-flash'
config:
candidateCount: 1
maxOutputTokens: 200
stopSequences: ["red"]
---
İstem ve (geçerliyse) sistem talimatları
Write a story about a magic backpack.
Düşünme yapılandırması
Düşünmeyi destekleyen modeller için düşünmeyle ilgili bir yapılandırma belirtin.
Yapılandırma (ön sayfa)
Gemini 3.x ve sonraki modeller (düşünme seviyeleri)
--- model: 'gemini-3.5-flash' config: thinkingConfig: thinkingLevel: medium includeThoughts: true ---Gemini 2.5 modelleri (düşünme bütçeleri)
--- model: 'gemini-2.5-flash' config: thinkingConfig: thinkingBudget: 1024 includeThoughts: true ---
İstem ve (geçerliyse) sistem talimatları
Solve x^2 + 4x + 4 = 0
Güvenlik ayarları
Zararlı olarak değerlendirilebilecek yanıtlar alma olasılığını ayarlamak için güvenlik ayarlarını kullanın.
Yapılandırma (ön sayfa)
Tek bir güvenlik ayarı içeren örnek:
---
model: 'gemini-3.5-flash'
config:
safetySettings:
- category: HARM_CATEGORY_HARASSMENT
threshold: BLOCK_ONLY_HIGH
---
Birden fazla güvenlik ayarı içeren örnek:
---
model: 'gemini-3.5-flash'
config:
safetySettings:
- category: HARM_CATEGORY_HARASSMENT
threshold: BLOCK_ONLY_HIGH
- category: HARM_CATEGORY_HATE_SPEECH
threshold: BLOCK_MEDIUM_AND_ABOVE
---
İstem ve (geçerliyse) sistem talimatları
Write a story about a magic backpack.
Sistem talimatları
Modelin davranışını yönlendirmek için sistem talimatları ayarlayın. Bu bilgileri isteme dahil edebilirsiniz:
{{role "system"}}söz dizimini kullanarak sistem talimatlarını belirtin.{{role "user"}}söz dizimini kullanarak metin istemini belirtin.
Yapılandırma (ön sayfa)
---
model: 'gemini-3.5-flash'
---
İstem ve (geçerliyse) sistem talimatları
{{role "system"}}
All output must be a clearly structured invoice document.
Use a tabular or clearly delineated list format for line items.
{{role "user"}}
Create an example customer invoice for a customer.
Giriş değişkenleri
Bazı istemler statiktir ancak genellikle isteme kullanıcıdan alınan bazı verileri eklemeniz gerekir.
Handlebars ifadelerini kullanarak isteme dinamik giriş değişkenleri ekleyebilirsiniz. Bu ifadeler, {{ }} etiketleri içinde {{variableName}} veya {{object.propertyName}} (örneğin, Hello, {{name}} from {{address.city}}) biçiminde yer alır.
Yapılandırma (ön sayfa)
---
model: 'gemini-3.5-flash'
---
İstem ve (geçerliyse) sistem talimatları
Create an example customer invoice for a customer named {{customerName}}.
Şablonda varsayılan bir değer sağlayabilirsiniz ancak giriş değişkeninin değeri genellikle istek kapsamında istemci tarafından sağlanır.
Kontrol akışları (döngüler ve koşullar)
Daha karmaşık istemler yazmak için koşullu bloklar (ör. #if, else ve #unless) ve yineleme (#each) kullanabilirsiniz.
Özel @ önekine sahip değişkenler olarak ek bağlamsal bilgiler sağlayabilirsiniz:
@first:#eachbloğunun ilk öğesi üzerinde yineleme yapılırken doğru (true) olur.@last:#eachbloğunun son öğesi üzerinde yineleme yapılırken true (doğru) olur.@index: Geçerli öğenin (sıfır tabanlı) dizin konumunu verir.
Tüm yerleşik mantıksal yardımcılar hakkında bilgi edinmek için Handlebars belgelerine bakın.
Yapılandırma (ön sayfa)
---
model: 'gemini-3.5-flash'
---
İstem ve (geçerliyse) sistem talimatları
Create an example customer invoice for a customer named {{customerName}}.
Include entries for each of the following products
{{#each productNames}}
{{#if @first}}
Include line items for the following purchases
{{/if}}
- {{this}}
{{/each}}
{{#if isVipCustomer}}
Give the customer a 5% discount.
{{/if}}
Koşullu ifadelerin yalnızca değişken referansı kabul ettiğini, herhangi bir ifade türünü kabul etmediğini unutmayın. Örneğin:
- Aşağıdakiler çalışır:
{{#if isVipCustomer}} ... {{/if}} - Aşağıdaki işlemler çalışmaz:
{{#if customer.type == 'vip'}} ... {{/if}}
Değişken bir boole ise koşullu ifade beklendiği gibi çalışır. Değişken bir boole değilse koşullu ifade aslında bir "null değil" kontrolüdür. Bu, isteğe bağlı girişleri işlemek için yararlı olabilir. Örneğin:
{{#if customerName}}
Hello {{customerName}}
{{else}}
Hello Guest
{{/if}}
Giriş doğrulaması ve şeması
İstemciden gelen verileriniz varsa istem enjeksiyonuna karşı korunmanıza yardımcı olması ve istekte iletilen verilerin beklentilerinizi karşılamasını sağlamak için giriş şemasını kullanmanızı önemle tavsiye ederiz.
Müşteri değer sağlamazsa varsayılan değerler sağlayabilirsiniz.
Şema,
string,integer,number,booleanveobjectgibi skaler türleri destekler. Nesneler, diziler ve numaralandırmalar, alan adından sonra parantez içinde gösterilir.?ile isteğe bağlı olarak belirtmediğiniz sürece tüm özellikler zorunlu kabul edilir. Bir özellik isteğe bağlı olarak işaretlendiğinde, LLM'lerin bir alanı atlamak yerine null döndürmesi için daha fazla esneklik sağlamak amacıyla null yapılabilir hale de getirilir.
Giriş şeması sağlama konusunda temel bir örneği aşağıda bulabilirsiniz. Daha gelişmiş bir şemayı ise hemen altında bulabilirsiniz.
Yapılandırma (ön sayfa)
---
model: 'gemini-3.5-flash'
input:
default:
isVipCustomer: false
schema:
customerName: string, the customers name # string, number, and boolean types are defined like this
productNames?(array, list of products to include in the invoice): string # optional fields are marked with a ?
isVipCustomer?: boolean, whether or not the customer is a VIP
---
İstem ve (geçerliyse) sistem talimatları
Create an example customer invoice for a customer named {{customerName}}.
Include entries for each of the following products
{{#each productNames}}
{{#if @first}}
Include line items for the following purchases
{{/if}}
- {{this}}
{{/each}}
{{#if isVipCustomer}}
Give the customer a 5% discount.
{{/if}}
Çıkış şeması
Modelin yapılandırılmış JSON çıkışı oluşturmasını istiyorsanız çıkış şeması belirtebilirsiniz. format: json belirterek modeli, her zaman belirtilen şemaya uygun bir JSON yanıtı döndürmeye zorlarsınız.
Şema,
string,integer,number,booleanveobjectgibi skaler türleri destekler. Nesneler, diziler ve numaralandırmalar, alan adından sonra parantez içinde gösterilir.?ile isteğe bağlı olarak belirtmediğiniz sürece tüm özellikler zorunlu kabul edilir. Bir özellik isteğe bağlı olarak işaretlendiğinde, LLM'lerin bir alanı atlamak yerine null döndürmesi için daha fazla esneklik sağlamak amacıyla null yapılabilir hale de getirilir.
Yapılandırılmış JSON çıkışı oluşturmayla ilgili temel bir örneği burada bulabilirsiniz. Daha gelişmiş bir şemayı hemen aşağıda bulabilirsiniz.
Yapılandırma (ön sayfa)
---
model: gemini-3.5-flash
output:
format: json
schema:
invoiceId: string
invoiceFile(object, an invoice file):
url?: string
contents: string
mimeType: string
---
İstem ve (geçerliyse) sistem talimatları
Create an example customer invoice.
Çok formatlı giriş
Bir Gemini modeline gönderilen çok formatlı istemler, dosyalar (ör. resimlerin yanı sıra metin, PDF, düz metin dosyaları, ses ve video) dahil olmak üzere birden fazla giriş türü içerebilir.
{{media url}}söz dizimini kullanarak URL'siyle birlikte bir dosya sağlayın.{{media type="mime_type" data="contents"}}söz dizimine sahip bir satır içi dosya sağlayın.
Temel örnek (çok formatlı giriş)
Çok formatlı giriş sağlama konusunda temel bir örneği burada bulabilirsiniz. Daha karmaşık bir örneği ise hemen aşağıda bulabilirsiniz.
Yapılandırma (ön sayfa)
---
model: 'gemini-3.5-flash'
---
İstem ve (geçerliyse) sistem talimatları
Describe this image
{{media type="mimeType" data="imageData"}}
Karmaşık örnek (çok formatlı giriş)
Çok formatlı giriş sağlama konusunda daha karmaşık bir örneği burada bulabilirsiniz.
Yapılandırma (ön sayfa)
---
model: gemini-3.5-flash
input:
schema:
image_urls?(array, urls of external images): string
inline_images?(array, inline image data):
type: object
properties:
mime_type: string
contents: string # inline data must be base64-encoded
---
İstem ve (geçerliyse) sistem talimatları
{{role "system"}}
Use the following image as the basis for comparisons
{{media url="http://example.com/reference_img.bmp"}}
{{role "user"}}
What do the following images have in common?
{{#each image_urls}}
{{media url="this"}}
{{/each}}
{{#each inline_images}}
{{media type="mime_type" data="contents"}}
{{/each}}
Araç kullanımı
Sunucu istemi şablonları aşağıdaki araçları destekler.
Kullanıcılarınızın modele istek için ek bilgiler sağlamasını istiyorsanız sunucu istemi şablonunda giriş doğrulama ile birlikte giriş değişkenlerini kullanın.
İşlev çağırma
Sunucu istemi şablonlarını kullanarak işlev çağrısı yapma ile ilgili kılavuzun tamamını inceleyin.
Kod yürütme
Kod yürütme aracı, modelin Python kodu oluşturup çalıştırmasına olanak tanır.
Yapılandırma (ön sayfa)
---
model: 'gemini-3.5-flash'
tools:
- codeExecution
---
İstem ve (geçerliyse) sistem talimatları
What is the sum of the first 50 prime numbers?
Generate and run code for the calculation, and make sure you get all 50.
URL bağlamı
URL bağlamı aracı, URL'ler şeklinde modele ek bağlam sağlamanıza olanak tanır. Bu örnekte, kullanıcı tarafından sağlanan URL'ler için giriş doğrulama işlemini nasıl belirtebileceğiniz de gösterilmektedir.
Yapılandırma (ön sayfa)
---
model: 'gemini-3.5-flash'
input:
schema:
url1:
type: string
pattern: '^https?://[\w.-]+\.[a-z]{2,}\S*$'
maxLength: 100
url2:
type: string
pattern: '^https?://[\w.-]+\.[a-z]{2,}\S*$'
maxLength: 100
tools:
- urlContext
---
İstem ve (geçerliyse) sistem talimatları
Compare the ingredients and cooking times from the recipes at {{url1}} and {{url2}}
Google Search ile temellendirme
Yapılandırma (ön sayfa)
---
model: 'gemini-3.5-flash'
tools:
- googleSearch
---
İstem ve (geçerliyse) sistem talimatları
Who won the Euro 2024?
Google Maps ile temellendirme
googleMaps aracını kullanmak için şablonun ön sayfasındaki tools nesnesinde listeleyin. Aşağıdaki örnekte bazı ek isteğe bağlı yapılandırmalar gösterilmektedir:
İstemci tarafı kodundan giriş değişkenlerine izin verin ve bu girişin (bu örnekte
question) giriş doğrulamasını ve şemasını gerçekleştirin.googleMapskullanarak istemci tarafı kodunuzda bir konumun koordinatlarını ve/veya bir dil kodu sağlayarakgoogleMapsaracını yapılandırın.TemplateToolConfig
Örnek şablonun altında, bu isteğe bağlı yapılandırmalarla çalışmaya yönelik istemci tarafı kod örneklerini gösteren bir genişletilebilir bölüm bulunur.
Yapılandırma (ön sayfa)
---
model: 'gemini-3.5-flash'
tools:
- googleMaps
input:
schema:
question: string
---
İstem ve (geçerliyse) sistem talimatları
{{role "system"}}
You are a helpful tour guide. Use the Google Maps tool with the provided coordinates to answer the user's question based on their location.
{{role "user"}}
{{question}}
Imagen (görüntü oluşturma) (Kullanımdan kaldırıldı)
İlk sürümde, sunucu istemi şablonları yalnızca metin içeren bir istemle Imagen modellerini kullanarak görüntü oluşturmayı destekler. Imagen ile görüntü düzenleme de dahil olmak üzere daha fazla destek için yakında tekrar kontrol edin (Vertex AI Gemini API kullanılırken).
Temel
Bu örnekte, Imagen ile görüntü oluşturmak için temel bir şablon gösterilmektedir. Şablonda, Gemini'a benzer giriş değişkenleri ve giriş doğrulaması yer alır.
Yapılandırma (ön sayfa)
---
model: 'imagen-4.0-generate-001'
input:
schema:
prompt: 'string'
---
İstem ve (geçerliyse) sistem talimatları
Create an image containing {{prompt}}
Gelişmiş
Bu örnekte, Gemini'ye benzer şekilde model yapılandırması ekleme, güvenlik ayarlarını belirtme ve istemde giriş değişkenleri, giriş doğrulama ve kontrol akışları gibi daha ileri seviye özelliklerin nasıl kullanılacağı gösterilmektedir.
Yapılandırma (ön sayfa)
---
model: 'imagen-4.0-fast-generate-001'
config:
sampleCount: 1
aspectRatio: "16:9"
personGeneration: dont_allow
includeRaiReason: true
safetySetting: block_medium_and_above
input:
schema:
style(enum, The style of image): [photo, sketch, painting]
subject: string, The object or animal or scenery to generate.
context?: string, Optional background or context description.
default:
style: photo
---
İstem ve (geçerliyse) sistem talimatları
A {{style}} of {{subject}}{{#if context}}{{context}}{{/if}}.