เวิร์กโฟลว์ขั้นสูงสำหรับเทมเพลต

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

• ตั้งค่าตำแหน่งที่เฉพาะเจาะจงสำหรับเทมเพลต

• ระบุเทมเพลตเป็นไฟล์

เวิร์กโฟลว์ขั้นสูงที่อธิบายไว้ในหน้านี้ใช้ Firebase AI Logic REST API

ข้อมูลสำคัญเกี่ยวกับการใช้ REST API

• หากเทมเพลตปลดล็อกอยู่ คุณสามารถเขียนทับเทมเพลตได้โดยใช้รหัสเทมเพลตเดียวกันในการเรียก REST API แต่คุณจะเขียนทับเทมเพลตที่ล็อกไม่ได้

• เมื่อคุณ สร้างเทมเพลตพรอมต์ของเซิร์ฟเวอร์ผ่าน REST API และ ตั้งค่าตำแหน่งเป็น global ระบบจะจัดสรรเทมเพลตพรอมต์ของเซิร์ฟเวอร์ใน ทุกตำแหน่ง (รวมถึง global) โดยอัตโนมัติ และคุณจะใช้เทมเพลตนี้กับผู้ให้บริการ Gemini API ทั้งสองรายได้ อย่างไรก็ตาม หากคุณตั้งค่าตำแหน่งอื่นเมื่อสร้างเทมเพลตผ่าน REST API คุณจะใช้เทมเพลตนี้ได้กับ Agent Platform Gemini API (formerly Vertex AI) เท่านั้น ดูข้อมูลเพิ่มเติมเกี่ยวกับ การตั้งค่าตำแหน่งที่เฉพาะเจาะจงสำหรับเทมเพลต ในส่วนท้ายของหน้านี้

  โปรดทราบว่าเมื่อคุณใช้ UI ที่แนะนำในคอนโซล Firebase ระบบจะจัดสรรเทมเพลต ใน ทุกตำแหน่ง (รวมถึง global) โดยอัตโนมัติ และคุณจะใช้เทมเพลตนี้กับผู้ให้บริการ ทั้งสองราย Gemini API ได้

• หากต้องการเข้าถึงเทมเพลตพรอมต์ของเซิร์ฟเวอร์ในคำขอ templateGenerateContent หรือ templateStreamGenerateContent ผ่าน REST API คุณต้องใช้ ปลายทางที่เฉพาะเจาะจงสำหรับผู้ให้บริการ Gemini API (Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI))

(Agent Platform Gemini API (formerly Vertex AI) เท่านั้น) ตั้งค่าตำแหน่งที่เฉพาะเจาะจงสำหรับเทมเพลต

ส่วนนี้ใช้ได้กับสถานการณ์ต่อไปนี้

• กรณีการใช้งานของแอปมีข้อกำหนดตามตำแหน่ง

• คำขอของแอปใช้ Agent Platform Gemini API (formerly Vertex AI) และคุณระบุ ตำแหน่งสำหรับการเข้าถึงโมเดล

ตามที่อธิบายไว้ก่อนหน้านี้ในหน้านี้ ระบบจะจัดสรรเทมเพลตพรอมต์ของเซิร์ฟเวอร์ไปยังทุก ภูมิภาคที่พร้อมใช้งานสำหรับ Firebase AI Logic (รวมถึง global) โดยอัตโนมัติ หากคุณดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้

• สร้างเทมเพลตโดยใช้ UI ที่แนะนำในคอนโซล Firebase
• สร้างเทมเพลตผ่าน REST API และ ตั้งค่าตำแหน่งเป็น global

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

อย่างไรก็ตาม หากต้องการให้เทมเพลต พร้อมใช้งานในตำแหน่งที่เฉพาะเจาะจงเท่านั้น คุณต้องสร้าง เทมเพลตผ่าน REST API และตั้งค่าตำแหน่งที่เฉพาะเจาะจงนั้นอย่างชัดเจน อย่าตั้งค่าตำแหน่งเป็น global

1. สร้างเทมเพลตโดยเรียก projects.locations.templates.create ปลายทาง ระบุ location ของเทมเพลต (เช่น europe-west4) เป็นส่วนหนึ่งของการสร้าง PromptTemplate

2. ในคำขอของแอป ให้ตรวจสอบว่า ตำแหน่งที่คุณเข้าถึงโมเดล ตรงกับตำแหน่งของเทมเพลต (europe-west4)

ข้อควรระวังมีดังต่อไปนี้

• รายการเทมเพลตในคอนโซล Firebase จะแสดงเฉพาะเทมเพลตที่จัดสรรในตำแหน่ง global (อย่างน้อยที่สุด)

• หากคุณใช้ REST API เพื่อจัดสรรเทมเพลตในตำแหน่งที่เฉพาะเจาะจง (ที่ไม่ใช่ not global) ตำแหน่งที่คุณเข้าถึงโมเดลใน คำขอของแอป must ตรงกับตำแหน่งที่ตั้งค่าไว้สำหรับเทมเพลต หากตำแหน่งไม่ตรงกัน คำขอจะล้มเหลว (เนื่องจากนโยบายการแยกภูมิภาค)

ระบุเทมเพลตเป็นไฟล์

คุณสามารถระบุเนื้อหาของไฟล์เทมเพลตพรอมต์ของเซิร์ฟเวอร์ได้โดยเรียกปลายทาง projects.locations.templates.create