เทมเพลตการกำหนดค่าระยะไกลและการกำหนดเวอร์ชัน


เทมเพลตการกำหนดค่าระยะไกลเป็นชุดรูปแบบ JSON พารามิเตอร์และเงื่อนไขที่คุณสร้างไว้สำหรับโปรเจ็กต์ Firebase คุณ สร้างเทมเพลตไคลเอ็นต์ที่แอปจะดึงข้อมูลค่าได้ และ เซิร์ฟเวอร์ ซึ่งไคลเอ็นต์เซิร์ฟเวอร์จะดึงข้อมูลค่าได้

ส่วนนี้จะกล่าวถึงเทมเพลตเซิร์ฟเวอร์ เพื่อดูข้อมูลเกี่ยวกับ ลูกค้าแต่ละราย เทมเพลต ให้คลิก เทมเพลตไคลเอ็นต์

คุณแก้ไขและจัดการเทมเพลตได้โดยใช้คอนโซล Firebase ซึ่งแสดง เนื้อหาของเทมเพลตในรูปแบบกราฟิกใน พารามิเตอร์ และ เงื่อนไข

ต่อไปนี้คือตัวอย่างของไฟล์เทมเพลตเซิร์ฟเวอร์

{
  "parameters": {
    "preamble_prompt": {
      "defaultValue": {
        "value": "You are a helpful assistant who knows everything there is to know about Firebase! "
      },
      "description": "Add this prompt to the user's prompt",
      "valueType": "STRING"
    },
    "model_name": {
      "defaultValue": {
        "value": "gemini-pro-test"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
      },
      "valueType": "JSON"
    },
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

คุณสามารถทำงานการจัดการเวอร์ชันเหล่านี้ได้ด้วยคอนโซล Firebase

  • แสดงรายการเวอร์ชันของเทมเพลตที่จัดเก็บไว้ทั้งหมด
  • ดึงข้อมูลเวอร์ชันที่ต้องการ
  • ย้อนกลับไปใช้เวอร์ชันไคลเอ็นต์ที่ต้องการ
  • ลบเทมเพลตการกำหนดค่าระยะไกลจากหน้า Change ประวัติศาสตร์ เพจ

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

ทุกครั้งที่คุณอัปเดตพารามิเตอร์ การกำหนดค่าระยะไกลจะสร้าง เทมเพลตการกำหนดค่าระยะไกลเวอร์ชันใหม่และจัดเก็บเทมเพลตก่อนหน้าเป็น เวอร์ชันที่คุณเรียกดูหรือย้อนกลับได้ตามที่ต้องการ หมายเลขเวอร์ชัน จะเพิ่มขึ้นตามลำดับจากค่าเริ่มต้นที่จัดเก็บโดยการกำหนดค่าระยะไกล เทมเพลตทั้งหมดจะมีช่อง version ตามที่แสดงซึ่งมีข้อมูลเมตาเกี่ยวกับช่องนั้น เวอร์ชันที่เจาะจง

คุณสามารถลบเทมเพลตการกำหนดค่าระยะไกลได้ตามต้องการจาก ประวัติการเปลี่ยนแปลง หน้าเว็บบน คอนโซลการกำหนดค่าระยะไกล

จัดการเวอร์ชันเทมเพลตการกำหนดค่าระยะไกล

หัวข้อนี้จะอธิบายวิธีจัดการเวอร์ชันของการกำหนดค่าระยะไกล เทมเพลต

แสดงรายการเวอร์ชันที่จัดเก็บไว้ของเทมเพลตการกำหนดค่าระยะไกล

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

  1. เปิดการกำหนดค่าระยะไกลจากคอนโซล Firebase

  2. จากนั้น จาก พารามิเตอร์ แท็บ ให้เลือก "นาฬิกา" แสดงที่ด้านขวาบน

    ซึ่งจะเป็นการเปิด ประวัติการเปลี่ยนแปลง ที่มีรายการเวอร์ชันเทมเพลตที่จัดเก็บไว้ทั้งหมดในเมนูรายการทางด้านขวา

    รายการเทมเพลตประกอบด้วยข้อมูลเมตาสำหรับเวอร์ชันที่จัดเก็บไว้ทั้งหมด ซึ่งรวมถึง เวลาของการอัปเดต ผู้ใช้ที่สร้าง และวิธีสร้าง

ดึงข้อมูลเทมเพลตการกำหนดค่าระยะไกลในเวอร์ชันที่ต้องการ

คุณสามารถเรียกดูข้อมูลใด ของเทมเพลตการกำหนดค่าระยะไกล วิธีเรียกข้อมูลเทมเพลตที่เก็บไว้ เวอร์ชัน:

  1. เปิดแผงรายละเอียดของ ประวัติการเปลี่ยนแปลง

  2. หากต้องการดูรายละเอียดของเวอร์ชันอื่นในรายการ ให้เลือกจากด้านขวา เมนู

  3. ดูความแตกต่างโดยละเอียดของเทมเพลตที่ใช้งานอยู่และเวอร์ชันอื่นที่จัดเก็บไว้โดย การวางเมาส์เหนือเมนูตามบริบทสำหรับเวอร์ชันที่ไม่ได้เลือก แล้วเลือกเปรียบเทียบกับเวอร์ชันที่เลือก

ย้อนกลับไปยังเวอร์ชันที่จัดเก็บไว้เฉพาะของเทมเพลตการกำหนดค่าระยะไกล

คุณสามารถย้อนกลับไปยัง ของเทมเพลต วิธีย้อนกลับเทมเพลต

  1. มองหาปุ่มตัวเลือกที่ด้านขวาบนของส่วน ประวัติการเปลี่ยนแปลง คลิกและยืนยันการดำเนินการนี้ต่อเมื่อคุณแน่ใจว่าต้องการย้อนกลับไปยัง เวอร์ชันนั้นและใช้ค่าเหล่านั้นทันทีสำหรับแอปและผู้ใช้ทั้งหมด

โปรดทราบว่าการดำเนินการย้อนกลับนี้จะสร้าง เวอร์ชันใหม่ที่มีหมายเลขกำกับ เช่น การย้อนกลับจากเวอร์ชัน 10 ไปเป็นเวอร์ชัน 6 สร้างสำเนาใหม่ของเวอร์ชัน 6 ได้อย่างมีประสิทธิภาพ โดยมีความแตกต่าง จากเวอร์ชันต้นฉบับเพียงเพราะหมายเลขเวอร์ชันคือ 11 เวอร์ชันต้นฉบับ 6 จะยังคงจัดเก็บอยู่ ในกรณีที่ยังไม่ถึงวันหมดอายุและเวอร์ชัน 11 จะกลายเป็นเทมเพลตที่ใช้งานอยู่

ลบเทมเพลตการกำหนดค่าระยะไกล

คุณลบเทมเพลตการกำหนดค่าระยะไกลจากคอนโซล Firebase ได้ ถึง ลบเทมเพลตการกำหนดค่าระยะไกล

1. จากการกำหนดค่าระยะไกล พารามิเตอร์ ให้คลิก ประวัติการเปลี่ยนแปลง

  1. สลับไปยังเทมเพลตที่ต้องการลบ แล้วคลิก เพิ่มเติม แล้วเลือก Delete

  2. เมื่อมีข้อความแจ้งให้ยืนยันการลบ ให้คลิกลบ

ดาวน์โหลดและเผยแพร่เทมเพลตการกำหนดค่าระยะไกล

ดาวน์โหลดและเผยแพร่เทมเพลตการกำหนดค่าระยะไกลเพื่อผสานรวมเทมเพลตเข้ากับ การควบคุมต้นทางและระบบของการสร้าง การอัปเดตการกำหนดค่าโดยอัตโนมัติ และเก็บพารามิเตอร์ และค่าต่างๆ ให้ซิงค์กันในหลายโปรเจ็กต์

คุณสามารถดาวน์โหลดเทมเพลตการกำหนดค่าระยะไกลที่ใช้งานอยู่ได้ในปัจจุบัน จากคอนโซล Firebase จากนั้นคุณจะสามารถอัปเดต ส่งออกไฟล์ JSON และเผยแพร่ไปยังโปรเจ็กต์เดียวกัน หรือเผยแพร่ไปยังโปรเจ็กต์ใหม่ ที่มีอยู่

สมมติว่าคุณมีโครงการหลายโครงการที่แสดงขั้นตอนต่างๆ ของ วงจรการพัฒนาซอฟต์แวร์ เช่น การพัฒนา การทดสอบ การทดลองใช้ และการผลิต สภาพแวดล้อมการใช้งาน ในกรณีนี้ คุณสามารถโปรโมตเทมเพลตที่ทดสอบอย่างสมบูรณ์จาก สำหรับสภาพแวดล้อมการใช้งานจริงเป็นสภาพแวดล้อม การใช้งานจริง โดยดาวน์โหลดจาก จัดเตรียมโปรเจ็กต์และเผยแพร่ในโปรเจ็กต์ที่ใช้งานจริง

คุณยังใช้วิธีการนี้เพื่อย้ายข้อมูลการกำหนดค่าจากโปรเจ็กต์หนึ่งไปยัง รายการอื่น หรือป้อนข้อมูลในโปรเจ็กต์ใหม่ด้วยพารามิเตอร์และค่าจาก ที่สร้างโครงการแล้ว

พารามิเตอร์และค่าพารามิเตอร์ที่สร้างขึ้นเป็นตัวแปรโดยเฉพาะใน การทดสอบ A/B Testing จะไม่รวมอยู่ในเทมเพลตที่ส่งออก

วิธีส่งออกและนำเข้าเทมเพลตการกำหนดค่าระยะไกล

  1. ดาวน์โหลดเทมเพลตการกำหนดค่าระยะไกลปัจจุบัน
  2. ตรวจสอบเทมเพลตการกำหนดค่าระยะไกล
  3. เผยแพร่เทมเพลตการกำหนดค่าระยะไกล

ดาวน์โหลดเทมเพลตการกำหนดค่าระยะไกลปัจจุบัน

ใช้รายการต่อไปนี้เพื่อดาวน์โหลดเทมเพลตการกำหนดค่าระยะไกลที่ใช้งานอยู่ใน รูปแบบ JSON:

  1. จาก พารามิเตอร์หรือเงื่อนไขการกำหนดค่าระยะไกล เปิดเมนู และ เลือกดาวน์โหลดไฟล์การกำหนดค่าปัจจุบัน
  2. เมื่อมีข้อความแจ้ง ให้คลิกดาวน์โหลดไฟล์การกําหนดค่า แล้วเลือกตําแหน่งที่ ที่คุณต้องการบันทึกไฟล์ แล้วคลิกบันทึก

ตรวจสอบความถูกต้องของเทมเพลตการกำหนดค่าระยะไกล

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

เผยแพร่เทมเพลตการกำหนดค่าระยะไกล

หลังจากดาวน์โหลดเทมเพลตแล้ว ให้ทำการเปลี่ยนแปลงที่จำเป็นในเนื้อหา JSON และ เมื่อตรวจสอบความถูกต้อง คุณจะสามารถเผยแพร่ไปยังโปรเจ็กต์ได้

การเผยแพร่เทมเพลตจะแทนที่เทมเพลตการกำหนดค่าที่มีอยู่ทั้งหมดด้วยพารามิเตอร์ ไฟล์ที่อัปเดต และเพิ่มเวอร์ชันของเทมเพลตทีละไฟล์ เนื่องจาก มาแทนที่การกำหนดค่า หากคุณลบพารามิเตอร์ออกจากไฟล์ JSON และ เผยแพร่ พารามิเตอร์จะถูกลบออกจากเซิร์ฟเวอร์และใช้ไม่ได้อีกต่อไป แก่ลูกค้า

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

ใช้คำสั่งต่อไปนี้เพื่อเผยแพร่เทมเพลตของคุณ

  1. จาก พารามิเตอร์หรือเงื่อนไขการกำหนดค่าระยะไกล ให้เปิดเมนู แล้วเลือกเผยแพร่จากไฟล์
  2. เมื่อมีข้อความแจ้ง ให้คลิกเรียกดู แล้วไปที่ ไฟล์การกำหนดค่าระยะไกลที่ต้องการเผยแพร่ จากนั้นคลิกเลือก
  3. ไฟล์จะได้รับการตรวจสอบความถูกต้อง และถ้าสำเร็จ คุณสามารถคลิก เผยแพร่เพื่อให้การกำหนดค่าพร้อมใช้งานทันที แอปและผู้ใช้

ขั้นตอนถัดไป