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 คุณจะส่งข้อมูลทั้งหมดนี้จาก โค้ดฝั่งไคลเอ็นต์ได้โดยตรง หรือจะระบุข้อมูลนี้ฝั่งเซิร์ฟเวอร์โดยใช้ เทมเพลตข้อความแจ้งของเซิร์ฟเวอร์ก็ได้

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

เมื่อใช้เทมเพลตข้อความแจ้งของเซิร์ฟเวอร์ คุณจะจัดเก็บข้อความแจ้งและการกำหนดค่าไว้ฝั่งเซิร์ฟเวอร์ และระบุเฉพาะคีย์ (รหัสเทมเพลต) ในฐานของโค้ดของแอป ข้อดีบางประการของแนวทางนี้มีดังนี้

ป้องกันการเปิดเผยข้อความแจ้งฝั่งไคลเอ็นต์
อัปเดตข้อความแจ้งและการกำหนดค่าโดยไม่ต้องเผยแพร่แอปเวอร์ชันใหม่

คู่มือนี้จะอธิบายวิธีเริ่มต้นใช้งานเทมเพลตข้อความแจ้งของเซิร์ฟเวอร์

ข้ามไปที่ภาพรวมระดับสูง ข้ามไปที่วิธีการโดยละเอียด

โมเดลและความสามารถที่รองรับ

ใช้เทมเพลตข้อความแจ้งของเซิร์ฟเวอร์กับโมเดล Gemini และ Imagen ที่ ที่ Firebase AI Logic รองรับ ยกเว้นโมเดล Gemini Live
ดูรายการฟีเจอร์ที่ยังไม่รองรับ

ภาพรวมระดับสูง

เวิร์กโฟลว์พื้นฐานสำหรับการใช้เทมเพลตข้อความแจ้งของเซิร์ฟเวอร์มีดังนี้

สร้างเทมเพลตโดยใช้ UI ที่แนะนำใน Firebase คอนโซล
ทดสอบเทมเพลตในคำขอจริงโดยใช้ประสบการณ์การทดสอบใน Firebase คอนโซล
เข้าถึงเทมเพลตจากโค้ดของแอปโดยใช้ templateGenerativeModel

รูปแบบพื้นฐานของเทมเพลตข้อความแจ้งของเซิร์ฟเวอร์

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

เทมเพลตข้อความแจ้งของเซิร์ฟเวอร์ใช้ไวยากรณ์และรูปแบบที่อิงตาม Dotprompt ดูรายละเอียดเพิ่มเติมได้ที่ รูปแบบ ไวยากรณ์ และตัวอย่างของเทมเพลต

เทมเพลตตัวอย่างด้านล่างแสดงคอมโพเนนต์ที่สำคัญที่สุดของเทมเพลตสำหรับ คำขอตัวอย่างที่ส่งไปยังโมเดล 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}}.

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

ใช้เทมเพลตในโค้ด

คลิกผู้ให้บริการ 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}");
}

วิธีการโดยละเอียด

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

ก่อนเริ่มต้น

หากยังไม่ได้ทำ ให้ทำตามคู่มือเริ่มต้นใช้งาน ซึ่ง อธิบายวิธีตั้งค่าโปรเจ็กต์ Firebase, เชื่อมต่อแอปกับ Firebase, เพิ่ม SDK, เริ่มต้นบริการแบ็กเอนด์สำหรับ Gemini API ที่คุณเลือก และสร้างอินสแตนซ์ GenerativeModel
ตรวจสอบว่าคุณมีสิทธิ์ที่จำเป็น ในการสร้างและจัดการเทมเพลตข้อความแจ้งของเซิร์ฟเวอร์ โดยค่าเริ่มต้น สิทธิ์ทั้งหมดนี้จะรวมอยู่ในบทบาทเจ้าของ
ดูสิทธิ์ที่จำเป็น
- firebasevertexai.googleapis.com/promptTemplates.create
- firebasevertexai.googleapis.com/promptTemplates.get
- firebasevertexai.googleapis.com/promptTemplates.update
- firebasevertexai.googleapis.com/promptTemplates.delete
- firebasevertexai.googleapis.com/promptTemplates.list
หากคุณใช้ Vertex AI Gemini API และ กรณีการใช้งานของคุณต้องมี ข้อจำกัดตามสถานที่ตั้ง เราจะรองรับ เวิร์กโฟลว์ขั้นสูงสำหรับเทมเพลต

ขั้นตอนที่ 1: สร้างเทมเพลตข้อความแจ้งของเซิร์ฟเวอร์

สำหรับกรณีการใช้งานส่วนใหญ่ คุณจะสร้างและจัดการเทมเพลตข้อความแจ้งของเซิร์ฟเวอร์ใน Firebase คอนโซล

ในคอนโซล Firebase ให้ไปที่แท็บ บริการ AI > ตรรกะ AI > เทมเพลตข้อความแจ้ง
คลิกสร้างเทมเพลตใหม่ แล้วเลือกตัวเลือกเทมเพลตเริ่มต้น
- เทมเพลตเริ่มต้นเหล่านี้มีรูปแบบและไวยากรณ์สำหรับกรณีการใช้งานที่พบบ่อยบางกรณี อย่างไรก็ตาม ไม่ว่าคุณจะเลือกตัวเลือกใด คุณก็สามารถเปลี่ยนเทมเพลตได้อย่างสมบูรณ์เพื่อให้ตรงกับความต้องการ
- คู่มือเริ่มต้นใช้งานนี้จะถือว่าคุณเลือกตัวเลือก Input + System Instructions
ป้อนตัวระบุของเทมเพลต
- ชื่อเทมเพลต: นี่คือชื่อที่แสดงของเทมเพลต (เช่น My First Template) ซึ่งจะแสดงเฉพาะในอินเทอร์เฟซ Firebase เช่น คอนโซล Firebase
- รหัสเทมเพลต: นี่ต้องเป็นรหัสที่ไม่ซ้ำกันของเทมเพลตภายใน โปรเจ็กต์ Firebase (เช่น my-first-template-v1-0-0) คุณจะอ้างอิง รหัสนี้ในคำขอจากแอป
  - เราขอแนะนำให้ใช้ระบบการกำหนดเวอร์ชันสำหรับรหัสเทมเพลต
  - รหัสเทมเพลตมีความยาวได้สูงสุด 63 อักขระ และมีตัวอักษรพิมพ์เล็ก ตัวเลข และขีดกลางได้
แก้ไขส่วนการกำหนดค่า (ข้อมูลเมตา) ของเทมเพลตตามที่จำเป็น
- ส่วนนี้ต้องมีชื่อโมเดลอย่างน้อย 1 ชื่อ เช่น
```
---
model: 'gemini-3-flash-preview'
---
```
- นอกจากนี้ คุณยังระบุการกำหนดค่าของโมเดล รวมถึงการควบคุมอินพุต & เอาต์พุต ฯลฯ ได้ด้วย (ไม่บังคับ) ดูรายละเอียดและตัวเลือกเพิ่มเติมได้ที่ รูปแบบ ไวยากรณ์ และตัวอย่างของเทมเพลต
แก้ไขส่วนข้อความแจ้งและ (หากมี) คำแนะนำของระบบ ของเทมเพลตตามที่จำเป็น
- ส่วนนี้ต้องมีข้อความแจ้งอย่างน้อย 1 รายการเพื่อส่งไปยังโมเดล
```
Write a story about a magic backpack.
```
- นอกจากนี้ คุณยังสร้างข้อความแจ้งที่ซับซ้อนมากขึ้นได้ เช่น ตัวเลือกต่อไปนี้ ดูรายละเอียดและตัวเลือกเพิ่มเติมได้ที่ รูปแบบ ไวยากรณ์ และตัวอย่างของเทมเพลต
  - (ไม่บังคับและหากมี) ระบุคำแนะนำของระบบโดยใช้ {{role "system"}} ไวยากรณ์ และข้อความ แจ้งโดยใช้ {{role "user"}} ไวยากรณ์
  - (ไม่บังคับ) ระบุตัวแปรอินพุตโดยใช้ ไวยากรณ์ Handlebars (เช่น {{customerName}}) คุณสามารถระบุ ค่าเริ่มต้นในเทมเพลตได้ แต่โดยปกติแล้วระบบจะส่งค่าของตัวแปรอินพุตนี้ ในคำขอ
```
{{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}}.
```

ขั้นตอนที่ 2: ทดสอบเทมเพลตในคอนโซล Firebase

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

คลิกบันทึกเทมเพลต เพื่อให้คุณทดสอบเทมเพลตได้

คุณสามารถแก้ไขหรือลบเทมเพลตได้ทุกเมื่อ ค่าเดียวที่คุณเปลี่ยนไม่ได้ในภายหลังคือรหัสเทมเพลต
หากข้อความแจ้งใช้ตัวแปรอินพุต ให้ใส่ค่าทดสอบในช่องทดสอบอินพุต เช่น
```
  {
    "customerName": "Jane"
  }
```
หากคุณเปิดใช้ผู้ให้บริการ Gemini API หลายรายในโปรเจ็กต์ Firebase คุณสามารถเลือกผู้ให้บริการที่จะใช้สำหรับคำขอทดสอบได้ หากตัวเลือกนี้แสดงในคอนโซล ให้เลือก Gemini Developer API หรือ Vertex AI Gemini API

โปรดทราบว่าการเลือกนี้ใช้ได้กับคำขอที่ส่งผ่าน Firebaseประสบการณ์การทดสอบในคอนโซลเท่านั้น ในคำขอจริงจากแอป คุณจะระบุผู้ให้บริการ Gemini API ที่เลือกไว้เช่นเดียวกับคำขออื่นๆ
คลิกปุ่มสร้างคำขอทดสอบที่จัดรูปแบบแล้ว

ตรวจสอบ คำขอทดสอบที่จัดรูปแบบแล้ว ที่ได้ในด้านขวาของหน้าจอ และทำซ้ำในช่องใดก็ได้ของเทมเพลต
ขยายเพื่อดูตัวอย่างคำขอทดสอบที่จัดรูปแบบแล้ว
```
{
  "model": "projects/YOUR_PROJECT_ID/models/gemini-3-flash-preview",
  "contents": [{
    "parts": [{
      "text": "Create an example customer invoice for a customer named Jane"
    }],
    "role": "user"
  }],
  "systemInstruction": {
    "parts": [{
      "text": "All output must be a clearly structured invoice document.\nUse a tabular or clearly delineated list format for line items."
    }]
  }
}
```

เมื่อพอใจกับคำขอทดสอบที่จัดรูปแบบแล้ว ให้คลิกปุ่มเรียกใช้การทดสอบข้อความแจ้ง

ตรวจสอบ การตอบสนองการทดสอบ ที่ได้ในด้านขวาของหน้าจอ และทำซ้ำในช่องใดก็ได้ของเทมเพลต

ขยายเพื่อดูตัวอย่างการตอบสนองการทดสอบ

{
  "candidates": [{
    "content": {
      "parts": [{
        "text": "```\n--------------------------------------------------------------------------------\n                         **INVOICE**\n--------------------------------------------------------------------------------\n\n**Creative Solutions Inc.**\n123 Business Lane, Suite 100\nAnytown, USA 12345\nPhone: (555) 123-4567\nEmail: info@creativesolutions.com\n\n**INVOICE NO:** INV-2023-001\n**INVOICE DATE:** October 26, 2023\n**DUE DATE:** November 25, 2023\n\n**BILL TO:**\nJane\n456 Client Street, Apt 2B\nAnytown, USA 12346\nPhone: (555) 987-6543\nEmail: jane@example.com\n\n--------------------------------------------------------------------------------\n**ITEM DESCRIPTION**               **QTY**   **UNIT PRICE**   **AMOUNT**\n--------------------------------------------------------------------------------\nWebsite Design Services            1         $800.00          $800.00\nContent Creation (Blog Posts)      4         $120.00          $480.00\nMonthly Hosting \u0026 Maintenance      1         $50.00           $50.00\nConsultation Fee                   2         $75.00           $150.00\n--------------------------------------------------------------------------------\n\n**SUMMARY:**\nSubtotal:                                                     $1,480.00\nSales Tax (8%):                                               $118.40\n--------------------------------------------------------------------------------\n**TOTAL DUE:**                                                **$1,598.40**\n--------------------------------------------------------------------------------\n\n**PAYMENT TERMS:**\nPayment is due within 30 days of the invoice date. Please make checks payable to Creative Solutions Inc. For electronic payments, please contact us for details.\n\nThank you for your business!\n```"
      }],
      "role": "model"
    },
    "finishReason": "STOP",
    "index": 0
  }],
  "usageMetadata": {
    "promptTokenCount": 34,
    "candidatesTokenCount": 418,
    "totalTokenCount": 890,
    "promptTokensDetails": [{
      "modality": "TEXT",
      "tokenCount": 34
    }],
    "thoughtsTokenCount": 438
  },
  "modelVersion": "gemini-3-flash-preview",
  "responseId": "3w4Vad6yF-y1vdIP_q_zgAw",
  "turnToken": "v1:ChczdzRWYWQ2eUYteTF2ZElQX3FfemdBdxIXM3c0VmFkNnlGLXkxdmRJUF9xX3pnQXc"
}

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

ขั้นตอนที่ 3: เข้าถึงเทมเพลตจากโค้ด

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

ใช้ templateGenerativeModel (หรือ templateImagenModel ตามความเหมาะสม)
ระบุรหัสเทมเพลต
ระบุค่าของอินพุตตัวแปรที่เทมเพลตกำหนด

โปรดทราบว่าหลังจากสร้างหรืออัปเดตเทมเพลต คุณอาจต้องรอ 2-3 นาทีก่อนที่เทมเพลตจะเผยแพร่ไปยังเซิร์ฟเวอร์ Firebase ทั้งหมดก่อนที่จะเข้าถึงเทมเพลตจากโค้ด