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


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

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

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

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

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

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

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

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

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