Ajouter Cloud Firestore et l'authentification à votre application Google AI Studio

Google AI Studio s'intègre directement à Cloud Firestore et Firebase Authentication, ce qui vous permet de créer des applications avec des données persistantes et des flux de connexion sécurisés. Lorsque vous utilisez la fonctionnalité "Ajouter un backend Firebase" dans Google AI Studio, l'agent génère le code requis et associe votre application à un projet Firebase.

Présentation : Ajouter un backend à votre application Google AI Studio

1. Décrivez votre idée : créez une application dans Google AI Studio et décrivez une fonctionnalité qui nécessite une base de données ou une authentification (par exemple, "Créer une liste de tâches partagée").

2. Activez l'intégration Firebase : sélectionnez le chip Add Firebase backend (Ajouter un backend Firebase). L'agent génère le code nécessaire, y compris un fichier /src/lib/firebase.ts et un fichier firestore.rules, puis connecte votre application à Cloud Firestore et Firebase Authentication.

3. Déployer : une fois que vous êtes prêt, utilisez l'option Partager > Publier pour déployer votre application sur Cloud Run.

Comprendre le quota partagé pour Cloud Firestore

Toutes les bases de données Cloud Firestore provisionnées par l'agent dans Google AI Studio sont placées dans le même "groupe" de bases de données de votre projet Firebase. Elles partagent toutes les caractéristiques suivantes :

• Quota partagé : toutes les bases de données du groupe partagent un quota d'utilisation (voir les détails ci-dessous).
• Aucun compte Cloud Billing requis : vous pouvez créer et tester votre application sans ajouter de facturation. Pour en savoir plus sur l'ajout facultatif d'informations de facturation, consultez les détails ci-dessous.
• Réinitialisations quotidiennes : si vous atteignez une limite de quota quotidien (par exemple, 50 000 lectures/jour), le service sera mis en veille pour toutes les bases de données du groupe et reprendra le lendemain vers minuit, heure du Pacifique.

Les bases de données Cloud Firestore du groupe de quotas partagés sont soumises aux limites suivantes :

(Facultatif) Ajouter la facturation pour obtenir plus de quota Cloud Firestore

Si votre application gagne en popularité et que vous devez dépasser les limites sans frais pour Cloud Firestore, vous pouvez passer au forfait Blaze avec paiement à l'usage pour votre projet.

1. Ajoutez la facturation (si ce n'est pas déjà fait) : accédez à la console Firebase et associez un compte de facturation à votre projet.

2. Mettre à niveau la base de données : par défaut, les bases de données Cloud Firestore créées par l'agent Google AI Studio continuent d'utiliser le quota partagé même après la mise à niveau de votre forfait. Pour activer le scaling payant complet pour une base de données spécifique, vous devez la déplacer manuellement hors du groupe à l'aide d'une commande curl.

   • PROJECT_ID : ID du projet Firebase. Vous trouverez cet ID dans les paramètres du projet de la console Firebase.
   • DATABASE_ID : ID de la base de données Cloud Firestore, qui correspond à l'ID de votre applet. Vous trouverez cet ID de base de données dans la colonne Nom de la page Bases de données Cloud Firestore de la console Firebase.

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID?updateMask=limited_free_tier" \
   -d '{"limited_free_tier": false}'
   

Security Rules génération

Google AI Studio génère automatiquement Firebase Security Rules en fonction de la logique de votre application. Ces Security Rules sont conçues pour être "refusées par défaut", ce qui signifie que les utilisateurs finaux de votre application ne peuvent accéder qu'aux données qu'ils possèdent.

Notez que si vous ajustez manuellement votre Security Rules directement dans la console Firebase, l'agent Google AI Studio n'aura pas connaissance des modifications, et celles-ci seront écrasées lors des itérations ultérieures de l'application. Nous vous recommandons d'utiliser l'agent Google AI Studio pour ajuster votre Firebase Security Rules afin de vous assurer que vos modifications sont conservées et alignées sur la logique de votre application.

Utiliser un projet existant

Vous pouvez également demander à l'agent Google AI Studio de provisionner Cloud Firestore dans un projet Google Cloud existant dont vous êtes propriétaire. Demandez à l'agent d'utiliser votre projet existant avec une requête telle que :

Add Firestore to this app using project PROJECT_ID.

• Une nouvelle base de données Cloud Firestore sera provisionnée dans ce projet en utilisant le quota partagé.
• Firebase Authentication sera configuré avec Se connecter avec Google.
• Un compte de service aura accès à votre base de données Cloud Firestore. Pour autoriser l'accès administrateur depuis Google AI Studio, un nouveau compte de service nommé ais-sandbox@PROJECT_ID.iam.gservice.com sera autorisé à accéder à votre base de données Cloud Firestore. Ce compte n'est associé qu'à vos applications Google AI Studio.
• Limites : si le projet Firebase dispose déjà d'une base de données Cloud Firestore, l'agent ne pourra pas en ajouter une autre. Vous devrez créer un projet vide à utiliser.

Utiliser la console Firebase

Vous pouvez consulter les données et les paramètres de votre application dans la console Firebase. Pour accéder à vos projets associés à Google AI Studio, procédez comme suit :

1. Accédez à la consoleFirebase, puis sélectionnez le projet intitulé AI Studio.
2. Dans le panneau de navigation de gauche, cliquez sur Compiler > Base de données Cloud Firestore pour afficher et modifier vos données dans Cloud Firestore, ou cliquez sur Compiler > Authentication pour configurer vos paramètres et données Authentication.

Dépannage et questions fréquentes

Trouvez les réponses aux questions fréquentes et découvrez comment résoudre les problèmes lors de l'intégration de Firebase à votre application Google AI Studio.

Quelles méthodes d'authentification sont acceptées ?

L'agent Google AI Studio configure la connexion avec Google lorsque vous utilisez la fonctionnalité Ajouter un backend Firebase. Pour configurer des méthodes supplémentaires, activez-les dans la console Firebase et demandez à l'agent Google AI Studio de vous aider à mettre à jour votre code.

Qu'est-ce que le fichier firebase-blueprint.json ?

Il s'agit d'un fichier intermédiaire utilisé par l'agent Google AI Studio pour comprendre la base de code de votre application. Ne modifiez pas ce fichier manuellement, car cela pourrait entraîner la génération d'un code incorrect ou d'un Security Rules non sécurisé par l'agent.

Que faire si le message d'erreur "Quota dépassé" s'affiche ?

Si vous atteignez une limite de quota de Cloud Firestore, cela signifie que votre application a atteint sa limite d'utilisation quotidienne pour votre groupe de quotas partagés de base de données Cloud Firestore. Pour résoudre ce problème, vous disposez de deux options :

• Option 1 : Attendre : les quotas sont réinitialisés tous les jours vers minuit (heure du Pacifique).
• Option 2 : Passer à un forfait supérieur : passez au forfait Blaze avec paiement à l'usage.
  • Si l'agent Google AI Studio a configuré Cloud Firestore pour vous, vous devez ensuite utiliser la commande curl décrite dans Ajouter la facturation pour obtenir plus de quota Cloud Firestore afin de faire passer votre base de données à un état payant normal. Si vous configurez Cloud Firestore manuellement, il n'est pas nécessaire d'exécuter la commande curl.

Que faire si je reçois le message d'erreur "Autorisations manquantes ou insuffisantes" ?

Cette erreur se produit lorsque votre application tente de lire ou d'écrire des données dans votre base de données Cloud Firestore, mais que la requête est rejetée par votre Security Rules. Cela indique que les Security Rules n'autorisent pas l'opération tentée en fonction de l'état d'authentification ou du chemin d'accès aux données actuels. Cliquez sur le bouton Corriger l'erreur pour inviter l'agent Google AI Studio à tenter de corriger Security Rules.

Qu'advient-il de mon backend Firebase lorsque je supprime mon application Google AI Studio ?

La suppression de votre application dans Google AI Studio n'entraîne pas automatiquement la suppression du projet Firebase, de la base de données Cloud Firestore ni des configurations Firebase Authentication associés.

Si vous avez ajouté un backend Firebase, vous devez accéder manuellement à la console Firebase et supprimer le projet ou nettoyer les ressources individuelles (telles que l'instance de base de données Cloud Firestore et les fournisseurs Authentication) pour vous assurer que toutes les données et configurations sont supprimées.

L'agent Google AI Studio peut-il supprimer ou modifier des données dans ma base de données Cloud Firestore ?

L'agent Google AI Studio est conçu pour vous aider à provisionner les ressources de backend nécessaires et à générer du code et Security Rules. Bien que l'agent lui-même ne puisse pas supprimer, modifier ni manipuler directement les entrées de données dans votre base de données Cloud Firestore, il peut écrire du code dans votre applet qui est conçu pour effectuer ces actions. Pour effectuer des tâches de gestion des données, comme supprimer des entrées, accédez à la page de la base de données Cloud Firestore dans la console Firebase.

J'appartiens à une organisation qui utilise Google Cloud. Puis-je associer mon application Google AI Studio à un projet existant dans l'environnement Google Cloud de mon organisation ?

Assurez-vous que votre projet Firebase est placé dans un dossier d'organisation Google Cloud spécifique :

1. Créez votre projet Firebase manuellement à l'avance.

2. Lorsque vous configurez votre backend Firebase dans Google AI Studio, demandez à l'agent d'utiliser votre projet existant :

   Add Firestore to this app using project PROJECT_ID.
   

Pourquoi ne puis-je pas trouver certains documents dans la console Firebase ?

Lorsque l'agent AI Studio enregistre des données dans un chemin imbriqué (comme /users/user1/messages/msg1) sans créer d'abord le document parent (user1), il crée ce que l'on appelle un document parent inexistant. Ces documents ne s'affichent pas dans la console Firebase, ce qui peut les rendre difficiles à trouver lorsque vous parcourez votre base de données Cloud Firestore. Bien que cela n'affecte pas le fonctionnement de votre application, vous pouvez souvent décrire le problème à l'agent AI Studio pour l'inciter à créer les documents parents manquants.

Pour en savoir plus, consultez Documents parents inexistants.

Comment l'emplacement de ma base de données Cloud Firestore est-il choisi ?

Actuellement, l'emplacement de votre base de données Cloud Firestore est sélectionné automatiquement en fonction de votre emplacement. Vous ne pouvez pas le modifier ni le spécifier manuellement. Si vous souhaitez pouvoir choisir un lieu spécifique, faites-le nous savoir en accédant à Paramètres > Envoyer des commentaires dans Google AI Studio.

Comment Google utilise-t-il mes données (par exemple, le code et les requêtes) dans Google AI Studio ?

Pour en savoir plus sur l'utilisation de vos données, consultez les Conditions d'utilisation supplémentaires de l'API Gemini.