สำหรับ 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 Console ระบบจะจัดสรรเทมเพลต ในทุกสถานที่ (รวมถึง
global) โดยอัตโนมัติด้วย และคุณจะใช้เทมเพลตกับผู้ให้บริการ Gemini API ทั้ง 2 รายได้หากต้องการเข้าถึงเทมเพลตพรอมต์ฝั่งเซิร์ฟเวอร์ในคำขอ
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
สร้างเทมเพลตโดยเรียกใช้
projects.locations.templates.createปลายทาง ระบุlocationของเทมเพลต (เช่นeurope-west4) เป็นส่วนหนึ่งของการสร้างPromptTemplateในคำขอของแอป ให้ตรวจสอบว่าตำแหน่งที่คุณเข้าถึงโมเดล ตรงกับตำแหน่งของเทมเพลต (
eu)
ข้อควรระวังมีดังต่อไปนี้
รายการเทมเพลตในคอนโซล Firebase จะแสดงเฉพาะเทมเพลตที่ได้รับการจัดสรร (อย่างน้อย) ในตำแหน่ง
globalหากคุณใช้ REST API เพื่อจัดสรรเทมเพลตในสถานที่ตั้งที่เฉพาะเจาะจง (ซึ่งไม่ใช่
global) สถานที่ตั้งที่คุณเข้าถึงโมเดลในคำขอของแอปต้องตรงกับสถานที่ตั้งที่ตั้งไว้สำหรับเทมเพลต หากสถานที่ตั้งไม่ตรงกัน คำขอจะล้มเหลว (เนื่องจากนโยบายการแยกภูมิภาค)
ระบุเทมเพลตเป็นไฟล์
คุณระบุเนื้อหาของไฟล์เทมเพลตพรอมต์ของเซิร์ฟเวอร์ได้โดยเรียกใช้projects.locations.templates.create ปลายทาง