The latest Gemini models, like Gemini 3.1 Flash Image (Nano Banana 2), are available to use with Firebase AI Logic! Learn more.

Gemini 2.0 Flash and Flash-Lite models will shut down on June 1, 2026. To avoid service disruption, update to a newer model like gemini-2.5-flash-lite. Learn more.

All Imagen models will shut down on June 24, 2026. Learn about migrating your apps to use Nano Banana.

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

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

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

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

---
model: 'gemini-3-flash-preview'
---

{{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-3-flash-preview แต่คุณสามารถใช้โมเดล Gemini ใดก็ได้ที่ Firebase AI Logic รองรับ (ยกเว้นโมเดล Gemini Live)

สวัสดีชาวโลก

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

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

---
model: 'gemini-3-flash-preview'
---

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

Write a story about a magic backpack.

ควบคุมการสร้างคำตอบ

คุณควบคุมการสร้างคำตอบได้หลายวิธีโดยขึ้นอยู่กับ กรณีการใช้งานและระดับการควบคุมที่ต้องการ

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

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

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

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

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

Write a story about a magic backpack.

การกำหนดค่าการคิด

ระบุการกำหนดค่าที่เกี่ยวข้องกับการคิดสำหรับโมเดล ที่รองรับการคิด

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

Gemini 3 และรุ่นที่ใหม่กว่า (ระดับการคิด)

---
model: 'gemini-3-flash-preview'
config:
  thinkingConfig:
    thinkingLevel: medium
    includeThoughts: true
---

Gemini 2.5 โมเดล (งบประมาณการคิด)

---
model: 'gemini-3-flash-preview'
config:
  thinkingConfig:
    thinkingBudget: 1024
    includeThoughts: true
---

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

Solve x^2 + 4x + 4 = 0

การตั้งค่าความปลอดภัย

ใช้การตั้งค่าความปลอดภัยเพื่อปรับความน่าจะเป็น ในการได้รับคำตอบที่อาจถือว่าเป็นอันตราย

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

ตัวอย่างที่มีการตั้งค่าความปลอดภัย 1 รายการ

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

ตัวอย่างที่มีการตั้งค่าความปลอดภัยหลายรายการ

---
model: 'gemini-3-flash-preview'
config:
  safetySettings:
    - category: HARM_CATEGORY_HARASSMENT
      threshold: BLOCK_ONLY_HIGH
    - category: HARM_CATEGORY_HATE_SPEECH
      threshold: BLOCK_MEDIUM_AND_ABOVE
---

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

Write a story about a magic backpack.

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

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

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

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

---
model: 'gemini-3-flash-preview'
---

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

{{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-3-flash-preview'
---

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

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.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}");
}

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

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

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

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

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

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

---
model: 'gemini-3-flash-preview'
---

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

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-3-flash-preview'
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-3-flash-preview
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-3-flash-preview
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-3-flash-preview
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"}}

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

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

  {
    "mimeType": "image/png",
    "imageData": "iVBORw0KGgoAAAANSUhEUgAAARAAAABcCAYAAACm5+q2AAAXGElEQVR4Ae1dC5QcVZm+OtOBwC6CwiqCCBIQkAWSqpqEkNhdt3uyQeJBgSi4uwoIihtchJgF5TGarpoJicACCkFANuGBBhcQH5DMJAH0CCjIQ1hYfBAeZPoRkklVdR6ZZHrvt+a4pLdn5r/Vdbuqh/udc0/nMdPTZ+rWV//9/+//fhYHZnat2yvtVEzueqdx159ju8Fltus73PF7xN/ni79fIta52e5gVtr1j053VXdnGhoa70ykezYfzJ3KedwN7rJd/8/itSqzMnlvu3h9Xnzvzdz1/ynd5e3LNDQ0xi7SCyoHcjf4ZiYfPAsSiHTlvSHxvqtsJzi7c9HQnkxDQ2NsgLvedNvx78u43g7c7KqXIJIB7voLpzvB/ixh0NAwf3hqdbTFGNOw8xun8nzwsCqiIEQlm2zXX4D8CtPQ0ATSGshdWfmgII4f4SZOxHK8fiRnmYaGJpAEo1p9F3eCM3GEwI2btAVSS3dt2JtpaGgCSRZwTOBusAw3aqJX3n8l2xNMZBoamkCSgdz8jYdxN3gpCQRBz414pzANDU0giUiUrldxk2fcoGi73muZfFDI5L0tUZd9oUNhGhqaQOJBxvWzGderRJCb+L14vZa7/ul2T3DsrK7qHvXyK9N6BvbhTqUDilTb9W8TP/uNsD8TJWUI0JiGhiaQ5iOb9zOIEsLewFCf2k5wORSpjSRt005liiCyGzN5P9DkoaEJpAXAXf+YjBtsDCnyesHO+2eIXpZ2FiEQndiu/y3uBr4mDw1NIAlFZ5f/d8hLhCAPnzv+10AccWlQNHloaAKJEbOXVdtsN1gtH3X4v84t2HRQk49YnxVE4mny0NAEkhBwJ7hUPlkZXG/cVE2xGJDt3nh4Jh/8tyYPDU0gCch78Ly3TSpR6gTfQKKTxQi0+cNDhGloaAKJB11d1Xdz139MkjzmMQ0NDU0gggw+L3lsuYYeeWhojFloApl57dBu3PXWSJRpVyHZyjQ0NDSBcCc4R4I81qGMyjQ0NDSBIPch0yQnkpVfYICGhoYmEPS6yGg9QDgM0NDQ0ATC88GdVAJBbwwDNDQ0NIGgI5baaZtx/Sd01aV1oKEJpNrF3o3FVAHiK2r0QVN5alTT6fZ13OgoZs15xax1d4Ebvy1ljULJtiqFrDWEV/wd/y7+/66ibX69nDUtfF8iPv9q1r6tr71jW2/7vG0r2u8e7Ev9duuKVGFrX6oi/lwVfx4UqzzY2/aM+LofiXWx+Nrj8X0sAcAwMu4EJ8Jo23aDXrjToaP8r3OG8kEJD0N0d4uv+czUK8t/2+oE0t95zJ6lrDVLrEUlbvSJ1zVij20Wr9W/LGOT2Hd/KtnGg0Vu5stZIxPJfoMEndgaX0l3Ff+GDQuNUtacKC7Wd0vcKuGiSS/bLIrX64ud1nEsBmxdnjpusDd1vSCKIohCdonvWze4IrVYvE5iMQAWltz1b0VDZwhX/5vT3QMTavqscpTvj4tAqoy9q9hpnCAI4U4QRLj9Zl65jk85oIHyrfcM1aiYadRF0TanCnbvxUWJcK0o5DqmsCYA0YOIKFbQyYJEJqu3LW8/gTUB9nz/Y9zxft64g503iDlDU64aGp90AunPTJpcyBqPRLLXbGuLIJIFiGLC5D920CTrlS8xjV3wZtrYV1yA23ERFK6lb2St9yk6quwryGMpbnhVS7z/XUO/YPupEz/63TiWRDwe5Bl0lSeRQN6cZeyBKFfJXrONP0s9tLLdFYv6S0273hFM468o2x28wK21+MWrXuJJ80YpZ6ZZhBD5i4zIXbyJm1z1Qv5ksK/NZhECNzh3vCdVGXLDCweWmkkikGJ64gRxVHle7V6zthW5dSajwHb9zxFDu83/p/3QKHHrnIJtbMcvvFkLP69om2dFkuvoTZ0tjhjbcXM3a+HnCcL6clS5Dhhwx+P2r4BA6Pm1cvP2nHEhgUCCS2hsHDzHNABW5tZc/IJjW9z8WoP5jgtxQ8e1BInMbbDlYhJ3gw3Yl+8UAunvNI8uZM31Td9rOevc0QjkKlr+w/8pU4y4N8E019tv9Mij44v4xca9ilkrVCvB1pWps3ATx70QAYUbLTJwKHeDMq7XO4VAimnrA+II+3oc+wxRb5l32CO07/u3ECOQO8Y6gWS7Nx3PRgCSS+JCDjYQEhbEjf9E0bZW4xUltEbOqdCNSEUeq9oni1zEtgaOIGvF62Pi5l+JV/Fe/Q3kRLZtW9k+lUmgc9HQntwNng97fdEACu2H+PNKeN5gjnLSCQQCsGLWXBlyv20qcOth8f03F7h5rdhv/1Hi5mPYO7L7du3M4/YbroS7lCggu2msE8hIQ7nXzezYq2hbr8ofN4ynxQX8l/U5o65P7Fp74oeL3JwjzrfPhtggr5SnTiUJoEQVZC8hCFsjfbP3pp5E3mKob/wBdd939fgDxft+RSRIn5Z9b3wefC66V42/WJ40vFdxTIflZT0FNUaNcNefi9EjSSQQ7I0Q5PG42E+ffW3KlPHD7WUcTSAqo7+nuWyYm9ZbQpztcvPYJ5DKsAk+MLhc6Ge9VuAdn4LQhywIypqnotoidZSxzatoFZfUNZJ5ilcH+8Z9slqlfX58nfj6TwtSeF2SSK6jiR29tOQwsQomA1A9evF1IBJMRUwKgUAiULCNjfS9YLxVso0zqHvulXR6d5lycNHumFEnAvG/TyKQfHD3mD/C5P2L6jJ2bvKRghB2SNTSHxyYNm0fFgLQe0CQJnVGtc2PshGwZcW4I8XxY4fEUeVn1V72HhYCQw+x94ojznKZysyWh8YdMarVxE6xI3H9EZKDsAlaVHeSQCCQpEtEo88jyg1ZUVxIjEKexZGqNiy8kpZE9R4c8xGIE1w8zIVcKnEh760aRoo1gOrso8YVs9ZPJH7mbWwEiGhiicSx4p5G+1mqT7KUeJ/7JKKdEfNrGcc7VYY8pjvB/qwBgHwybvBW0wmk9piRtXxiFPpfiFYa6dvCUZvysxBV1zqwzyUmUV8e6wRidwdfZzUo5yZ+kKr3KGTNJxEWMgJoakPjGaLIbBCZ+roRwYNsf7LeY0XqCZGT2I1FgKFfs/EiL/I7ahQytGL8sO528J8htlp4yHWwCCD2wow4CaTMjS8THyA+xGXhH1az29CAV7Ct39HIylodkt29QZwTx3YOxJ/DaoAuWeIvdqt4PZxFiH7b+hjIoRFtCDQXxJt4izjqHMYixJa+cUdRqz7o+q0fDfhH05WjwbksQqApLy4CKWTNR4nX/QIWAqiqFLl1MRLxsklaHJnDXaCeisEUAv0MKhZ6fcJaFQhi+A1Nl2F+hykAOnOJG+kxVgeIKohHiYVMAZAkpUY/9XMSfp5Yon02aqU0dyoHiL2ztdkEgvwZJeeGhDuOuzKdu5AioHcLD7zR3p+UuEdUQc88+3NZ6wEb4dPEI8wuWeYN6WP3Jl7IQRx1mAKgzEv6DEim1pR0kQilJE/h7YGjDlOAau/uBxE/w1D1l2yfOtWXp4gJ8H9kCmDng9ubTSBlbn6S+NDoovqEoPWCekwhPCxX1doZ/orYobi89cd00psFxQU6kVp1YQqBC0a6sDnrH3Z9+redSK26MIUQ799L05y0zWRvA7xniNGjj/Z7Fj2QC/lEswmkmLW+TUtoTj5mlOj1cPFe1wjiGGiUNBCxFG3jDthWIJKprcS4RFHOdkzsb0HD6HsJuoEdcLEK0/MiLtJXFRPIvBB5EPS8XESsgsxhCoE8DPFz/NuuT/+NU4mR8f0q7T4x5rWJBIIb/x5K8hQl1XoVFVRK4CUTkZx9jXgwXdLfefzw9z13vekSicYLWAsB6kNKXR+Dues8CRZTfsmqTX9KtvVxIoHcUJP/WEy8cTsUE8h0Yh5kccgpid9kCgENSjMJBDaXhNL9M7t+z+T3l7h1KQSMEbTzD4n1C1RnUKWh+Ee2Z9ygSBzp8Cd8PWsR2D3BscRNeFcdgc2PKb9wWg0+PGA3R7z499TcuD+m3LgQfzGFQH6FqEG5r+boeTHtaO3PVnwE/s/mRiDGK5Q8BI4SJd4xHZ67hP4WkpIVorKiPenQML+k68jVmLx/RuvM+vW/TdyE5/9/AjEfovziCSzdENDTECIXg9zDQ5QbV6VjN1BdxsYRczG9NV41DjEqtplCoI2jmQRC8dP930jDtp6L6JjyeDHb8XnsM+VPaiw0HiFf0CLT9v5I1LkcxWoAZ2sSgSi+AaFsJTbu9dUQSB+l+sEAtQTSRuzQXVVTwu2hPdC8jyvOod3YTAJpjmmQsbnArVvL9mQjQh1G8KiE8OoKlnBQM+iw/EeupM6T4H6SsAblU4VAfwyxV+G+miPM/aQjzHK2J1MIlGeJHiE/r4mKu4jl908whUApt5kEotD7A+X+l+E0Bq1JrPNhILCBrVyik6fwfqCFwAvrNxmZSygXBYpRtfaJkybRe2Lke2DQbKd8VAQtmbukRgk6p9Eu6ogerKuaSSDUvhTqgo4ID5cCNzrVRsu46RzvNxLS4ZcJA3liAVSl5C7c+f7fD0MgV9Dq8aaaYVvyLmiX1RDIFZQbd/vK1BmKdSBnEtWw80M+0L6n8p7AEKpmEgihkZJuYMXN/FszzA+xZgFzbyVNeB4i9Mg0FekFlQOp3ZQQ0Q1/45qnEy/WD5hCYGgQ0b/yM+xt2N6XOp1WPm27RXEZ9w7K58Dn3cWBLL/5EOI+fIkpQm6+d2SThWTYdz0NOvg/AkMhmsxdATBASnKGxtLZy6ptLAGAelGQ2m/JRzGncvKwEuD05IOJXbjrw3ThUmXI1Lbu2ifN5tW7HUysfrwlWviVfH7kV0Ry1KN8js3Ldzuk9ulPlRegCMAUABqTpitRc+YpIYjDL3HrezBfjv8mXBh8QJDIeslu1mUY8sNixMyudXtxN3hEInp6erQGLGq3YjlrfklRM92/EjfQH+o7sLe9QiSRcxRNvPsq5efjc9ZzP+P54E5iHutWBfN121FxbDaBIGkOMRdR9PVSMWt9hZDIby4wcFi6HT4fPAzyYTFgRn7Th0AIkg5kOTYK0EtATFS9WUwfFencYOEw9R6JGbuLGrEyhBWhiEIi/fxo5sNAKaL36jXDqKRPo7ZZoBQfcRXvrJja+aE+/iXlukPsyCRBc4G3jo8iEXlTiJGA/bgxm1yunUFJdNEtGuUrIFhFbkVqPI0qkIRf5bHDJDAnSfiT3hDx5LvbJKwNJw03ZZ+cz3L8x6PKx2HEB/ZUCxgKQUAYWRkbvTRwgd/ZAb6oIXEZjiRkN6g6YyBURyPCfep9oUjO9damu7x9qR4K8NogJ7C4dV5E5HEB3fnd+tXIZsepxyTGLZwb9dGFsOp6mdAFZTXTA6DpkUeNxUWwIk5HMhxJqIbKiFIJfqg0Y29ufL/2iIRer0aZ+A9hSATO2BhcBY/KaM+mG/a2neAbtXkaaqiLSpNkHmKWTCMSunNxMcJeRPE+F0kOmZo5SiQwS4JAhjCmgYUECEt68t3KthGfoOgAx14iP7yc4LtI6ocf1h0sS4CpMo7PrsSD68VGPGmgdhaRxy3D6UjQIyNZKKgppzne6w3MWxlEyzXsE1ElYSEwu6s6DkcV7vg/qN1MUsupnBeKmQmeHDXrdiTDpG3mbOuHctPUrd7RyAo3NWTikmMdlkBBGmLS/12SE+pWUkZHCFK4XPJar7Tzmz4sN29380foEbd6AoGhVck21kmUb19Hcx2TBJrnEMVSSCp0NJLuHpjAXW9NBMObBqG9gPrTdoKzc3lvGox8YB+HIwmiFXv+xo/CYgDt3AhfbTfopZAG4Vh1GQuJ8gzjCFkbuJ2zTC8f7cmAblu4S4noZYMkeWyh+rBidILIM2yVnET3liCSSwUxjHgUhSEyRGuCpDZIvv9WfC5GAHIhPB+8KJfU9zZxx1uEB+BoCXhMJ8DXJ2+wlHWmbEkXuiHk7vBgGW1Pi313ncy+RjQiiOrk0AItDNlO0kzSZvbuFLlxflh/hZ3eqtfDpAh5ErxiqA+8H2pKduSFRJukoOv8kCMtd4gqyePwN4VJESbV4VX82/XwMsWxJ8z7Ik/CJABP3lqPUpmSPXeCG+C8D+m77foXcje4Fu0OgjiGkjraEiRQ05NFXjsnzy2FQhmlXuw7mAPhqFLMGi+EfM/nMDGAhQWk69zxf9IqxIHNYbs+baMSjjKwdUvCcG3MOcXnkc1PkFSh6hfIYyk+Twhh1xdxXd9Jw7XR+IYmuLj3HJK1/Z0dh0TSJm87wTyC1VusK+MGGzNOcBKLEJAHE3xClK4CN3+GpFdYbw74hMQ8mX855s8o8HhpYQIh5CmyRn9cew4VoXLOMqN2appEsHuLZaEp0M4PHMoUACEcIaxUtIx7G6nNA9UH2B5o9Y8p8ngAQ6cabnBz/fnvJAIBMI8FidI4Ig+6b0iImjlmymbywUBCjiybYIWn2nYRLmRFbl3d5Au5ED83QpOfq5tKIL2p7xDGZpKBQVIqo2DkW1ASjp1AahLuyKc1cc/9vpA1P8JUA8IsVFZwA8dzXIH9v7cEGXXWRJSyHScpDi1RPluLERNMAUQn7kkiCdqvkjjw/pj0r0ZMWLFgK6FgP1VgVARVdZIIBHh55oTd8DBBRUQteZg3EBKm0RMJyqW2673WrIgD6kOUflmTUTMIeRHKqlHbzpWy5pWqG6VEPmIvER0swnjLSIkD74eoA5P+FQIzYWzX/1ZUD6+/VBr9Y5gAhUCQqFdCIIQ2iwK3Ho6aOBDhFHPGNBYnoASE8Mt2/Fu4G5QjJo1t8CHhTnBObsF6hZtTvgmpxK1uRCSNRhzFrOnUzOJQDug9xI3f3WhEsrOBrgf6kGZ3kUPPUdM7Q14Y/4GxJRAtvq0frJNy1FFGIITKYDlrZJCTG2UIPMlTF6prvGfizI0RaiJXYjvBPTCAgaRcooa/xna8BzkSZ05wIkHNGiuQpxDnxhxyJIWs9dRoA7Lx/5jsj5mjhZyVVe3yTsqP9LblkCMRR5ynMPpytOn6Ygre0yLa+Hfx2ll9kqWYIpBFZ27lU1Atw+92FNJYB/8bjIYAcYSx+cR7sAQADxyMsBRR6zJisrWMih4GktF7aRICJF+hEEw7lSk4a9qudwosBDDHVly0mZnuymRIi2PwGFHiql5MT5xQtjs4VHwl2zgDr/g7/h0dkCzBACEIc6IJomeFD/aOO3n7itTntq8cNxskAyUpSsMswZjWM7APHmAgA+wx7LWM66VzCzYdNErjHQjkC/ShZMkCpPCCTCaiV6rIjdPgWIcIoz8zaTKiZcWRhoaGBhTMBAJZxWqhoaGhgSP3aASCPB9rPWhoaCC/BkGjqveGJ+sYmxetoaExo2vgvdz152LyIMqoKsr46AgnakZOYBoaGskHOnI5qiuut3nXm9h/AAnRZk8ngPYkwYl+DQ0NlGXhDTPapEF8TWQ/06mYiGwI+Y+fMg0NjeQCvh1EvdBmyAJYg4BlRSYfvECcy/vPTENDI7nIzd94GFV4iKbORqb1Q6QIBzyiyHHDrK7qHkxDQyPZyLj+jVKtDiE6sjHdTsZxz3Z8l7UGNDR01QUlVclBZy9iOBSiipF6tuDLizEk6OiW6JsZwGdirQENDQ1I0cP6eogb/lHb8Rfbru8gckBEwx1vebjGOyx/DmstaGhogADiNq1CjgQiM9aK0NDQylNvaVzkge5eDLpiGhoaSQVhan4+uL3p5IG5z90bD2etDw0NHYkgl9FEAnmJYNLdStDQ0MDYDjiJqT22BHcqc77T0NCI3zCIO8F1UTu0Q40Ksys29qGhoQGHMe4EV6M028gkQ54P+uBaRpjwP9agoaEBb1PYYgoiuYY7/uMjDWbP5L0tUJ/arn8bRGcwZmYaGhoab59kh9Jr2vWP5k6lA/6o3PWO4q7/fq3naDVoaGhoaGhoaPwP1Ihp8Bm98aYAAAAASUVORK5CYII="
  }

ตัวอย่างพื้นฐาน (อินพุตหลายรูปแบบ)

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

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

---
model: 'gemini-3-flash-preview'
---

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

Describe this image

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

ตัวอย่างที่ซับซ้อน (อินพุตหลายรูปแบบ)

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

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

---
model: gemini-3-flash-preview
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}}

การใช้เครื่องมือ

เทมเพลตพรอมต์ของเซิร์ฟเวอร์รองรับเครื่องมือต่อไปนี้ ระบบยังไม่รองรับการเรียกใช้ฟังก์ชัน แต่จะรองรับเร็วๆ นี้

การดำเนินการโค้ด
บริบทของ URL
การเชื่อมต่อแหล่งข้อมูลกับ Google Search

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

การดำเนินการโค้ด

เครื่องมือการเรียกใช้โค้ดช่วยให้โมเดลสามารถสร้างและเรียกใช้โค้ด Python ได้

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

---
model: 'gemini-3-flash-preview'
tools:
  - codeExecution
---

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

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

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

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

---
model: 'gemini-3-flash-preview'
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
---

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

Compare the ingredients and cooking times from the recipes at {{url1}} and {{url2}}

การเชื่อมต่อแหล่งข้อมูลกับ Google Search

เครื่องมือการเชื่อมต่อแหล่งข้อมูลด้วย Google Search เชื่อมต่อโมเดลกับเนื้อหาบนเว็บแบบเรียลไทม์ที่เผยแพร่ต่อสาธารณะ

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

---
model: 'gemini-3-flash-preview'
tools:
  - googleSearch
---

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

Who won the Euro 2024?

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

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

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