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

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

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

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

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

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

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

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

  โปรดทราบว่าเมื่อคุณใช้ UI ที่แนะนำในคอนโซล Firebase ระบบจะจัดสรรเทมเพลต ในตำแหน่ง ทั้งหมด โดยอัตโนมัติ (รวมถึง global) และคุณจะใช้เทมเพลตนี้กับผู้ให้บริการ ทั้ง 2 ราย 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. ในคำขอของแอป ให้ตรวจสอบว่า ตำแหน่งที่คุณเข้าถึงโมเดล ตรงกับตำแหน่งของเทมเพลต (eu)

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

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

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

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

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