Gemini 3 Pro & Flash, Gemini 3 Pro Image (nano banana pro), and the latest Gemini Live API native audio models are now available to use with Firebase AI Logic on all platforms!

Bu sayfa, Cloud Translation API ile çevrilmiştir.

Şablon biçimi, söz dizimi ve örnekler

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ı sözdizimi ve biçim kullanır. Bu sayfada, şablon biçimi ve söz dizimi ile ilgili ayrıntılı açıklamaların yanı sıra hem Gemini hem de Imagen için örnekler bulabilirsiniz.

Gemini modeline gönderilen örnek bir istek için en önemli bileşenler şunlardır:

---
model: 'gemini-2.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:

Gemini
Imagen
- Temel
- Gelişmiş

Gemini

Bu bölümdeki tüm örneklerde gemini-2.5-flash kullanılan ş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 kısım)

---
model: 'gemini-2.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, maksimum çıkış jetonu, sıcaklık, üst K ve üst P.

Yapılandırma (ön kısım)

---
model: 'gemini-2.5-flash'
config:
  candidateCount: 1
  temperature: 0.9
  topP: 0.1
  topK: 16
  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 kısım)

---
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 kısım)

Bir güvenlik ayarı içeren örnek:

---
model: 'gemini-2.5-flash'
config:
  safetySettings:
    - category: HARM_CATEGORY_HARASSMENT
      threshold: BLOCK_ONLY_HIGH
---

Birden fazla güvenlik ayarı içeren örnek:

---
model: 'gemini-2.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 istemin bir parçası olarak ekleyin:

{{role "system"}} söz dizimini kullanarak sistem talimatlarını belirtin.
{{role "user"}} söz dizimini kullanarak metin istemini belirtin.

Yapılandırma (ön kısım)

---
model: 'gemini-2.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}} biçiminde (örneğin, Hello, {{name}} from {{address.city}}) yer alır.

Yapılandırma (ön kısım)

---
model: 'gemini-2.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.

Giriş değerleri sağlayan istemci tarafı isteğini görüntüleme

Bu sayfada sağlayıcıya özel içerikleri ve kodu görüntülemek için Gemini API sağlayıcınızı tıklayın.

Swift


// ...

// Initialize the Gemini Developer API backend service
// Create a `TemplateGenerativeModel` instance
let model = FirebaseAI.firebaseAI(backend: .googleAI()).templateGenerativeModel()

let customerName = "Jane"

do {
    let response = try await model.generateContent(
        // Specify your template ID
        templateID: "my-first-template-v1-0-0",
        // Provide the values for any input variables required by your template.
        inputs: [
            "customerName": customerName
        ]
    )
    if let text = response.text {
        print("Response Text: \(text)")
    }
} catch {
    print("An error occurred: \(error)")
}
print("\n")

Kotlin


// ...

// Initialize the Gemini Developer API backend service
// Create a `TemplateGenerativeModel` instance
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).templateGenerativeModel()

val customerName = "Jane"

val response = model.generateContent(
    // Specify your template ID
    "my-first-template-v1-0-0",
    // Provide the values for any input variables required by your template.
    mapOf(
        "customerName" to customerName
    )
)

val text = response.text
println(text)

Java


// ...

// Initialize the Gemini Developer API backend service
// Create a `TemplateGenerativeModel` instance
TemplateGenerativeModel generativeModel = FirebaseAI.getInstance().templateGenerativeModel();

TemplateGenerativeModelFutures model = TemplateGenerativeModelFutures.from(generativeModel);

String customerName = "Jane";

Future response = model.generateContent(
    // Specify your template ID
    "my-first-template-v1-0-0",
    // Provide the values for any input variables required by your template.
    mapOf("customerName", customerName)
);
addCallback(response,
       new FutureCallback() {
           public void onSuccess(GenerateContentResponse result) {
             System.out.println(result.getText());
           }
           public void onFailure(Throwable t) {
             reportError(t);
           }
    }
executor);

Web


// ...

// Initialize the Gemini Developer API backend service
const ai = getAI(app, { backend: new GoogleAIBackend() });

// Create a `TemplateGenerativeModel` instance
const model = getTemplateGenerativeModel(ai);

const customerName = 'Jane';

const result = await model.generateContent(
  // Specify your template ID
  'my-first-template-v1-0-0',
  // Provide the values for any input variables required by your template
  {
    customerName: customerName,
  }
);

const response = result.response;
const text = response.text();

Dart


// ...

// Initialize the Gemini Developer API backend service
// Create a `TemplateGenerativeModel` instance
var _model = FirebaseAI.googleAI().templateGenerativeModel()

var customerName = 'Jane';

var response = await _model.generateContent(
        // Specify your template ID
        'my-first-template-v1-0-0',
        // Provide the values for any input variables required by your template
        inputs: {
           'customerName': customerName,
        },
      );

var text = response?.text;
print(text);

Unity


// ...

// Initialize the Gemini Developer API backend service
var firebaseAI = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());

// Create a `TemplateGenerativeModel` instance
var model = firebaseAI.GetTemplateGenerativeModel();

var customerName = "Jane";

try
{
   var response = await model.GenerateContentAsync(
      // Specify your template ID
      "my-first-template-v1-0-0",
      // Provide the values for any input variables required by your template
      new Dictionary<string, object> {
         { "customerName", customerName },
      }
   );
   Debug.Log($"Response Text: {response.Text}");
}
catch (Exception e) {
  Debug.LogError($"An error occurred: {e.Message}");
}

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 bir @ önekiyle değişken olarak ek bağlamsal bilgiler sağlayabilirsiniz:

@first: #each bloğunun ilk öğesi üzerinde yineleme yapılırken doğru (true) olur.
@last: #each bloğ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 kısım)

---
model: 'gemini-2.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 boolean değilse koşullu ifade, etkin bir şekilde "null değil" kontrolü olur. 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 şema

İstemciden gelen verileriniz varsa istem ekleme saldırılarına 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, boolean ve object gibi 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 değer atanabilir hale de getirilir.

Giriş şeması sağlama ile ilgili temel bir örneği burada bulabilirsiniz. Daha gelişmiş bir şemayı hemen aşağıda bulabilirsiniz.

Yapılandırma (ön kısım)

---
model: 'gemini-2.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}}

Giriş şeması sağlama konusunda daha karmaşık bir örneği inceleyin.

Yapılandırma (ön kısım)

---
model: gemini-2.5-flash
input:
  schema:
    customer:
      type: object
      description: details about the customer
      required: [lastName, address]
      properties:
        firstName:
          type: string
          minLength: 2
          maxLength: 50
        lastName:
          type: string
          minLength: 2
          maxLength: 50
        address:
          type: object
          description: customer's address
          required: [street, city, country]
          properties:
            street:
              type: string
            city:
              type: string
            country:
              type: string
        isVip:
          type: boolean
          description: whether or not the customer is a VIP
    purchases?:
      type: array
      description: list of things the customer purchased
      items:
        type: object
        required: [itemName, sku, cost, quantity]
        properties:
          itemName:
            type: string
          sku:
            type: string
            minLength: 7
            maxLength: 19
            pattern: "^[0-9]{1,3}-[a-zA-Z]{3,10}-[0-9]{1,4}$"
          category:
            enum: ["ELECTRONICS", "APPAREL", "HOME", "MISC" ]
          cost:
            type: number
            minimum: 0
          quantity:
            type: number
            minimum: 1
            maximum: 200
---

İstem ve (geçerliyse) sistem talimatları

Create an example customer invoice for a customer.

The customer's address is

{{customer.firstName}} {{customer.lastName}}
{{customer.address.street}}
{{customer.address.city}}
{{customer.address.country}}

{{#each purchases}}
  {{#if @first}}
  Include line items for the following purchaes
  {{/if}}
  - {{quantity}} x {{itemName}} ({{sku}}) @ ${{cost}}, category {{category}}
{{/each}}

{{#if customer.isVip}}
Give the customer a 5% discount.
{{/if}}

Çıkış şeması

Modelin yapılandırılmış JSON çıkışı oluşturmasını istiyorsanız bir çı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, boolean ve object gibi 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 değer atanabilir 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 kısım)

---
model: gemini-2.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.

Yapılandırılmış JSON çıkışı oluşturmayla ilgili daha karmaşık bir örneği inceleyin.

Yapılandırma (ön kısım)

---
model: gemini-2.5-flash
output:
  format: json
  schema:
    title: string  # string, number, and boolean types are defined like this
    subtitle?: string  # optional fields are marked with a ?
    draft?: boolean, true when in draft state
    status?(enum, approval status): [PENDING, APPROVED]
    date: string, the date of publication for example '2024-04-09' # descriptions follow a comma
    tags(array, relevant tags for article): string  # arrays are denoted via parentheses
    authors(array):
      name: string
      email?: string
    metadata?(object): # objects are also denoted via parentheses
      updatedAt?: string, ISO timestamp of last update
      approvedBy?: integer, id of approver
    extra?: any, arbitrary extra data
    (*): string, wildcard field
---

İstem ve (geçerliyse) sistem talimatları

Store all the specified information about the provided article.

Ç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 bir dosya sağlayın.
{{media type="mime_type" data="contents"}}söz dizimine sahip satır içi bir dosya sağlayın.

Çok formatlı giriş sağlama ile ilgili temel bir örneği burada bulabilirsiniz. Daha karmaşık bir örneği hemen aşağıda bulabilirsiniz.

Yapılandırma (ön kısım)

---
model: 'gemini-2.5-flash'
---

İstem ve (geçerliyse) sistem talimatları

Describe this image

{{media type="mimeType" data="imageData"}}

Şablonunuzu konsolda test etmek için base64 kodlu verileri nasıl sağlayacağınızı öğrenin.

Şablonunuzda base64 kodlu veriler varsa bunları Firebase konsolunun test deneyimine nasıl dahil edebileceğiniz aşağıda açıklanmıştır:

  {
    "mimeType": "image/png",
    "imageData": "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"
  }

Çok formatlı giriş sağlama konusunda daha karmaşık bir örneği inceleyin.

Yapılandırma (ön kısım)

---
model: gemini-2.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}}

Imagen (Görüntü üretme)

İlk sürümde, sunucu istemi şablonları yalnızca metin istemiyle Imagen modellerini kullanarak görüntü oluşturmayı destekler. Imagen ile resim düzenleme (Vertex AI Gemini API kullanılırken) dahil olmak üzere daha fazla destek için yakında tekrar kontrol edin.

Temel

Bu örnekte, Imagen ile resim oluşturmak için Gemini'a benzer giriş değişkenleri ve giriş doğrulaması içeren temel bir şablon gösterilmektedir.

Yapılandırma (ön kısım)

---
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, model yapılandırması ekleme, güvenlik ayarlarını belirtme ve istemde Gemini'ye benzer şekilde giriş değişkenleri, giriş doğrulama ve kontrol akışları gibi daha gelişmiş özelliklerin nasıl kullanılacağı gösterilmektedir.

Yapılandırma (ön kısım)

---
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}}.

Şablon biçimi, söz dizimi ve örnekler Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Gemini

Hello world

Yanıt oluşturmayı kontrol etme

Model yapılandırması

Düşünme yapılandırması

Güvenlik ayarları

Sistem talimatları

Giriş değişkenleri

Swift

Kotlin

Java

Web

Dart

Unity

Kontrol akışları (döngüler ve koşullar)

Giriş doğrulaması ve şema

Çıkış şeması

Çok formatlı giriş

Imagen (Görüntü üretme)

Temel

Gelişmiş

Şablon biçimi, söz dizimi ve örnekler