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


เทมเพลตการกำหนดค่าระยะไกลคือชุดพารามิเตอร์และเงื่อนไขรูปแบบ 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

คุณลบเทมเพลตการกำหนดค่าระยะไกลจากคอนโซล Firebase ได้ วิธีลบเทมเพลตการกำหนดค่าระยะไกล

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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