สำหรับ 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) โดยอัตโนมัติด้วย และเทมเพลตจะพร้อมใช้งานกับผู้ให้บริการ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