Cloud Firestore und Authentifizierung in Ihre Google AI Studio-App einbinden

Im Build-Modus in Google AI Studio können Cloud Firestore und Firebase Authentication automatisch eingerichtet und in Web-Apps eingebunden werden. So lassen sich Apps mit persistentem Datenspeicher und sicheren Anmeldeabläufen einfacher erstellen. Mit nur einem Prompt und wenigen Klicks kann der Google AI Studio-Agent ein Firebase-Projekt einrichten, Ihre App mit diesem Projekt verbinden und den gesamten Cloud Firestore- und Authentication-Code direkt in Ihrer App generieren.

Übersicht: Backend zu Ihrer Google AI Studio App hinzufügen

1. Idee beschreiben: Erstellen Sie eine neue App in Google AI Studio und beschreiben Sie eine Funktion, für die eine Datenbank oder Authentifizierung erforderlich ist. Sie könnten beispielsweise den folgenden Prompt eingeben: Build a shared to-do list app using Firebase as a backend.

2. Firebase-Integration aktivieren: Wenn Sie vom Agent dazu aufgefordert werden, aktivieren Sie Firebase, wählen Sie einen Speicherort für Ihr Projekt aus und akzeptieren Sie die Firebase-Nutzungsbedingungen. Der Agent verbindet Ihre App dann automatisch mit Ihrem Firebase-Projekt und generiert den erforderlichen Cloud Firestore- und Authentication-Code für Ihre App, einschließlich einer /src/lib/firebase.ts-Datei und einer firestore.rules-Datei.

3. Bereitstellen: Wenn Sie bereit sind, verwenden Sie die Option Teilen > Veröffentlichen, um Ihre Web-App in Cloud Run bereitzustellen.

• Gemeinsames Kontingent: Alle Datenbanken in der Gruppe teilen sich ein Nutzungskontingent (Details siehe unten).
• Kein Cloud Billing-Konto erforderlich: Sie können Ihre App erstellen und testen, ohne die Abrechnung hinzuzufügen. Unten finden Sie weitere Informationen zum optionalen Hinzufügen der Abrechnung.
• Tägliche Zurücksetzung: Wenn Sie ein Tageskontingentlimit erreichen (z. B. 50.000 Lesevorgänge pro Tag), wird der Dienst für alle Datenbanken in der Gruppe pausiert und am nächsten Tag gegen Mitternacht (Pacific Time) fortgesetzt.

Für Cloud Firestore-Datenbanken in der gemeinsamen Kontingentgruppe gelten die folgenden Einschränkungen:

Optional: Abrechnung hinzufügen, um mehr Cloud Firestore-Kontingent zu erhalten

Wenn Ihre App an Bedeutung gewinnt und Sie die kostenlosen Limits für Cloud Firestore überschreiten, können Sie ein Upgrade Ihres Projekts auf den Blaze-Tarif (Pay as you go) durchführen.

1. Abrechnung hinzufügen (falls noch nicht geschehen): Rufen Sie die Firebase-Konsole auf und verknüpfen Sie ein Rechnungskonto mit Ihrem Projekt.

2. Datenbank aktualisieren: Standardmäßig wird für Cloud Firestore-Datenbanken, die vom Google AI Studio-Agent erstellt wurden, weiterhin das gemeinsame Kontingent verwendet, auch nachdem Sie Ihren Tarif aktualisiert haben. Wenn Sie die vollständige kostenpflichtige Skalierung für eine bestimmte Datenbank aktivieren möchten, müssen Sie sie manuell mit dem Befehl curl aus der Gruppe entfernen.

   • PROJECT_ID : Firebase-Projekt-ID. Sie finden diese ID in den Projekteinstellungen der Firebase-Konsole.

   • DATABASE_ID : Die Cloud Firestore-Datenbank-ID, die mit Ihrer Applet-ID übereinstimmt. Sie finden diese Datenbank-ID in der Spalte Name auf der Seite Cloud Firestore-Datenbanken in der Firebase-Konsole.

   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=free_tier_limited" \
   -d '{"free_tier_limited": false}'
   

Security Rules-Generierung

Der Google AI Studio-Agent generiert automatisch Firebase Security Rules basierend auf der Logik Ihrer App. Diese Security Rules sind so konzipiert, dass sie standardmäßig verweigert werden. Das bedeutet, dass Endnutzer Ihrer App nur auf die Daten zugreifen können, die ihnen gehören.

Wenn Sie Security Rules manuell direkt in der Firebase-Konsole anpassen, werden die Änderungen vom Google AI Studio-Agent nicht erkannt und bei nachfolgenden App-Iteration überschrieben. Wir empfehlen, den Google AI Studio-Agenten zu verwenden, um Firebase Security Rules anzupassen. So wird sichergestellt, dass Ihre Änderungen beibehalten werden und der Logik Ihrer App entsprechen.

Vorhandenes Projekt verwenden

Sie können den Google AI Studio-Kundenservicemitarbeiter auch bitten, Cloud Firestore in einem vorhandenen Google Cloud-Projekt bereitzustellen, dessen Inhaber Sie sind. Weisen Sie den Agenten mit einem Prompt wie dem folgenden an, Ihr vorhandenes Projekt zu verwenden:

Add Firestore to this app using project PROJECT_ID.

• In diesem Projekt wird eine neue Cloud Firestore-Datenbank mit dem freigegebenen Kontingent bereitgestellt.
• Firebase Authentication wird mit der Google-Anmeldung konfiguriert.
• Ein Dienstkonto erhält Zugriff auf Ihre Cloud Firestore-Datenbank. Damit der Administratorzugriff von Google AI Studio aus möglich ist, wird einem neuen Dienstkonto mit dem Namen ais-sandbox@PROJECT_ID.iam.gservice.com die Berechtigung zum Zugriff auf Ihre Cloud Firestore-Datenbank erteilt. Dieses Konto ist nur mit Ihren Google AI Studio-Apps verknüpft.
• Einschränkungen: Wenn das Firebase-Projekt bereits eine Cloud Firestore-Datenbank hat, kann der Agent keine weitere hinzufügen. Sie müssen ein neues, leeres Projekt erstellen, das Sie verwenden können.

Firebase-Konsole verwenden

Sie können die Daten und Einstellungen Ihrer App in der Firebase-Konsole ansehen. So greifen Sie auf Ihre Projekte zu, die mit Google AI Studio verknüpft sind:

1. Rufen Sie die Firebase-Konsole auf und wählen Sie das Projekt mit dem Label AI Studio aus.

2. Klicken Sie im linken Navigationsbereich auf Erstellen > Cloud Firestore Database, um Ihre Daten in Cloud Firestore aufzurufen und zu bearbeiten. Alternativ können Sie auf Erstellen > Authentication klicken, um die Einstellungen und Daten für Authentication zu konfigurieren.

Fehlerbehebung und häufig gestellte Fragen

Hier finden Sie Antworten auf häufig gestellte Fragen und Informationen zur Fehlerbehebung bei der Integration von Firebase in Ihre Google AI Studio-App.

Wie wird mein Google Cloud-/Firebase-Projekt ausgewählt?

Wenn Sie die Funktion Firebase-Backend hinzufügen verwenden, wählt der Google AI Studio-Agent automatisch ein Firebase-Projekt für die Backend-Dienste Ihrer App aus (Cloud Firestore und Firebase Authentication).

Wenn Sie stattdessen ein bestimmtes Projekt verwenden möchten, können Sie den Agent mit einem Prompt wie dem folgenden anweisen, dies zu tun:

Use project PROJECT_ID for the Firebase backend.

Wenn Sie Ihre App später auf Cloud Run veröffentlichen möchten, ist es wichtig, dass Sie dieses Projekt weiterhin verwenden. Wenn Sie ein anderes Projekt auswählen, treten Fehler auf, da es nicht mit dem Projekt übereinstimmt, das für Ihr Backend verwendet wird.

Welche Authentifizierungsmethoden werden unterstützt?

Der Google AI Studio-Agent richtet die Google-Anmeldung ein, wenn Sie die Funktion Firebase-Backend hinzufügen verwenden. Wenn Sie zusätzliche Methoden einrichten möchten, aktivieren Sie sie in der Firebase-Konsole und bitten Sie den Google AI Studio-Agenten um Unterstützung bei der Aktualisierung Ihrer Codebasis.

Kann ich mit Google AI Studio eine mobile App (z. B. für Android oder iOS) erstellen?

Derzeit kann der KI-Agent Google AI Studio nur Web-Apps erstellen. Weitere Informationen zu den unterstützten Funktionen finden Sie in der Google AI Studio-Agent-Dokumentation.

Wie bei allen Web-Apps kann jedoch auch auf die von Google AI Studio erstellten Apps über Browser, die auf Mobilgeräten installiert sind, als mobile Web-Apps zugegriffen werden.

Was ist die Datei firebase-blueprint.json?

Dies ist eine Zwischendatei, die vom Google AI Studio-Agenten verwendet wird, um die Codebasis Ihrer App zu verstehen. Bearbeiten Sie diese Datei nicht manuell, da dies dazu führen kann, dass der Agent falschen Code oder unsichere Security Rules generiert.

Was kann ich tun, wenn ich die Fehlermeldung „Kontingent überschritten“ erhalte?

Wenn Sie ein Cloud Firestore-Kontingentlimit erreichen, hat Ihre App das tägliche Nutzungslimit für Ihre gemeinsame Cloud Firestore-Datenbankkontingentgruppe erreicht. Es gibt zwei Möglichkeiten, dieses Problem zu beheben:

• Option 1: Warten: Kontingente werden täglich gegen Mitternacht (Pacific Time) zurückgesetzt.
• Option 2: Upgrade: Führen Sie ein Upgrade auf den Blaze-Tarif (Pay as you go) durch.
  • Wenn der Google AI Studio-Agent die Cloud Firestore für Sie eingerichtet hat, müssen Sie den in Abrechnung hinzufügen, um mehr Cloud Firestore-Kontingent zu erhalten beschriebenen curl-Befehl verwenden, um Ihre Datenbank in einen regulären bezahlten Status zu versetzen. Wenn Sie Cloud Firestore manuell einrichten, ist die Ausführung des Befehls curl nicht erforderlich.

Was kann ich tun, wenn ich die Fehlermeldung „Fehlende oder unzureichende Berechtigungen“ erhalte?

Dieser Fehler tritt auf, wenn Ihre App versucht, Daten in Ihre Cloud Firestore-Datenbank zu lesen oder zu schreiben, die Anfrage jedoch von Ihrer Security Rules abgelehnt wird. Das bedeutet, dass die Security Rules den versuchten Vorgang aufgrund des aktuellen Authentifizierungsstatus oder Datenpfads nicht zulassen. Klicken Sie auf die Schaltfläche Fehler beheben, damit der Google AI Studio-Agent versucht, den Security Rules zu korrigieren.

Was passiert mit meinem Firebase-Backend, wenn ich meine Google AI Studio-App lösche?

Wenn Sie Ihre Anwendung in Google AI Studio löschen, werden das verknüpfte Firebase-Projekt, die Cloud Firestore-Datenbank oder die Firebase Authentication-Konfigurationen nicht automatisch gelöscht.

Wenn Sie ein Firebase-Backend hinzugefügt haben, müssen Sie manuell zur Firebase-Konsole gehen und das Projekt löschen oder einzelne Ressourcen (z. B. die Cloud Firestore-Datenbankinstanz und Authentication-Anbieter) bereinigen, um sicherzustellen, dass alle Daten und Konfigurationen entfernt werden.

Kann der Google AI Studio-Agent Daten in meiner Cloud Firestore-Datenbank löschen oder bearbeiten?

Der Google AI Studio-Agent wurde entwickelt, um die erforderlichen Backend-Ressourcen bereitzustellen und Code und Security Rules zu generieren. Der Agent selbst kann Dateneinträge in Ihrer Cloud Firestore-Datenbank nicht direkt löschen, bearbeiten oder manipulieren, aber er kann Code in Ihr Applet schreiben, der für diese Aktionen entwickelt wurde. Wenn Sie Datenverwaltungsaufgaben wie das Löschen von Einträgen ausführen möchten, rufen Sie in der Firebase-Konsole die Seite Cloud Firestore-Datenbank auf.

Ich gehöre einer Organisation an, die Google Cloud verwendet. Kann ich meine Google AI Studio App mit einem vorhandenen Projekt in der Google Cloud-Umgebung meiner Organisation verknüpfen?

Achten Sie darauf, dass sich Ihr Firebase-Projekt in einem bestimmten Google CloudOrganisationsordner befindet:

1. Erstellen Sie Ihr Firebase-Projekt manuell im Voraus.

2. Wenn Sie Ihr Firebase-Backend in Google AI Studio einrichten, weisen Sie den Agent an, Ihr vorhandenes Projekt zu verwenden:

   Add Firestore to this app using project PROJECT_ID.
   

Warum kann ich bestimmte Dokumente in der Firebase-Konsole nicht finden?

Wenn der AI Studio-Agent Daten in einem verschachtelten Pfad (z. B. /users/user1/messages/msg1) speichert, ohne zuerst das übergeordnete Dokument (user1) zu erstellen, wird ein nicht vorhandenes übergeordnetes Dokument erstellt. Diese Dokumente werden nicht in der Firebase-Konsole angezeigt. Das kann die Suche in Ihrer Cloud Firestore-Datenbank erschweren. Dies hat zwar keine Auswirkungen auf die Ausführung Ihrer App, aber Sie können das Problem dem AI Studio-Agenten beschreiben, damit er die fehlenden übergeordneten Dokumente erstellt.

Weitere Informationen finden Sie unter Nicht vorhandene übergeordnete Dokumente.

Kann ich den Speicherort für meine Cloud Firestore-Datenbank auswählen?

Ja. Wenn Sie die Firebase-Integration in Google AI Studio zum ersten Mal aktivieren, können Sie den Speicherort für Ihre Cloud Firestore-Datenbank auswählen.

Der von Ihnen ausgewählte Speicherort gilt für alle Cloud Firestore-Datenbanken, die der Google AI Studio-Agent in diesem Firebase-Projekt erstellt. Einmal festgelegt, kann dieser Speicherort für diese Datenbanken nicht mehr geändert werden.

Wie verwendet Google meine Daten (z. B. Code und Prompts) in Google AI Studio?

Weitere Informationen dazu, wie Ihre Daten verwendet werden, finden Sie in den Zusatzbedingungen für die Gemini API.

Ich habe eine E-Mail von Google Cloud mit dem Betreff „Öffentlich zugänglicher Google API-Schlüssel für Ihr Google Cloud-Projekt“ erhalten. Was muss ich tun?

Wenn Sie von Google Cloud eine E-Mail mit dem Betreff „Öffentlich zugänglicher Google-API-Schlüssel für Ihr Google Cloud-Projekt“ erhalten haben und der in der E-Mail aufgeführte API-Schlüssel Ihr Firebase-API-Schlüssel ist, muss der API-Schlüssel die folgenden Anforderungen erfüllen, damit er sicher in Ihren Code- oder Konfigurationsdateien verwendet werden kann. Sie können Folgendes in der Google Cloud Console im Bereich APIs & Dienste > Anmeldedaten überprüfen.

• Das ist der API-Schlüssel, den Sie für Ihre Firebase-App und nur für Firebase-Dienste verwenden. Diese Schlüssel werden normalerweise als Browser key (auto created by Firebase), Android key (auto created by Firebase) oder iOS key (auto created by Firebase) bezeichnet.
• Er enthält alle erforderlichen Firebase-bezogenen APIs, die in derZulassungsliste für API-Einschränkungen des Schlüssels enthalten sind.
• Es sind keine anderen APIs in der Zulassungsliste für API-Einschränkungen enthalten. Insbesondere sollte die Liste kein Generative Language API enthalten.

Achten Sie außerdem darauf, dass Sie Firebase Security Rules und App Check wie empfohlen für die von Ihnen verwendeten Firebase-Produkte verwenden.

Weitere Informationen zu API-Schlüsseln für Firebase und eine Liste mit häufig gestellten Fragen finden Sie unter API-Schlüssel für Firebase verwenden und verwalten.