פרמטרים ותנאים של הגדרת תצורה מרחוק


אפשר להגדיר תבניות גם לתרחישי לדוגמה של לקוחות וגם לתרחישי לדוגמה של שרתים. לקוח/ה מוצגות בכל המופעים של האפליקציה שבהם מוטמע Firebase ערכות SDK של לקוח עבור Remote Config, כולל Android, Apple, Web, Unity, אפליקציות Flutter ו-C++. פרמטרים וערכים של Remote Config מתבניות ספציפיות לשרת מוצגים להטמעות של Remote Config (כולל Cloud Run ו-Cloud Functions) שמשתמשות ב-Firebase Admin Node.js SDK בגרסה 12.1.0 ואילך.

כשמשתמשים במסוף Firebase או בממשקי ה-API לקצה העורפי של Remote Config, מגדירים פרמטר אחד או יותר (זוגות מפתח/ערך) ומספקים ערכים שמוגדרים כברירת מחדל באפליקציה עבור הפרמטרים האלה. אפשר להגדיר ערכים של פרמטרים כדי לשנות את ערכי ברירת המחדל באפליקציה. מפתחות פרמטרים וערכים של פרמטרים הם מחרוזות, אבל אפשר להמיר ערכים של פרמטרים לסוגי נתונים אחרים כשמשתמשים בערכים האלה באפליקציה.

אפשר ליצור ערכי ברירת מחדל חדשים לפרמטר באמצעות מסוף Firebase, Admin SDK או Remote Config API ל-REST, וגם ערכים מותנים שמשמשים לטירגוט קבוצות של מכונות של אפליקציות. בכל פעם שמעדכנים את ההגדרות האישיות במסוף Firebase, מערכת Firebase יוצרת ומפרסמת גרסה חדשה של התבנית Remote Config. הגרסה הקודמת מאוחסנת, כך שתוכלו לאחזר אותה או לבצע חזרה לגרסה הקודמת לפי הצורך. הפעולות האלה זמינות במסוף Firebase, ב-Firebase Admin SDK וב-API ל-REST, ומתוארות בהרחבה במאמר ניהול גרסאות של תבניות Remote Config.

במדריך הזה מוסבר על פרמטרים, תנאים, כללים, ערכים מותנים ועל האופן שבו ניתנת עדיפות לערכים שונים של פרמטרים בקצה העורפי של Remote Config ובאפליקציה. בנוסף, מפורטות סוגי הכללים המשמשים ליצירת תנאים.

תנאים, כללים וערכים מותנים

תנאי משמש לטירגוט קבוצה של מופעי אפליקציה. התנאים מורכבים מכלל אחד או יותר, וכל אחד מהם חייב להניב את הערך true כדי שהתנאי יניב את הערך true למכונה נתונה של האפליקציה. אם הערך של כלל הוא לא מוגדר (לדוגמה, כשאין ערך זמין), הכלל יעריך false

לדוגמה, אפשר ליצור פרמטר שמגדיר את שם המודל ואת מחרוזת הגרסה של מודל שפה גדול (LLM), ולהציג תשובות ממודלים שונים על סמך כללי אותות מותאמים אישית. לחשבון בתרחיש לדוגמה הזה, ניתן להשתמש בגרסת מודל יציבה כערך ברירת המחדל למלא את רוב הבקשות ולהשתמש באות המותאם אישית כדי להשתמש במודל ניסיוני תגובה לבדיקה של בקשות של לקוחות.

לפרמטר יכולים להיות כמה תנאים מותנים שמשתמשים בתנאים שונים, ופרמטרים יכולים לשתף תנאים בתוך פרויקט. בכרטיסייה 'פרמטרים'. במסוף Firebase, ניתן לראות את אחוז האחזור של כל אחד מהם והערכים המותנים של הפרמטר. המדד הזה מציין את אחוז הבקשות ב-24 השעות האחרונות שקיבלו כל ערך.

עדיפות לערך הפרמטרים

כשמשתמשים ב-Remote Config באפליקציות שרת באמצעות Firebase Admin SDK, מאחזרים וטעונים את התבנית כולה כדי לחלץ את ערכי הפרמטרים המתאימים על פי דרישה לכל בקשת לקוח. יכול להיות שפרמטר משויך למספר ערכים מותנים.

הכללים הבאים קובעים איזה ערך יוקצה במהלך הערכת התבנית בנקודת זמן מסוימת:

  1. קודם כול, ערכים מותנים חלים על כל התנאים שמוערך שהם true לבקשת לקוח נתונה. אם המיקום הערך של כמה תנאים הוא true, התנאי הראשון (המוביל) שמוצג ממשק המשתמש של מסוף Firebase מקבל קדימות, וערכים מותנים משויכים מתקיימים כאשר מתבצעת הערכה של התבנית. אפשר לשנות את העדיפות של תנאים על ידי גרירה ושחרור של תנאים בכרטיסייה תנאים.

  2. אם אין ערכים מותנים עם תנאים שהערך שלהם הוא true, ערך ברירת המחדל של Remote Config צוין במהלך הערכת התבנית. אם לא קיים פרמטר בתבנית, או אם הוגדר ערך ברירת מחדל לשימוש בברירת המחדל בתוך האפליקציה, אז לא צוין ערך לפרמטר הזה כשמתבצעת הערכה של התבנית.

מידע נוסף על טעינה והערכה של Remote Config בתבניות באפליקציות שרת, ראה שימוש ב-Remote Config בשרת בסביבות.

סוגי נתונים של ערכי פרמטרים

בעזרת Remote Config אפשר לבחור סוג נתונים לכל פרמטר, ומערכת Analytics מאמתת את כל ערכי Remote Config בהתאם לסוג הזה לפני עדכון התבנית. סוג הנתונים מאוחסן ומוחזר ב-getRemoteConfig בקשה.

סוגי הנתונים הנתמכים הם:

  • String
  • Boolean
  • Number
  • JSON

בממשק המשתמש של מסוף Firebase, אפשר לבחור את סוג הנתונים מתוך לצד מפתח הפרמטר. ב-API ל-REST, אפשר להגדיר את הסוגים באמצעות השדה value_type באובייקט הפרמטר.

קבוצות פרמטרים

בעזרת Remote Config אפשר לקבץ את הפרמטרים יחד כדי שיהיה מאורגן יותר ממשק משתמש ושיפור נוחות השימוש.

לדוגמה, נניח שצריך להפעיל או להשבית שלושה סוגי אימות שונים בזמן ההשקה של תכונת התחברות חדשה. באמצעות Remote Config, אפשר ליצור את שלושת הפרמטרים כדי להפעיל את הסוגים הרצויים, ולאחר מכן לארגן אותם בקבוצה בשם 'התחברות חדשה', בלי צורך להוסיף תחיליות או מיון מיוחד.

אפשר ליצור קבוצות פרמטרים באמצעות המסוף Firebase או Remote Config API בארכיטקטורת REST. לכל קבוצת פרמטרים שיוצרים יש שם ייחודי תבנית Remote Config. כשיוצרים קבוצות פרמטרים, חשוב לזכור:

  • אפשר לכלול פרמטרים בקבוצה אחת בלבד בכל רגע נתון, ופרמטר המפתח עדיין צריך להיות ייחודי בכל הפרמטרים.
  • השמות של קבוצות הפרמטרים מוגבלים ל-256 תווים.
  • אם משתמשים גם ב-API ל-REST וגם במסוף Firebase, צריך לוודא הלוגיקה של API ל-REST עודכנה כדי לטפל בקבוצות פרמטרים בזמן פרסום.

יצירה או שינוי של קבוצות פרמטרים באמצעות המסוף Firebase

אפשר לקבץ פרמטרים בכרטיסייה Parameters במסוף Firebase. כדי ליצור או לשנות קבוצה:

  1. בוחרים באפשרות ניהול קבוצות.
  2. מסמנים את התיבות לצד הפרמטרים שרוצים להוסיף ולבחור בתיבות הסימון העברה לקבוצה.
  3. בוחרים קבוצה קיימת או יוצרים קבוצה חדשה על ידי הזנת שם ותיאור ובחירה באפשרות יצירת קבוצה חדשה. אחרי שמשמרים קבוצה, אפשר לפרסם אותה באמצעות הלחצן פרסום השינויים.

סוגי כללי תנאים

תבניות של Remote Config לאפליקציות שרת תומכות ב סוגי התנאים:

משתמש באחוז אקראי

אפשר להשתמש בשדה הזה כדי להחיל שינוי על דגימה אקראית של מכונות אפליקציה (בגודל דגימה של עד 0.0001%), באמצעות ווידג'ט פס ההזזה כדי לפלח משתמשים (מכונות אפליקציה) שמאוחזרים באופן אקראי לקבוצות.

כל מכונה של אפליקציה ממופה באופן קבוע למספר שלם או חלקי אקראי, בהתאם לseed שמוגדר באותו פרויקט.

כלל ישתמש במפתח ברירת המחדל (מוצג כ-Edit seed במסוף Firebase), אלא אם לשנות את ערך המקור. כדי להחזיר כלל לשימוש במפתח ברירת המחדל, צריך למחוק את השדה Seed.

כדי לטפל באופן עקבי באותם מופעי אפליקציה בטווחי אחוזים נתונים, צריך להשתמש באותו מקור נתונים בערך לפי התנאים השונים. לחלופין, אפשר לבחור קבוצה חדשה של מופעי אפליקציה שמוקצים באופן אקראי טווח אחוזים על ידי ציון מקור חדש.

לדוגמה, כדי ליצור שני תנאים קשורים שחלים על 5% לא חופפים של משתמשי האפליקציה, אפשר להגדיר תנאי אחד שיתאים לאחוז שבין 0% ל-5% ולהגדיר תנאי אחר שיתאים לטווח שבין 5% ל-10%. כדי לאפשר למשתמשים מסוימים להופיע באופן אקראי בשתי הקבוצות, השתמשו בערכי מקור שונים לכללים בתוך כל תנאי.

כדי ללמוד איך מוסיפים לאפליקציה תנאי אחוזים אקראיים: ראה הגדרת השרת אפליקציה.

אותות בהתאמה אישית

ב-Firebase Admin Node.js SDK מגרסה 12.5.0 ואילך, אפשר להשתמש בסוג התנאי Custom signal כדי להתאים לתנאים שרירותיים שתגדירו באפליקציה. כך תוכלו להתאים אישית את התגובה של השרת לכל בקשה של לקוח.

לדוגמה, אם אתם עובדים על אפליקציית שרת שמשתמשת ב-AI גנרטיבי כדי יכולים לעזור ליצור תשובות עם מודלים שונים שמכוונים לפלטפורמות ספציפיות, יכולים לבצע את הפעולות הבאות:

  1. מוסיפים את הפרמטרים prompt ו-model_name לתבנית השרת Remote Config.
  2. אפשר להוסיף אותות מותאמים אישית עם הערך platform לכל פלטפורמה שרוצים לטרגט.
  3. מוסיפים ערכי ברירת מחדל לתבנית Remote Config הספציפית לשרת, וערכים מותנים לכל תנאי פלטפורמה שהגדרתם.
  4. מעדכנים את קוד האפליקציה כדי להגדיר את האות המותאם אישית platform ולהשתמש בו.

עכשיו האפליקציה יכולה לחלץ את ההנחיה והמודל המתאימים במהלך הערכת התבנית, ולהשתמש בהם כדי להחזיר תשובות בהתאמה אישית לכל לקוח.

אפשר להשתמש בסוגי הכללים הבאים כדי ליצור אותות מותאמים אישית מסוף Firebase.

קטגוריית המפעיל אופרטורים ערך הערה
טקסט תואם בדיוק, מכיל, לא מכיל, מכיל ביטוי רגולרי (regex)

השוואות של מחרוזות לפי הכלל הזה הן תלויות-רישיות. כשמשתמשים באופרטור תואם בדיוק, מכיל, לא מכיל או מכיל ביטוי רגולרי (regex), אפשר לבחור כמה ערכים.

כשמשתמשים באופרטור contains regex אפשר ליצור ביטויים רגולריים בפורמט RE2. הביטוי הרגולרי יכול להתאים לכל היעד או לחלק ממנו מחרוזת גרסה. אפשר גם להשתמש בעוגנים ^ ו-$ כדי להתאים להתחלה, לסוף או לכל המחרוזת היעד.

מספרים <, <=, =, !=, >, >= מספר עם לא יותר מעשר ספרות בכל צד של הנקודה העשרונית.
גירסאות <, <=, =, !=, >, >= מספר שמייצג את מספרי הגרסאות שתואמים (לדוגמה, 2.1.0).

מידע נוסף על הוספת אותות מותאמים אישית לאפליקציה זמין במאמר הגדרת יישום השרת.

פרמטרים ותנאים של חיפוש

אפשר לחפש במפתחות הפרמטרים, בערכי הפרמטרים והתנאים של הפרויקט ממסוף Firebase באמצעות תיבת החיפוש בחלק העליון של הכרטיסייה Remote Config פרמטרים.

מגבלות על פרמטרים ועל תנאים

בפרויקט Firebase אפשר להגדיר עד 2,000 פרמטרים ועד 500 תנאים. מפתחות פרמטרים יכולים להיות באורך של עד 256 תווים, חייבים להתחיל ב קו תחתון או אות באנגלית (A-Z, a-z), ועשוי לכלול גם . האורך הכולל של מחרוזות ערכי הפרמטרים בפרויקט לא יכול לחרוג מ-1,000,000 תווים.

הצגת שינויים בפרמטרים ובתנאים

אפשר לראות את השינויים האחרונים בתבניות Remote Config דרך מסוף Firebase. לכל פרמטר ותנאי ספציפיים, אפשר:

  • הצגת השם של המשתמש שביצע את השינוי האחרון בפרמטר או בתנאי.

  • אם השינוי בוצע באותו יום, אפשר להציג את מספר הדקות או שעות שחלפו מאז פרסום השינוי תבנית Remote Config.

  • אם השינוי התרחש לפני יום אחד או יותר, תוכלו לראות את התאריך שבו השינוי פורסם בתבנית הפעילה Remote Config.

היסטוריית שינויים של פרמטרים

ב-Remote Config פרמטרים בעמודה פורסם לאחרונה מוצג המשתמש האחרון שערך שינויים בכל ואת תאריך הפרסום האחרון של השינוי:

  • כדי להציג מטא-נתונים של שינויים של פרמטרים מקובצים, מרחיבים את קבוצת הפרמטרים.

  • כדי למיין בסדר עולה או יורד לפי תאריך הפרסום, לוחצים על התווית של העמודה תאריך הפרסום האחרון.

היסטוריית השינויים של התנאים

בדף Remote ConfigConditions אפשר לראות את המשתמש האחרון ששינה את התנאי ואת התאריך שבו הוא שינה אותו, לצד Last modified (שינוי אחרון) שמופיע מתחת לכל תנאי.

השלבים הבאים

כדי להגדיר את פרויקט Firebase ואת אפליקציית השרת שלכם לשימוש ב-Remote Config: למידע נוסף, ראו שימוש ב-Remote Config בסביבות שרת.