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

Google AI Studio lässt sich direkt in Cloud Firestore und Firebase Authentication einbinden. So können Sie Anwendungen mit persistenten Daten und sicheren Anmeldeabläufen erstellen. Wenn Sie in Google AI Studio die Funktion „Firebase-Backend hinzufügen“ verwenden, generiert der Agent den erforderlichen Code und verbindet Ihre App mit einem Firebase-Projekt.

Ü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 (z. B. „Eine gemeinsame Aufgabenliste erstellen“).

2. Firebase-Integration aktivieren: Wählen Sie den Chip Firebase-Backend hinzufügen aus. Der Agent generiert den erforderlichen Code, einschließlich einer /src/lib/firebase.ts-Datei und einer firestore.rules-Datei, und verbindet Ihre App dann mit Cloud Firestore und Firebase Authentication.

3. Bereitstellen: Wenn Sie bereit sind, können Sie Ihre App über Teilen > Veröffentlichen in Cloud Run bereitstellen.

Gemeinsames Kontingent für Cloud Firestore

Alle Cloud Firestore-Datenbanken, die vom Agent in Google AI Studio bereitgestellt werden, werden in Ihrem Firebase-Projekt in derselben Datenbankgruppe platziert. Sie alle haben folgende Merkmale:

• Gemeinsames Kontingent: Alle Datenbanken in der Gruppe teilen sich ein Nutzungskontingent (siehe Details 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 Limits:

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

Wenn Ihre App an Popularität 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 verwenden Cloud Firestore-Datenbanken, die vom Google AI Studio-Agent erstellt wurden, weiterhin das gemeinsame Kontingent, auch nachdem Sie Ihr Preismodell aktualisiert haben. Wenn Sie die vollständige kostenpflichtige Skalierung für eine bestimmte Datenbank aktivieren möchten, müssen Sie sie manuell aus der Gruppe entfernen. Verwenden Sie dazu den Befehl curl.

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

Security Rules-Generierung

Google AI Studio 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, damit 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

Die Daten und Einstellungen Ihrer App können Sie in der Firebase-Konsole einsehen. 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, oder auf Erstellen > Authentication, 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.

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 Ihres Quellcodes.

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 das Cloud Firestore-Kontingentlimit erreicht wird, hat Ihre App das tägliche Nutzungslimit für die gemeinsame Kontingentgruppe Ihrer Cloud Firestore-Datenbank 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 kostenpflichtigen 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. Dies weist darauf hin, 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 Daten 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. Daher sind sie beim Durchsuchen Ihrer Cloud Firestore-Datenbank schwer zu finden. 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.

Wie wird der Speicherort für meine Cloud Firestore-Datenbank ausgewählt?

Der Speicherort für Ihre Cloud Firestore-Datenbank wird derzeit automatisch anhand Ihres Standorts ausgewählt und kann nicht geändert oder manuell angegeben werden. Wenn Sie einen bestimmten Ort auswählen möchten, teilen Sie uns dies bitte mit. Gehen Sie dazu in Google AI Studio zu den Einstellungen > Feedback geben.

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.