Ş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ı bir 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

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.


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.


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 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}} (örneğin, Hello, {{name}} from {{address.city}}) biçiminde 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.


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şulların 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 değeri ise koşullu ifade beklendiği gibi çalışır. Değişken bir boolean değilse koşullu ifade, "null değil" kontrolü olarak değerlendirilir. 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 isteme yerleştirme 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}}


Çıkış şeması

Modelin yapılandırılmış JSON çıkışı oluşturmasını istiyorsanız bir çıkış şeması belirtebilirsiniz. format: json değerini 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.


Çok formatlı giriş

Bir Gemini modeline gönderilen çok formatlı istemler, dosyalar (ör. resimlerle birlikte metin, PDF'ler, 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 bir satır içi 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"}}


Imagen (Görüntü üretme)

İlk sürümde, sunucu istemi şablonları Imagen modelleri ve yalnızca metin içeren bir istem 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ının nasıl ekleneceği ve istemde Gemini'a 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
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}}.