Firebase Remote Config est désormais compatible avec la configuration côté serveur à l'aide du SDK Node.js Firebase Admin v12.1.0 ou version ultérieure. Cette nouvelle fonctionnalité vous permet de gérer de manière dynamique le comportement et la configuration des applications côté serveur à l'aide de Remote Config. Cela inclut les implémentations sans serveur telles que Cloud Functions.
Contrairement aux SDK client Firebase, qui extraient une configuration spécifique au client dérivé du modèle Remote Config, la méthode côté serveur Le SDK Remote Config télécharge un modèle Remote Config complet depuis Firebase. Votre serveur peut ensuite évaluer le modèle à chaque requête entrante et utilise sa propre logique pour répondre aux requêtes personnalisées une latence très faible. Vous pouvez utiliser des conditions pour contrôler et personnaliser les réponses en fonction de pourcentages aléatoires et d'attributs client définis dans des signaux personnalisés.
Avec Remote Config côté serveur, vous pouvez:
- Définissez des paramètres de configuration pour les applications exécutées sur votre serveur ou auxquelles vous accédez via celui-ci. Vous pouvez ainsi configurer à distance les paramètres et les invites du modèle d'IA, ainsi que d'autres intégrations, pour vous assurer que vos clés API restent sécurisées.
- Ajustez dynamiquement les paramètres en réponse aux modifications de votre environnement ou d'autres modifications d'application, comme la mise à jour des paramètres LLM et des points de terminaison du modèle.
- Contrôlez les coûts en mettant à jour à distance les API que votre serveur appelle.
- Générez des configurations personnalisées instantanément pour les clients qui accèdent à votre serveur.
- Enregistrez les clients qui ont reçu une valeur de paramètre et utilisez-la dans Cloud Functions dans le cadre d'un système de validation des droits d'accès.
Vous pouvez déployer Remote Config côté serveur sur Cloud Run, Cloud Functions ou des environnements serveur auto-hébergés.
Avant de commencer
Suivez les instructions de l'article Ajouter le SDK Firebase Admin à votre serveur pour créer une instance configurer un compte de service et ajouter le SDK Firebase Admin Node.js au projet votre serveur.
Étape 1: Initialiser le SDK Firebase Admin Node.js et autoriser les requêtes API
Lorsque vous initialisez le SDK Admin sans paramètre, il utilise les
Paramètre par défaut de l'application
Identifiants
et lit les options de l'environnement GOOGLE_APPLICATION_CREDENTIALS
. Par exemple, pour initialiser le SDK et ajouter Remote Config:
import { initializeApp } from "firebase-admin/app";
import { getRemoteConfig } from "firebase-admin/remote-config";
// Initialize Firebase
const firebaseApp = initializeApp();
Étape 2 : Identifiez les valeurs de paramètre par défaut de votre application serveur
Identifier les variables de votre application avec lesquelles vous souhaitez effectuer une mise à jour dynamique Remote Config Ensuite, réfléchissez aux variables qui doivent être définies par défaut dans votre application et à leurs valeurs par défaut. Cela garantit que votre application s'exécute correctement, même si sa connexion au Le serveur backend Remote Config est interrompu.
Par exemple, si vous écrivez une application de serveur qui gère vous pouvez définir un nom de modèle par défaut, un préambule d'invite, et une configuration d'IA générative, comme celle-ci:
Nom du paramètre | Description | Type | Valeur par défaut |
---|---|---|---|
model_name |
Nom de l'API du modèle | Chaîne | gemini-1.5-pro |
preamble_prompt
|
Inviter à ajouter un préfixe à l'expérience de l'utilisateur requête | Chaîne | I'm a
developer who
wants to learn
about Firebase and
you are a helpful
assistant who
knows everything
there is to know
about Firebase! |
generation_config
|
Paramètres à envoyer au modèle | JSON |
{"stopSequences":
["I hope this
helps"],
"temperature":
0.7,
"maxOutputTokens":
512, "topP": 0.1,
"topK": 20} |
Étape 3: Configurez votre application de serveur
Après avoir déterminé les paramètres à utiliser Remote Config, configurez votre application pour définir les valeurs par défaut, récupérez le modèle Remote Config propre au serveur et utiliser ses valeurs. Les étapes suivantes décrivent comment configurer votre application Node.js.
Accédez au modèle et chargez-le.
// Initialize server-side Remote Config const rc = getRemoteConfig(firebaseApp); const template = rc.initServerTemplate(); // Load Remote Config await template.load();
Si vous utilisez Node.js dans un Cloud Functions, vous pouvez utiliser le
getServerTemplate
asynchrone pour extraire et charger le modèle en une seule étape :// Initialize server-side Remote Config const rc = getRemoteConfig(firebaseApp); const template = await rc.getServerTemplate();
Pour garantir que votre application s'exécute correctement, même si sa connexion à le serveur backend Remote Config est interrompu, ajoutez des valeurs par défaut pour chaque paramètre à votre application. Pour ce faire, ajoutez un
defaultConfig
dans votre Fonction de modèleinitServerTemplate
ougetServerTemplate
:const template = rc.initServerTemplate({ defaultConfig: { model_name: "gemini-pro", generation_config: '{"stopSequences": [], "temperature": 0.7, "maxOutputTokens": 512, "topP": 0.1, "topK": 20}', preamble_prompt: "I'm a developer who wants to learn about Firebase and you are a helpful assistant who knows everything there is to know about Firebase!" }, }); // Load Remote Config await template.load()
Une fois le modèle chargé, utilisez
template.evaluate()
pour importer des paramètres et du modèle:// Add template parameters to config const config = template.evaluate();
Si vous définissez conditions dans votre modèle Remote Config, définissez et fournissez les valeurs souhaitées:
- Si vous utilisez des conditions de pourcentage, ajoutez l'
randomizationId
que vous souhaitez utiliser pour évaluer votre ou vos conditions dans la fonctiontemplate.evaluate()
. - Si vous utilisez des signaux personnalisés, définissez les attributs et leurs valeurs. Les signaux personnalisés sont disponibles avec le SDK Firebase Admin Node.js 12.5.0 ou version ultérieure.
Par exemple, vous pouvez définir un ID d'installation Firebase comme
randomizationId
ou un ID utilisateur pour vous assurer que chaque utilisateur qui contacte votre serveur est ajouté au groupe aléatoire approprié,version
comme signal personnalisé pour cibler des versions client spécifiques etplatform
comme signal personnalisé pour cibler la plate-forme client.Pour en savoir plus sur les conditions, consultez la section Types de règles de condition.
// Add template parameters to `config`. Evaluates the // template and returns the parameter value assigned to // the group assigned to the {randomizationId} and version. const config = template.evaluate({ randomizationId: "2ac93c28-c459-4760-963d-a3974ec26c04", version: "1.0", platform: "Android" });
- Si vous utilisez des conditions de pourcentage, ajoutez l'
Ensuite, extrayez les valeurs de paramètre dont vous avez besoin la constante de configuration. Utilisez
getters
pour caster les valeurs de Remote Config dans le format attendu. Les types suivants sont acceptés :- Booléen:
getBoolean
- Objet :
getValue
- Numéro :
getNumber
- Chaîne :
getString
Par exemple, si vous à implémenter Vertex AI sur votre serveur et que vous souhaitez modifier le modèle et ses paramètres, configurer des paramètres pour
model_name
etgenerationConfig
. Voici un exemple d'accès aux valeurs de Remote Config:// Replace defaults with values from Remote Config. const generationConfig = JSON.parse( config.getString('generation_config')); const is_ai_enabled = config.getBool('is_ai_enabled'); const model = config.getString('model_name'); // Generates a prompt comprised of the Remote Config // parameter and prepends it to the user prompt const prompt = `${config.getString('preamble_prompt')} ${req.query.prompt}`;
- Booléen:
Si votre serveur fonctionne de longue durée par opposition à un environnement sans serveur, Utilisez
setInterval
pour actualiser régulièrement le modèle afin de vous assurer que vous récupérez régulièrement le modèle le plus récent Remote Config.
Étape 4: Définissez les valeurs de paramètres spécifiques au serveur dans Remote Config
Créez ensuite un modèle Remote Config de serveur, puis configurez les paramètres et à utiliser dans votre application.
Pour créer un modèle Remote Config spécifique au serveur, procédez comme suit:
- Ouvrez les paramètres Remote Config de la console Firebase. et, à partir de la Sélectionnez Client/Serveur, puis Serveur.
- Définissez des paramètres Remote Config avec les mêmes noms et types de données que les paramètres que vous avez définis dans votre application, puis fournissez des valeurs. Ces valeurs remplaceront l'
defaultConfig
que vous avez définie dans Configurer votre application serveur lorsque vous extrayez et évaluez le modèle, puis attribuez ces valeurs à vos variables. - Vous pouvez éventuellement définir des conditions pour appliquer de manière persistante des valeurs à un échantillon aléatoire d'instances ou de signaux personnalisés que vous définissez. Pour en savoir plus sur les conditions, consultez la section Types de règles de condition.
- Lorsque vous avez terminé d'ajouter des paramètres, cliquez sur Publier les modifications.
- Vérifiez les modifications, puis cliquez à nouveau sur Publier les modifications.
Étape 5 : Déployer avec Cloud Functions ou Cloud Run
Si votre application serveur est légère et basée sur des événements, envisagez de déployer votre code à l'aide de Cloud Functions. Par exemple, imaginons que vous disposiez d'une application qui inclut des dialogues de personnages alimentés par une API d'IA générative (par exemple, Google AI ou Vertex AI). Dans ce cas, vous pouvez héberger votre logique de diffusion LLM dans une fonction que votre application appelle à la demande.
Pour trouver une solution qui utilise Cloud Functions de 2e génération avec Remote Config côté serveur, consultez Utiliser Remote Config côté serveur avec Cloud Functions et Vertex AI
Pour en savoir plus sur le déploiement de votre application avec Cloud Functions, consultez la section Obtenir vos premiers pas: écrire, tester et déployer vos fonctions.
Essayez un exemple de fonction appelable avec Remote Config côté serveur et App Check à Appelez Vertex AI Gemini API avec Remote Config et App Check.
Si votre application est destinée à être exécutée sur le long terme (par exemple, une application Web avec des composants), vous pouvez envisager d'utiliser Cloud Run. Pour déployer votre application de serveur avec Cloud Run, suivez le guide Guide de démarrage rapide: déployer Service Node.js vers Cloud Exécuter.
Pour en savoir plus sur les meilleurs cas d'utilisation de Cloud Run et Cloud Functions, consultez Comparaison entre Cloud Functions et Cloud Run: quand l'utiliser ? un sur le autre.