Vous pouvez configurer des modèles pour les cas d'utilisation client et serveur. Client les modèles sont diffusés sur toutes les instances d'application qui implémentent la SDK clients pour Remote Config, y compris Android, Apple, Web, Unity, Flutter et les applications C++. Les paramètres et les valeurs Remote Config des modèles spécifiques au serveur sont transmis aux implémentations Remote Config (y compris Cloud Run et Cloud Functions) qui utilisent le SDK Node.js Firebase Admin v12.1.0 ou version ultérieure.
Lorsque vous utilisez la console Firebase ou la API backend Remote Config, vous définissez un ou plusieurs paramètres (clé-valeur ) et fournir des valeurs par défaut dans l'application pour ces paramètres. Vous pouvez remplacer des valeurs par défaut dans l'application en définissant des valeurs de paramètres. Les clés et les valeurs de paramètre sont des chaînes, mais les valeurs de paramètre peuvent être converties en d'autres types de données lorsque vous les utilisez dans votre application.
Avec la console Firebase, Admin SDK ou API REST Remote Config vous pouvez créer des valeurs par défaut ainsi que des valeurs conditionnelles permettant de cibler des groupes Compute Engine. Chaque fois que vous mettez à jour votre configuration dans la console Firebase, Firebase crée et publie une nouvelle version de votre modèle Remote Config. La version précédente est stockée, ce qui vous permet de la récupérer ou d'effectuer un rollback si nécessaire. Ces opérations sont disponibles dans la console Firebase, la Firebase Admin SDK et l'API REST, et sont décrits plus en détail dans Gérer Remote Config versions de modèle
Ce guide explique les paramètres, les conditions, les règles, les valeurs conditionnelles et la façon dont les différentes valeurs de paramètre sont priorisées dans le backend Remote Config et dans votre application. Il fournit également des informations sur les types de règles utilisées pour créer des conditions.
Conditions, règles et valeurs conditionnelles
Une condition permet de cibler un groupe d'instances d'application. Les conditions sont constituées d'une ou de plusieurs règles qui doivent toutes renvoyer la valeur true pour que la condition renvoie la valeur true pour une instance d'application donnée. Si la valeur d'une règle est
non définie (par exemple, lorsqu'aucune valeur n'est disponible), la règle renvoie la valeur
false
Par exemple, vous pouvez créer un paramètre définissant un grand langage de modèle (LLM) et de la chaîne de version, et diffusent des réponses provenant de différents en fonction de signaux personnalisés règles. Dans ce cas d'utilisation, vous pouvez utiliser une version de modèle stable comme valeur par défaut pour répondre à la plupart des requêtes, et utiliser le signal personnalisé pour utiliser un modèle expérimental pour répondre aux requêtes du client de test.
Un paramètre peut avoir plusieurs conditions utilisant des conditions différentes, et les paramètres peuvent partager des conditions un projet. Dans l'onglet Paramètres de la console Firebase, vous pouvez afficher le pourcentage de récupération pour les valeurs conditionnelles de chaque paramètre. Cette métrique indique le pourcentage de requêtes ayant reçu chaque valeur au cours des dernières 24 heures.
Priorité des valeurs de paramètre
Lorsque vous utilisez Remote Config dans des applications serveur à l'aide de Firebase Admin SDK, vous extraire et charger l'intégralité du modèle afin d'extraire des valeurs de paramètres à la demande pour chaque requête client. Un paramètre peut avoir plusieurs valeurs conditionnelles associées.
Les règles suivantes déterminent la valeur attribuée lors de l'évaluation du modèle à un moment précis:
Tout d'abord, les valeurs conditionnelles sont appliquées à toutes les conditions qui évaluent à
truepour une requête client donnée. Si plusieurs conditions renvoient la valeurtrue, la première (en haut) affichée dans l'interface utilisateur de la console Firebase prévaut, et les valeurs conditionnelles associées à cette condition sont fournies lors de l'évaluation du modèle. Vous pouvez modifier la priorité des conditions par glisser-déposer dans dans l'onglet Conditions.Si aucune valeur conditionnelle n'est associée à des conditions qui renvoient
true, la valeur par défaut de Remote Config est fournie lors de l'évaluation du modèle. Si un paramètre n'existe pas dans le modèle ou si la valeur par défaut est définie sur Utiliser la valeur par défaut de l'application, aucune valeur n'est fournie pour ce paramètre lors de l'évaluation du modèle.
Pour en savoir plus sur le chargement et l'évaluation de Remote Config dans les applications de serveur, consultez la section Utiliser Remote Config sur le serveur environnements Google.
Types de données de valeur de paramètre
Remote Config vous permet de sélectionner un type de données pour chaque paramètre.
valide toutes les valeurs Remote Config par rapport à ce type avant un modèle.
mise à jour. Le type de données est stocké et renvoyé dans une requête getRemoteConfig.
Les types de données acceptés sont les suivants:
StringBooleanNumberJSON
Dans l'interface utilisateur de la console Firebase, le type de données peut être sélectionné dans un menu déroulant à côté de la clé de paramètre. Dans l'API REST, les types peuvent être définis à l'aide de
le champ value_type dans l'objet de paramètre.
Groupes de paramètres
Remote Config vous permet de regrouper des paramètres pour une interface utilisateur plus organisée et une meilleure usabilité.
Par exemple, supposons que vous deviez activer ou désactiver trois types d'authentification différents tout en déployant une nouvelle fonctionnalité de connexion. Avec Remote Config, vous pouvez créer les trois paramètres pour activer les types souhaités, puis les organiser dans un nommé « Nouvelle connexion », sans préfixe ni tri spécial.
Vous pouvez créer des groupes de paramètres à l'aide de la console Firebase ou de l'API REST Remote Config. Chaque groupe de paramètres que vous créez possède un nom unique dans votre modèle Remote Config. Lorsque vous créez des groupes de paramètres, tenez compte des points suivants :
- Les paramètres ne peuvent être inclus que dans un seul groupe à la fois, et un paramètre doit toujours être unique pour tous les paramètres.
- Les noms de groupes de paramètres sont limités à 256 caractères.
- Si vous utilisez à la fois l'API REST et la console Firebase, assurez-vous que les La logique de l'API REST est mise à jour pour gérer les groupes de paramètres lors de la publication.
Créer ou modifier des groupes de paramètres à l'aide de la console Firebase
Vous pouvez regrouper les paramètres Paramètres de la console Firebase. Pour créer ou modifier un groupe:
- Sélectionnez Gérer les groupes.
- Cochez les cases des paramètres que vous souhaitez ajouter, puis sélectionnez Déplacer vers un groupe.
- Sélectionnez un groupe existant ou créez-en un en saisissant un nom et une description, puis en sélectionnant Créer un groupe. Une fois un groupe enregistré, vous pouvez le publier à l'aide du bouton Publier les modifications.
Types de règles de condition
Les modèles Remote Config pour les applications de serveur sont compatibles avec les fonctionnalités suivantes : types de condition:
Utilisateur d'un pourcentage aléatoire
Utilisez ce champ pour appliquer une modification à un échantillon aléatoire d'instances d'application (avec des échantillons de taille réduite). 0,0001%), utilisez le curseur pour segmenter les utilisateurs (instances d'application) brassés de manière aléatoire groupes.
Chaque instance d'application est mappée de manière persistante à un nombre entier ou fractionnaire aléatoire, en fonction d'un seuil défini dans ce projet.
La règle utilisera la clé par défaut (affichée comme Modifier la valeur de départ dans la console Firebase), sauf si vous modifier la valeur de graine. Pour qu'une règle utilise la clé par défaut, effacez le champ Graine.
Pour traiter systématiquement les mêmes instances d'application dans des plages de pourcentage données, utilisez la même source. entre les conditions. Vous pouvez également sélectionner un nouveau groupe d'instances d'application attribué de manière aléatoire pour une plage de pourcentage donnée en spécifiant un nouveau seed.
Par exemple, pour créer deux conditions associées qui s'appliquent chacune à 5 % non chevauchants des utilisateurs d'une application, vous pouvez configurer une condition pour qu'elle corresponde à un pourcentage compris entre 0 et 5 % et une autre pour qu'elle corresponde à une plage comprise entre 5 et 10 %. Pour autoriser certains utilisateurs à apparaître de manière aléatoire dans les deux groupes, utilisez des valeurs de départ différentes pour les règles de chaque condition.
Pour savoir comment ajouter des conditions de pourcentage aléatoires à votre application, consultez la section Configurer votre application de serveur.
Signaux personnalisés
Avec le SDK Firebase Admin Node.js 12.5.0 ou version ultérieure, vous pouvez utiliser le type de condition Signal personnalisé pour faire correspondre des conditions arbitraires que vous définissez dans votre application. Vous pouvez ainsi adapter la réponse du serveur à chaque requête client.
Par exemple, si vous travaillez sur une application serveur qui utilise l'IA générative pour créer des réponses avec différents modèles adaptés à des plates-formes spécifiques, vous pouvez procéder comme suit :
- Ajoutez les paramètres
promptetmodel_nameà votre Remote Config. Google Cloud. - Ajoutez des signaux personnalisés avec une valeur de
platformpour chaque plate-forme que vous souhaitez cibler. - Ajoutez des valeurs par défaut au modèle Remote Config spécifique au serveur et des valeurs conditionnelles pour chaque condition de plate-forme que vous avez définie.
- Mettez à jour le code de votre application pour définir et utiliser le signal personnalisé
platform.
Votre application peut maintenant extraire la requête et le modèle appropriés l'évaluation et de les utiliser pour renvoyer des réponses personnalisées à chaque client.
Vous pouvez utiliser les types de règles suivants pour créer des signaux personnalisés dans la console Firebase.
| Catégorie d'opérateur | Opérateur(s) | Valeur | Remarque |
|---|---|---|---|
| Texte | correspond exactement, contient, ne contient pas, contient une expression régulière |
Les comparaisons de chaînes pour cette règle sont sensibles à la casse. Lorsque vous utilisez les opérateurs correspond exactement à, contient, ne contient pas ou contient une expression régulière, vous pouvez sélectionner plusieurs valeurs. Lorsque vous utilisez l'opérateur contient une expression régulière, vous pouvez créer des expressions régulières au format RE2. Votre expression régulière peut correspondre à tout ou partie de la cible la chaîne de version. Vous pouvez également utiliser les ancres ^ et $ pour faire correspondre le début, la fin ou l'intégralité d'une chaîne cible. |
|
| Numéros | <, <=, =, !=, >, >= | Nombre ne comportant pas plus de 10 chiffres de chaque côté de la virgule. | |
| Versions | <, <=, =, !=, >, >= | Chiffre représentant le ou les numéros de version à mettre en correspondance (par exemple, 2.1.0). |
Pour savoir comment ajouter des signaux personnalisés à votre application, consultez la section Configurer votre application serveur.
Rechercher des paramètres et des conditions
Vous pouvez rechercher des clés de paramètres, des valeurs de paramètres et des conditions de votre projet depuis la console Firebase à l'aide de la champ de recherche situé en haut de l'onglet Paramètres Remote Config.
Limites applicables aux paramètres et aux conditions
Un projet Firebase peut contenir jusqu'à 2 000 paramètres et 500 paramètres et conditions d'exploitation. Les clés de paramètres peuvent comporter jusqu'à 256 caractères et doivent commencer par trait de soulignement ou lettre non accentuée (A-Z, a-z), et peut également inclure de chiffres. La longueur totale des chaînes de valeurs de paramètre d'un projet ne doit pas dépasser 1 000 000 caractères.
Afficher les modifications apportées aux paramètres et conditions
Vous pouvez consulter les dernières modifications apportées à vos modèles Remote Config depuis la console Firebase. Pour chaque paramètre et condition, vous pouvez :
Afficher le nom de l'utilisateur qui a modifié le paramètre ou la condition pour la dernière fois.
Si la modification a eu lieu dans la même journée, affichez le nombre de minutes ou heures écoulées depuis la publication de la modification sur Modèle Remote Config.
Si le changement s'est produit il y a un ou plusieurs jours, consultez la date à laquelle il a été publié dans le modèle Remote Config actif.
Historique des modifications pour les paramètres
Le Remote Config Paramètres la colonne Dernière publication indique le dernier utilisateur qui a modifié chaque et la date de la dernière publication de la modification:
Pour afficher les métadonnées de modification des paramètres groupés, développez le groupe de paramètres.
Pour trier les données par ordre croissant ou décroissant en fonction de la date de publication, cliquez sur le libellé de la colonne Dernière publication.
Historique des modifications des conditions
Le Remote Config Conditions vous pouvez voir le dernier utilisateur à avoir modifié la condition et la date. il l'a modifiée en regard de Dernière modification sous chaque condition.