All Gemini 1.0 and Gemini 1.5 models are now retired.
To avoid service disruption, update to a newer model (for example, gemini-2.5-flash-lite). Learn more.

หน้านี้ได้รับการแปลโดย Cloud Translation API

รูปแบบ ไวยากรณ์ และตัวอย่างของเทมเพลต

ตัวอย่าง: การใช้เทมเพลตพรอมต์ฝั่งเซิร์ฟเวอร์เป็นฟีเจอร์ที่อยู่ในเวอร์ชันตัวอย่าง ซึ่งหมายความว่าฟีเจอร์นี้ไม่อยู่ภายใต้ SLA หรือนโยบายการเลิกใช้งานใดๆ และอาจมีการเปลี่ยนแปลงในแบบที่เข้ากันไม่ได้กับเวอร์ชันก่อน
ปัจจุบัน Swift, Android และเว็บรองรับเทมเพลต การรองรับ Flutter และ Unity จะพร้อมให้บริการในเร็วๆ นี้

สำหรับ Firebase AI Logic คอนโซล Firebase มี UI ที่แนะนำให้คุณ ระบุเนื้อหาของเทมเพลต

เทมเพลตพรอมต์ของเซิร์ฟเวอร์ใช้ไวยากรณ์และรูปแบบที่อิงตาม Dotprompt ในหน้านี้ คุณจะเห็นคำอธิบายโดยละเอียดเกี่ยวกับรูปแบบและไวยากรณ์ของเทมเพลต พร้อมด้วย ตัวอย่างสำหรับทั้ง Gemini และ Imagen

ต่อไปนี้คือคอมโพเนนต์ที่สำคัญที่สุดสำหรับคำขอตัวอย่างไปยังโมเดล Gemini

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

ส่วนบนภายในขีดสามขีดประกอบด้วยชื่อโมเดล รวมถึง การกำหนดค่าโมเดล การตรวจสอบอินพุต หรือสคีมาที่คุณต้องการ ส่งในคำขอ (ไม่บังคับ) โดยจะเขียนเป็นคู่คีย์-ค่า และมักเรียกว่า frontmatter ของ YAML
เนื้อหาของเทมเพลตมีข้อความแจ้ง นอกจากนี้ คุณยังใส่ คำสั่งของระบบและค่าอินพุต (โดยใช้ไวยากรณ์ Handlebars) ได้ด้วย (ไม่บังคับ)

หน้านี้จะอธิบายรูปแบบและไวยากรณ์ของเทมเพลตโดยละเอียด พร้อมตัวอย่างสำหรับรายการต่อไปนี้

Gemini
Imagen
- พื้นฐาน
- ขั้นสูง

Gemini

ตัวอย่างทั้งหมดในส่วนนี้แสดงเทมเพลตที่ใช้ gemini-2.5-flash แต่คุณสามารถใช้โมเดล Gemini ใดก็ได้ที่ Firebase AI Logic รองรับ (ยกเว้นโมเดล Gemini Live)

Hello world

ตัวอย่างเทมเพลตพรอมต์ของเซิร์ฟเวอร์แบบเรียบง่ายมีดังนี้

การกำหนดค่า (Frontmatter)

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

พรอมต์และคำสั่งของระบบ (หากมี)

Write a story about a magic backpack.

การกำหนดค่าโมเดล

ตั้งค่าการกำหนดค่าโมเดลเพื่อควบคุมวิธีที่โมเดลสร้างคำตอบ เช่น โทเค็นเอาต์พุตสูงสุด อุณหภูมิ Top-K และ Top-P

การกำหนดค่า (Frontmatter)

---
model: 'gemini-2.5-flash'
config:
  candidateCount: 1
  temperature: 0.9
  topP: 0.1
  topK: 16
  maxOutputTokens: 200
  stopSequences: ["red"]
---

พรอมต์และคำสั่งของระบบ (หากมี)

Write a story about a magic backpack.

คำสั่งของระบบ

ตั้งค่าคำสั่งของระบบเพื่อกำหนดลักษณะการทำงานของโมเดล คุณจะรวมไว้เป็นส่วนหนึ่งของพรอมต์ได้โดยทำดังนี้

ระบุวิธีการของระบบโดยใช้ไวยากรณ์ {{role "system"}}
ระบุพรอมต์ข้อความโดยใช้ไวยากรณ์ {{role "user"}}

การกำหนดค่า (Frontmatter)

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

ตัวแปรอินพุต

พรอมต์บางรายการเป็นแบบคงที่ แต่คุณมักจะต้องใส่ข้อมูลบางอย่างจากผู้ใช้ เป็นส่วนหนึ่งของพรอมต์

คุณสามารถรวมตัวแปรอินพุตแบบไดนามิกลงในพรอมต์ได้โดยใช้ นิพจน์ Handlebars ซึ่ง อยู่ในแท็ก {{ }} ในรูปแบบ {{variableName}} หรือ {{object.propertyName}} (เช่น Hello, {{name}} from {{address.city}})

การกำหนดค่า (Frontmatter)

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

พรอมต์และคำสั่งของระบบ (หากมี)

Create an example customer invoice for a customer named {{customerName}}.

คุณระบุค่าเริ่มต้นในเทมเพลตได้ แต่โดยปกติแล้วไคลเอ็นต์จะเป็นผู้ระบุค่าของตัวแปรอินพุต ซึ่งเป็นส่วนหนึ่งของคำขอ

ดูคำขอฝั่งไคลเอ็นต์ที่ระบุค่าอินพุต

คลิกผู้ให้บริการ Gemini API เพื่อดูเนื้อหาและโค้ดเฉพาะของผู้ให้บริการ ในหน้านี้

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.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 = response.result;
const text = response.text();

Dart

ปลั๊กอิน Flutter จะรองรับเทมเพลตพรอมต์ของเซิร์ฟเวอร์ในเร็วๆ นี้

Unity

แพ็กเกจ Unity จะรองรับเทมเพลตพรอมต์ของเซิร์ฟเวอร์ในเร็วๆ นี้

โฟลว์การควบคุม (ลูปและเงื่อนไข)

หากต้องการเขียนพรอมต์ที่ซับซ้อนมากขึ้น คุณสามารถใช้บล็อกแบบมีเงื่อนไข (เช่น #if , else และ #unless) และการวนซ้ำ (#each)

คุณสามารถให้ข้อมูลบริบทเพิ่มเติมเป็นตัวแปรที่มีคำนำหน้าพิเศษ @ ได้ดังนี้

@first: จริงเมื่อทำซ้ำรายการแรกของบล็อก #each
@last: จริงเมื่อวนซ้ำรายการสุดท้ายของบล็อก #each
@index: แสดงตำแหน่งดัชนี (อิงตาม 0) ขององค์ประกอบปัจจุบัน

ดูข้อมูลเกี่ยวกับตัวช่วยเชิงตรรกะในตัวทั้งหมดได้ที่ เอกสารประกอบของ Handlebars

การกำหนดค่า (Frontmatter)

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

พรอมต์และคำสั่งของระบบ (หากมี)

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

โปรดทราบว่าเงื่อนไขยอมรับเฉพาะการอ้างอิงตัวแปร ไม่ยอมรับนิพจน์ประเภทใดก็ตาม เช่น

โดยทำดังนี้ {{#if isVipCustomer}} ... {{/if}}
{{#if customer.type == 'vip'}} ... {{/if}} ไม่ได้ผล

หากตัวแปรเป็นบูลีน เงื่อนไขจะทำงานตามที่คุณคาดไว้ หากตัวแปรไม่ใช่บูลีน เงื่อนไขจะกลายเป็นการตรวจสอบ "is-not-null" ซึ่งอาจมีประโยชน์ในการจัดการอินพุตที่ไม่บังคับ เช่น

{{#if customerName}}
Hello {{customerName}}
{{else}}
Hello Guest
{{/if}}

การตรวจสอบอินพุตและสคีมา

หากคุณมีข้อมูลที่มาจากไคลเอ็นต์ เราขอแนะนำอย่างยิ่งให้ใช้สคีมาอินพุต เพื่อช่วยป้องกันการแทรกพรอมต์ รวมถึงตรวจสอบว่าข้อมูล ที่ส่งในคำขอตรงกับที่คุณคาดหวัง

คุณระบุมูลค่าเริ่มต้นได้ในกรณีที่ไคลเอ็นต์ไม่ได้ระบุมูลค่า
สคีมารองรับประเภทสเกลาร์ string, integer, number, boolean และ object ระบบจะระบุออบเจ็กต์ อาร์เรย์ และ Enum ด้วยวงเล็บหลังชื่อฟิลด์
ระบบจะถือว่าพร็อพเพอร์ตี้ทั้งหมดเป็นพร็อพเพอร์ตี้ที่ต้องระบุ เว้นแต่คุณจะระบุว่าเป็นพร็อพเพอร์ตี้ที่ไม่บังคับด้วย ? เมื่อทำเครื่องหมายพร็อพเพอร์ตี้เป็นไม่บังคับ ระบบจะทำให้พร็อพเพอร์ตี้เป็น Null ได้ด้วยเพื่อให้ LLM มีความยืดหยุ่นมากขึ้นในการแสดงผลเป็น Null แทนที่จะละเว้นฟิลด์

ต่อไปนี้คือตัวอย่างพื้นฐานสำหรับการระบุสคีมาอินพุต ดูสคีมา ขั้นสูงเพิ่มเติมได้ที่ด้านล่าง

การกำหนดค่า (Frontmatter)

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

พรอมต์และคำสั่งของระบบ (หากมี)

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

ดูตัวอย่างที่ซับซ้อนเพิ่มเติมสำหรับการระบุสคีมาอินพุต

การกำหนดค่า (Frontmatter)

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

พรอมต์และคำสั่งของระบบ (หากมี)

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

สคีมาเอาต์พุต

หากต้องการให้โมเดลสร้างเอาต์พุต JSON ที่มีโครงสร้าง คุณก็ระบุสคีมาเอาต์พุตได้ การระบุ format: json จะเป็นการ จำกัดโมเดลให้แสดงผลการตอบกลับเป็น JSON ที่เป็นไปตาม สคีมาที่ระบุเสมอ

สคีมารองรับประเภทสเกลาร์ string, integer, number, boolean และ object ระบบจะระบุออบเจ็กต์ อาร์เรย์ และ Enum ด้วยวงเล็บหลังชื่อฟิลด์
ระบบจะถือว่าพร็อพเพอร์ตี้ทั้งหมดเป็นพร็อพเพอร์ตี้ที่ต้องระบุ เว้นแต่คุณจะระบุว่าเป็นพร็อพเพอร์ตี้ที่ไม่บังคับด้วย ? เมื่อทำเครื่องหมายพร็อพเพอร์ตี้เป็นไม่บังคับ ระบบจะทำให้พร็อพเพอร์ตี้เป็น Null ได้ด้วยเพื่อให้ LLM มีความยืดหยุ่นมากขึ้นในการแสดงผลเป็น Null แทนที่จะละเว้นฟิลด์

ต่อไปนี้คือตัวอย่างพื้นฐานสำหรับการสร้างเอาต์พุต JSON ที่มีโครงสร้าง คุณดูสคีมาขั้นสูงเพิ่มเติมได้ที่ด้านล่าง

การกำหนดค่า (Frontmatter)

---
model: gemini-2.5-flash
output:
  format: json
  schema:
    invoiceId: string
    invoiceFile(object, an invoice file):
      url?: string
      contents: string
      mimeType: string
---

พรอมต์และคำสั่งของระบบ (หากมี)

Create an example customer invoice.

ดูตัวอย่างที่ซับซ้อนเพิ่มเติมสำหรับการสร้างเอาต์พุต JSON ที่มีโครงสร้าง

การกำหนดค่า (Frontmatter)

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

พรอมต์และคำสั่งของระบบ (หากมี)

Store all the specified information about the provided article.

อินพุตหลายรูปแบบ

พรอมต์หลายรูปแบบที่ส่งไปยังโมเดล Gemini สามารถมีอินพุตได้หลายประเภท ซึ่งรวมถึงไฟล์ (เช่น ข้อความพร้อมกับรูปภาพ, PDF, ไฟล์ข้อความธรรมดา, เสียง และวิดีโอ)

ระบุไฟล์โดยใช้ URL ของไฟล์ที่มี{{media url}} ไวยากรณ์
ระบุไฟล์ในบรรทัดด้วยไวยากรณ์ {{media type="mime_type" data="contents"}}

ต่อไปนี้คือตัวอย่างพื้นฐานสำหรับการป้อนข้อมูลแบบมัลติโมดัล ดูตัวอย่างที่ซับซ้อนกว่านี้ได้ที่ด้านล่าง

การกำหนดค่า (Frontmatter)

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

พรอมต์และคำสั่งของระบบ (หากมี)

Describe this image

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

ดูวิธีระบุข้อมูลที่เข้ารหัส Base64 เพื่อทดสอบเทมเพลตในคอนโซล

หากเทมเพลตมีข้อมูลที่เข้ารหัส base64 คุณจะรวมข้อมูลดังกล่าวไว้ในประสบการณ์การทดสอบของFirebaseคอนโซลได้โดยทำดังนี้

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

ดูตัวอย่างที่ซับซ้อนเพิ่มเติมสำหรับการป้อนข้อมูลหลายรูปแบบ

การกำหนดค่า (Frontmatter)

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

พรอมต์และคำสั่งของระบบ (หากมี)

{{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 (การสร้างรูปภาพ)

ในการเปิดตัวครั้งแรก เทมเพลตพรอมต์ของเซิร์ฟเวอร์รองรับการสร้างรูปภาพโดยใช้โมเดล Imagen และพรอมต์ที่เป็นข้อความเท่านั้น โปรดกลับมาดูการสนับสนุนเพิ่มเติมในเร็วๆ นี้ ซึ่งรวมถึง การแก้ไขรูปภาพด้วย Imagen (เมื่อใช้ Vertex AI Gemini API)

พื้นฐาน

ตัวอย่างนี้แสดงเทมเพลตพื้นฐานสำหรับการสร้างรูปภาพด้วย Imagen โดยมีตัวแปรอินพุตและ การตรวจสอบอินพุตที่คล้ายกับ Gemini

การกำหนดค่า (Frontmatter)

---
model: 'imagen-4.0-generate-001'
input:
  schema:
    prompt: 'string'
---

พรอมต์และคำสั่งของระบบ (หากมี)

Create an image containing {{prompt}}

ขั้นสูง

ตัวอย่างนี้แสดงวิธีเพิ่มการกำหนดค่าโมเดลและใช้ฟีเจอร์ขั้นสูงเพิ่มเติมในพรอมต์ เช่น ตัวแปรอินพุต การตรวจสอบอินพุต และโฟลว์การควบคุมที่คล้ายกับ Gemini

การกำหนดค่า (Frontmatter)

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

พรอมต์และคำสั่งของระบบ (หากมี)

A {{style}} of {{subject}}{{#if context}}{{context}}{{/if}}.