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


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

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

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

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

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

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

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

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

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

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

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

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