Dodawanie Cloud Firestore i uwierzytelniania do aplikacji Google AI Studio

Tryb tworzenia w Google AI Studio może automatycznie skonfigurować i zintegrować Cloud Firestore i Firebase Authentication z aplikacjami internetowymi, co ułatwia tworzenie aplikacji z trwałym przechowywaniem danych i bezpiecznymi procesami logowania.Google AI Studio Za pomocą jednego prompta i kilku kliknięć możesz upoważnić agenta Google AI Studio do skonfigurowania projektu Firebase, połączenia z nim aplikacji i wygenerowania całego kodu Cloud Firestore i Authentication bezpośrednio w aplikacji.

Omówienie: dodawanie backendu do aplikacji Google AI Studio

  1. Opisz swój pomysł: utwórz nową aplikację w Google AI Studio i opisz funkcję, która wymaga bazy danych lub uwierzytelniania. Możesz na przykład wpisać prompta: Build a shared to-do list app using Firebase as a backend.

  2. Włącz integrację z Firebase: na wyświetlonej karcie skonfiguruj ustawienia:

    • Dostosuj projekt lub lokalizację (opcjonalnie): kliknij ikonę Ustawienia , a następnie wybierz lokalizację lub projekt Google Cloud, którego chcesz użyć.
    • Potwierdź swój wybór: aby kontynuować, kliknij przycisk Włącz Firebase.

    Agent automatycznie połączy aplikację z projektem w Firebase i wygeneruje niezbędny Cloud Firestore i Authentication kod, w tym plik /src/lib/firebase.ts i plik firestore.rules.

  3. Wdróż: gdy wszystko będzie gotowe, użyj opcji Udostępnij > Opublikuj , aby wdrożyć aplikację internetową w Cloud Run. Aplikacja zostanie automatycznie wdrożona w tym samym projekcie, który został wybrany podczas konfiguracji.

    Zanim udostępnisz lub wdrożysz aplikację, sprawdź też wygenerowane przez AI Firebase Security Rules.

Dodawanie Firebase do aplikacji podczas programowania

Jeśli chcesz dodać integrację z Firebase do aplikacji, nad którą pracujesz w Google AI Studio, możesz to zrobić w dowolnym momencie fazy iteracji, korzystając z jednej z tych opcji:

  • Porozmawiaj z agentem: poproś agenta o dodanie funkcji, która wymaga bazy danych lub uwierzytelniania (np. Add a Firestore database to this app).
  • Użyj menu ustawień: kliknij Ustawienia > Integracje i wybierz kafelek Firebase Firestore & Auth.

Obie opcje uruchomią proces konfiguracji integracji z Firebase, co pozwoli Ci na wybranie projektu, skonfigurowanie lokalizacji backendu i włączenie integracji w aplikacji zgodnie z opisem w omówieniu.

Gdy integracja zostanie włączona, możesz w dowolnym momencie sprawdzić jej konfigurację, w tym projekt, lokalizację, adres e-mail pomocy dotyczącej aplikacji i identyfikator bazy danych. Aby to zrobić, kliknij Ustawienia > Integracje i wybierz kafelek Firebase Firestore & Auth.

Informacje o wspólnym limicie Cloud Firestore

W zależności od tego, kiedy została utworzona aplikacja i czy Twoje konto spełnia wymagania, Twoje bazy danych mogą być hostowane w projekcie Google Cloud w ramach bezpłatnego okresu próbnego lub w projekcie standardowym. W obu przypadkach wszystkie Cloud Firestore bazy danych udostępnione przez agenta Google AI Studio są umieszczane w tej samej "Wspólny limit AI" grupie baz danych w Twoim projekcie. Wszystkie mają te same cechy:

  • Wspólny limit: wszystkie bazy danych w grupie mają wspólny limit wykorzystania (szczegóły poniżej).
  • Nie jest wymagane konto Cloud Billing: możesz tworzyć i testować aplikację bez dodawania płatności. Szczegóły dotyczące opcjonalnego dodawania płatności znajdziesz poniżej.
  • Codzienne resetowanie: jeśli osiągniesz dzienny limit (np. 50 tys. odczytów dziennie), usługa zostanie wstrzymana we wszystkich bazach danych w grupie i wznowiona następnego dnia około północy czasu pacyficznego.

Cloud Firestore bazy danych w grupie wspólnego limitu mają te same limity:

Dane Limit
Przechowywane dane Łącznie 1 GiB
Ruch wychodzący z sieci 10 GiB miesięcznie
Zapis jednostek 40 tys. zapisów dziennie
Odczyt jednostek 50 tys. odczytów dziennie
Jednostki aktualizacji w czasie rzeczywistym 50 tys. aktualizacji dziennie

(Opcjonalnie) Dodawanie płatności, aby zwiększyć limit Cloud Firestore

Jeśli Twoja aplikacja zyskuje popularność i musisz przekroczyć bezpłatne limity dla Cloud Firestore, możesz dodać płatności, co spowoduje przejście projektu w Firebase na abonament Blaze z płatnością według wykorzystania.

Płatności mogły zostać już dodane do projektu z różnych powodów, np. aby korzystać z Nano Banana. W takim przypadku projekt jest już objęty abonamentem Blaze i możesz przejść bezpośrednio do kroku Uaktualnij bazę danych.

Krok 1. Dodaj płatności (jeśli nie zostały jeszcze dodane)

Płatności możesz skonfigurować bezpośrednio w Google AI Studio.

  1. W Google AI Studio otwórz stronę Projekty.
  2. Obok projektu, który chcesz uaktualnić, kliknij Skonfiguruj rozliczenia.
  3. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby wybrać kraj, zaakceptować warunki i dodać formę płatności lub wybrać istniejące konto rozliczeniowe. Możesz też zostać poproszony(-a) o przedpłatę (która nie jest zaliczana na poczet korzystania z usług Firebase i Google Cloud usług).

Krok 2. Uaktualnij bazę danych

Nawet po dodaniu płatności bazy danych utworzone przez agenta Google AI Studio pozostają w grupie wspólnego limitu.Cloud Firestore Aby włączyć pełne skalowanie płatne w przypadku konkretnej bazy danych, musisz ją uaktualnić ręcznie.

  1. Otwórz Firebase konsolę i wybierz projekt zawierający bazę danych, którą chcesz uaktualnić.
  2. W panelu nawigacyjnym po lewej stronie kliknij Bazy danych i miejsce na dane > Firestore.
  3. Jeśli projekt zawiera kilka instancji bazy danych Cloud Firestore, wybierz tę, którą chcesz uaktualnić.
  4. U góry strony znajdź baner informujący, że baza danych podlega limitom wspólnego limitu AI. Aby ją uaktualnić, kliknij Uaktualnij bazę danych > Uaktualnij do płatności według wykorzystania. Jeśli nie widzisz tego baneru, baza danych nie została utworzona przez agenta Google AI Studio i nie jest częścią grupy współdzielonego limitu, lub została już uaktualniona.

Zmiana, która wyłączy wspólny limit i włączy płatność według wykorzystania w przypadku bazy danych, powinna zacząć obowiązywać w ciągu kilku minut.

Security Rules generowanie

Agent Google AI Studio automatycznie generuje Firebase Security Rules na podstawie logiki aplikacji. Te Security Rules są domyślnie ustawione na "odmowę", co oznacza że użytkownicy końcowi aplikacji mogą uzyskiwać dostęp tylko do danych, których są właścicielami.

Pamiętaj, że jeśli ręcznie dostosujesz swoje Security Rules bezpośrednio w konsoli Firebase, agent Google AI Studio nie będzie wiedział o zmianach, a zostaną one zastąpione podczas kolejnych iteracji aplikacji. Zalecamy używanie agenta Google AI Studio do dostosowywania Firebase Security Rules, aby mieć pewność, że zmiany zostaną zachowane i będą zgodne z logiką aplikacji.

Używanie istniejącego projektu

Gdy po raz pierwszy włączysz integrację z Firebase, możesz opcjonalnie wybrać istniejący projekt Google Cloud którego jesteś właścicielem:

  1. Na wyświetlonej karcie kliknij ikonę Ustawienia .
  2. Wybierz projekt, a następnie kliknij Włącz Firebase.

Podczas iteracji aplikacji możesz też poprosić agenta o użycie innego projektu za pomocą prompta, np.:

Add Firestore to this app using project PROJECT_ID.

Gdy wybierzesz projekt, wykonane zostaną te działania:

  • W tym projekcie zostanie udostępniona nowa baza danych Cloud Firestore z wykorzystaniem wspólnego limitu.
  • Firebase Authentication z logowaniem przez Google zostanie skonfigurowane.
  • Konto usługi otrzyma dostęp do Twojej b1/} bazy danych.Cloud Firestore Aby umożliwić dostęp administratora z Google AI Studio, nowe konto usługi o nazwie ais-sandbox@PROJECT_ID.iam.gservice.com otrzyma uprawnienia dostępu do bazy danych Cloud Firestore. To konto jest powiązane tylko z aplikacjami Google AI Studio.
  • Ograniczenia: jeśli projekt w Firebase ma już Cloud Firestore bazę danych, agent nie będzie mógł dodać kolejnej. Musisz wybrać inny projekt lub utworzyć nowy, pusty projekt.

Korzystanie z konsoli Firebase

Dane i ustawienia aplikacji możesz wyświetlać w konsoli Firebase. Aby uzyskać dostęp do projektu w Firebase powiązanego z Google AI Studio:

  1. Otwórz Firebase konsolę i wybierz projekt z etykietą AI Studio.

  2. W panelu nawigacyjnym po lewej stronie sprawdź usługi włączone w projekcie:

    • Aby wyświetlić i edytować przechowywane dane Cloud Firestore, kliknij Bazy danych i miejsce na dane > Firestore.
    • Aby wyświetlić lub skonfigurować ustawienia i dane Authentication, kliknij Zabezpieczenia > Uwierzytelnianie.

Rozwiązywanie problemów i najczęstsze pytania

Poznaj odpowiedzi na typowe pytania i dowiedz się, jak rozwiązywać problemy podczas integrowania Firebase z aplikacją Google AI Studio.

Jak wybierany jest projekt w Firebase i lokalizacja Google Cloud / Firebase?

Gdy poprosisz o backend Firebase dla aplikacji, możesz opcjonalnie wybrać lokalizację i projekt na wyświetlonej karcie:

  • Dostosuj projekt lub lokalizację (opcjonalnie): kliknij ikonę Ustawienia , wybierz lokalizację lub projekt Google Cloud, którego chcesz użyć, a następnie kliknij Włącz Firebase.

Pamiętaj:

  • Lokalizacja bazy danych jest trwała: po wybraniu lokalizacji bazy danych nie można jej zmienić w tym projekcie. Ten wybór będzie używany jako domyślny w przypadku innych usług backendu.
  • Spójność projektu: aby zapewnić płynną integrację, Google AI Studio automatycznie używa tego samego projektu zarówno w przypadku backendu, jak i wdrożenia. W tej samej aplikacji nie można używać różnych projektów w przypadku różnych usług.

Jakie metody uwierzytelniania są obsługiwane?

Agent Google AI Studio konfiguruje logowanie przez Google, gdy poprosisz o skonfigurowanie Authentication lub ekranu logowania. Aby dodać do aplikacji dodatkowe metody logowania:

  1. W konsoli Firebase otwórz stronę Zabezpieczenia > Uwierzytelnianie > Metoda logowania, i skonfiguruj wybrane metody logowania.

  2. Wróć do Google AI Studio i poproś agenta Google AI Studio o pomoc w zaktualizowaniu bazy kodu o nową metodę logowania.

Czy mogę utworzyć aplikację mobilną (np. na Androida lub iOS) za pomocą Google AI Studio?

Agent Google AI Studio obsługuje tworzenie zarówno aplikacji internetowych , jak i aplikacji na Androida.

Pamiętaj jednak, że integracja z Firebase (dodawanie Cloud Firestore i Authentication) jest obecnie obsługiwana tylko w przypadku aplikacji internetowych, a nie aplikacji na Androida. Jeśli tworzysz aplikację na Androida i potrzebujesz tych usług, musisz zintegrować Firebase ręcznie.

Więcej informacji o tym, co jest obsługiwane, znajdziesz w Google AI Studio dokumentacji agenta.

Pamiętaj jednak, że tak jak wszystkie aplikacje internetowe, aplikacje internetowe utworzone przez Google AI Studio są dostępne jako mobilne aplikacje internetowe w przeglądarkach zainstalowanych na urządzeniach mobilnych.

Co to jest plik firebase-blueprint.json?

Jest to plik pośredni używany przez agenta Google AI Studio do rozpoznawania bazy kodu aplikacji. Nie modyfikuj tego pliku ręcznie, ponieważ może to spowodować, że agent wygeneruje nieprawidłowy kod lub niezabezpieczone Security Rules.

Co zrobić, jeśli pojawi się błąd „Przekroczono limit”?

Osiągnięcie limitu Cloud Firestore oznacza, że aplikacja osiągnęła dzienny limit wykorzystania w przypadku grupy wspólnego limitu bazy danych Cloud Firestore. Ten problem można rozwiązać na 2 sposoby:

  • Opcja 1. Poczekaj: limity są resetowane codziennie około północy czasu pacyficznego.
  • Opcja 2. Uaktualnij: przejdź na abonament Blaze z płatnością według wykorzystania.
    • Jeśli agent Google AI Studio skonfigurował dla Ciebie Cloud Firestore, musisz następnie użyć przycisku Uaktualnij bazę danych opisanego w Dodawanie płatności, aby zwiększyć limit Cloud Firestore, aby przenieść bazę danych do zwykłego stanu płatnego. Jeśli skonfigurowano Cloud Firestore ręcznie, użycie przycisku Uaktualnij bazę danych nie jest konieczne.

Co zrobić, jeśli pojawi się błąd „Brak uprawnień lub niewystarczające uprawnienia”?

Ten błąd występuje, gdy aplikacja próbuje odczytać lub zapisać dane w bazie danych Cloud Firestore, ale żądanie zostaje odrzucone przez Security Rules. Oznacza to, że Security Rules nie zezwalają na próbę wykonania operacji na podstawie bieżącego stanu uwierzytelniania lub ścieżki danych. Kliknij przycisk Napraw błąd, aby poprosić agenta Google AI Studio o próbę poprawienia Security Rules.

Co się stanie z moim backendem Firebase, gdy usunę aplikację Google AI Studio?

Usunięcie aplikacji w Google AI Studio nie spowoduje automatycznego usunięcia połączonego projektu w Firebase, Cloud Firestore bazy danych ani Firebase Authentication konfiguracji.

Jeśli dodasz backend Firebase, musisz ręcznie otworzyć Firebase konsolę i usunąć projekt lub wyczyścić poszczególne zasoby (np. Cloud Firestore instancję bazy danych i Authentication dostawców), aby usunąć wszystkie dane i konfiguracje.

Czy agent Google AI Studio może usuwać lub edytować dane w mojej bazie danych Cloud Firestore?

Agent Google AI Studio został zaprojektowany, aby pomagać w udostępnianiu niezbędnych zasobów backendu oraz generowaniu kodu i Security Rules. Chociaż agent nie może bezpośrednio usuwać, edytować ani manipulować wpisami danych w bazie danych Cloud Firestore, może napisać kod w aplikacji, który będzie wykonywać te działania. Aby wykonywać zadania związane z zarządzaniem danymi, takie jak usuwanie wpisów, otwórz stronę Bazy danych i miejsce na dane > Firestore w konsoli Firebase.

Należę do organizacji, która korzysta z Google Cloud. Czy mogę połączyć aplikację Google AI Studio z istniejącym projektem w środowisku Google Cloud mojej organizacji?

Tak. Upewnij się, że projekt Firebase znajduje się w folderze organizacji Google Cloud, a następnie połącz projekt za pomocą jednej z tych metod:Google Cloud

  • Podczas włączania: gdy po raz pierwszy włączysz integrację z Firebase w Google AI Studio, wybierz istniejący projekt na wyświetlonej karcie. Kliknij ikonę Ustawienia i wybierz projekt.

  • Podczas iteracji: jeśli Firebase został już włączony lub chcesz później zmienić projekt, możesz poprosić agenta o użycie istniejącego projektu za pomocą prompta, np.:

      Add Firestore to this app using project PROJECT_ID.

Dlaczego nie mogę znaleźć niektórych dokumentów w konsoli Firebase?

Gdy agent AI Studio zapisuje dane w zagnieżdżonej ścieżce (np. /users/user1/messages/msg1) bez wcześniejszego utworzenia dokumentu nadrzędnego (user1), tworzy tzw. nieistniejący dokument nadrzędny. Te dokumenty nie są wyświetlane w konsoli Firebase, co może utrudniać ich znalezienie podczas przeglądania bazy danych Cloud Firestore. Nie ma to wpływu na działanie aplikacji, ale często możesz opisać problem agentowi AI Studio, aby poprosić go o utworzenie brakujących dokumentów nadrzędnych.

Więcej informacji znajdziesz w artykule Nieistniejące dokumenty nadrzędne.

Czy mogę wybrać lokalizację bazy danych Cloud Firestore?

Tak. Gdy po raz pierwszy włączysz integrację z Firebase w Google AI Studio, możesz wybrać lokalizację bazy danych Cloud Firestore.

Pamiętaj, że wybrana lokalizacja dotyczy wszystkich Cloud Firestore baz danych, które agent Google AI Studio utworzy w tym projekcie w Firebase. Po ustawieniu nie można zmienić lokalizacji tych baz danych.

Czy po uaktualnieniu bazy danych Cloud Firestore mogę przywrócić ją do grupy wspólnego limitu?

Gdy baza danych zostanie przeniesiona poza grupę wspólnego limitu i przekształcona w zwykłą instancję płatną, możesz użyć polecenia curl, aby przywrócić ją do grupy wspólnego limitu. Pamiętaj, że wszystkie bazy danych w grupie wspólnego limitu muszą być w tej samej wersji i znajdować się w tym samym regionie.

  • PROJECT_ID : identyfikator projektu w Firebase. Znajdziesz go w Ustawieniach > Ogólne na stronie konsoli Firebase.

  • DATABASE_ID : identyfikator bazy danych Cloud Firestore, który będzie zgodny z identyfikatorem apletu. Ten identyfikator bazy danych znajdziesz w Google AI Studio, klikając Ustawienia > Integracje i wybierając kafelek Firebase Firestore & Auth.

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": true}'

Jak Google wykorzystuje moje dane (np. kod i prompty) w Google AI Studio?

Szczegółowe informacje o tym, jak wykorzystywane są Twoje dane, znajdziesz w Dodatkowych warunkach korzystania z Gemini API.

Otrzymałem(-am) e-maila od Google Cloud z informacją o "publicznie dostępnym kluczu interfejsu API Google powiązanym z projektem Google Cloud". Co muszę zrobić?

Jeśli otrzymasz e-maila od Google Cloud z informacją o "publicznie dostępnym kluczu interfejsu API Google powiązanym z projektem Google Cloud" i klucz interfejsu API wymieniony w e-mailu jest Twoim kluczem interfejsu API Firebase, upewnij się, że klucz interfejsu API spełnia te wymagania, aby można go było bezpiecznie uwzględnić w plikach kodu lub konfiguracji plików. Możesz to sprawdzić na stronie Interfejsy API i usługi > Dane logowania w konsoli Google Cloud.

Upewnij się też, że używasz Firebase Security Rules i App Check zgodnie z zaleceniami dotyczącymi używanych usług Firebase.

Szczegółowe informacje o kluczach interfejsu API Firebase i listę najczęstszych pytań znajdziesz w artykule Informacje o używaniu kluczy interfejsu API Firebase i zarządzaniu nimi.