Dodawanie Firebase do aplikacji Google AI Studio

Tryb tworzenia w Google AI Studio może automatycznie konfigurować i integrować Cloud Firestore i Firebase Authentication z aplikacjami internetowymi, co ułatwia tworzenie aplikacji z trwałym przechowywaniem danych i bezpiecznymi procesami logowania. Wystarczy jeden prompt i kilka kliknięć, aby umożliwić agentowi Google AI Studio skonfigurowanie projektu Firebase, połączenie z nim aplikacji i wygenerowanie 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ć prompt:Build a shared to-do list app using Firebase as a backend.

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

   1. Dostosuj projekt lub lokalizację (opcjonalnie): kliknij ikonę Ustawienia settings, a następnie wybierz lokalizację lub projekt Google Cloud, którego chcesz użyć.

   2. Potwierdź wybór: aby kontynuować, kliknij przycisk Włącz Firebase.

   Następnie agent automatycznie skonfiguruje odpowiednie usługi Firebase w Twoim projekcie w Firebase, połączy aplikację z projektem w Firebase i wygeneruje odpowiednie pliki kodu i konfiguracji Firebase:

   • Aplikacje internetowe:

     • Możliwe usługi: Cloud Firestore, Authentication i Firebase Security Rules
     • Pliki obejmują /src/lib/firebase.ts i firestore.rules

3. Wdrażanie: gdy aplikacja internetowa będzie gotowa, użyj opcji Udostępnij > Opublikuj, aby wdrożyć ją w Cloud Run. Aplikacja zostanie automatycznie wdrożona w tym samym projekcie, który został wybrany podczas konfiguracji.

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

Dodawanie Firebase do aplikacji podczas jej tworzenia

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ń: otwórz Ustawienia > Integracje i kliknij kartę Firebase Firestore i Auth.

Obie opcje uruchomią proces konfiguracji integracji z Firebase, który umożliwi Ci wybranie projektu, skonfigurowanie lokalizacji backendu i włączenie integracji w aplikacji zgodnie z opisem w omówieniu.

Po włączeniu integracji możesz w każdej chwili 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 Firebase Firestore i Auth.

Informacje o wspólnym limicie dla Cloud Firestore

W zależności od tego, kiedy została utworzona aplikacja, i od uprawnień konta bazy danych mogą być hostowane w projekcie Google Cloud w wersji Starter lub w projekcie standardowym. W obu przypadkach wszystkie Cloud Firestorebazy danych udostępnione przez agenta Google AI Studio są umieszczane w tej samej grupie baz danych „Limit współdzielony AI” w projekcie. Wszystkie mają te 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ółowe informacje o opcjonalnym dodawaniu płatności znajdziesz poniżej.
• Codzienne resetowanie: jeśli osiągniesz dzienny limit (np. 50 tys. odczytów dziennie), usługa zostanie wstrzymana dla wszystkich baz 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 limity:

(Opcjonalnie) Dodaj płatności, aby uzyskać większy limit Cloud Firestore

Jeśli Twoja aplikacja zyska popularność i będziesz potrzebować większych limitów niż te w przypadku 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 już zostać dodane do projektu z innych powodów, np. aby korzystać z Nano Banana. Jeśli tak jest, Twój projekt korzysta już z abonamentu Blaze i możesz przejść bezpośrednio do kroku uaktualniania bazy danych.

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

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

1. W Google AI Studio otwórz stronę Projekty.
2. Kliknij Skonfiguruj rozliczenia obok projektu, który chcesz uaktualnić.
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żemy też poprosić Cię o przedpłatę (która nie ma zastosowania do korzystania z usług Firebase i Google Cloud).

Krok 2. Uaktualnij bazę danych

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

1. Otwórz Firebasekonsolę i wybierz projekt zawierający bazę danych, którą chcesz uaktualnić.
2. W panelu nawigacyjnym po lewej stronie kliknij Bazy danych i pamięć > Firestore.
3. Jeśli Twój projekt zawiera kilka instancji bazy danych Cloud Firestore, wybierz tę, którą chcesz uaktualnić.
4. U góry strony powinien być widoczny baner informujący, że baza danych podlega wspólnym limitom korzystania z AI. Aby ją uaktualnić, kliknij Uaktualnij bazę danych > Uaktualnij do płatności według wykorzystania.Jeśli nie widzisz tego banera, baza danych nie została utworzona przez agenta Google AI Studio i nie należy do grupy z udostępnionym limitem lub została już uaktualniona.

Wyłączenie limitu wspólnego i włączenie płatności według wykorzystania w przypadku bazy danych powinno nastąpić w ciągu kilku minut.

Generowanie: Security Rules

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

Pamiętaj, że jeśli ręcznie dostosujesz Security Rules bezpośrednio w konsoli Firebase, agent Google AI Studio nie będzie znać tych zmian i zostaną one zastąpione w kolejnych iteracjach 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óry do Ciebie należy:

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

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

Add Firestore to this app using project PROJECT_ID.

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

• W tym projekcie zostanie utworzona nowa baza danych Cloud Firestore, która będzie korzystać z udostępnionego limitu.
• Firebase Authentication zostanie skonfigurowana funkcja Logowanie przez Google.
• Konto usługi otrzyma dostęp do bazy danych Cloud Firestore. Aby zezwolić na 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 na Google AI Studio.
• Ograniczenia: jeśli projekt w Firebase ma już Cloud Firestorebazę danych, agent nie będzie mógł dodać kolejnej. Musisz wybrać inny projekt lub utworzyć nowy, pusty projekt.

Używanie konsoli Firebase

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

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

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

   • Aby wyświetlić i edytować zapisane Cloud Firestore dane, otwórz Bazy danych i pamięć > Firestore.
   • Aby wyświetlić lub skonfigurować ustawienia i dane Authentication, otwórz Zabezpieczenia > Uwierzytelnianie.

Rozwiązywanie problemów i najczęstsze pytania

Znajdź odpowiedzi na najczęstsze pytania i dowiedz się, jak rozwiązywać problemy podczas integrowania Firebase z aplikacją Google AI Studio.

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

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 settings, wybierz lokalizację lub projekt Google Cloud, którego chcesz użyć, a potem kliknij Włącz Firebase.

Pamiętaj:

• Lokalizacja bazy danych jest stała: po wybraniu lokalizacji bazy danych nie można jej zmienić w danym projekcie. Ten wybór będzie domyślnie stosowany 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. Nie możesz używać różnych projektów w przypadku różnych usług w ramach tej samej aplikacji.

Jakie metody uwierzytelniania są obsługiwane?

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

1. W konsoli Firebase otwórz stronę Bezpieczeństwo > Uwierzytelnianie > Metoda logowania i skonfiguruj wybrane metody logowania.

2. Wróć do Google AI Studio i poproś 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 (dodanie Cloud Firestore i Authentication) jest obecnie obsługiwana tylko w przypadku aplikacji internetowych, a nie aplikacji na Androida. Jeśli tworzysz aplikację na Androida, musisz ręcznie zintegrować Firebase, jeśli potrzebujesz tych usług.

Tworzenie aplikacji na iOS nie jest obsługiwane w Google AI Studio. Jednak tak jak w przypadku wszystkich aplikacji internetowych, do aplikacji internetowych tworzonych przez Google AI Studio można uzyskać dostęp jako do mobilnych aplikacji internetowych z przeglądarek zainstalowanych na urządzeniach mobilnych (w tym na iOS).

Więcej informacji o tworzeniu aplikacji na Androida znajdziesz w Google AI Studiodokumentacji.

Czym jest plik firebase-blueprint.json?

Jest to plik pośredni używany przez agenta Google AI Studio do zrozumienia bazy kodu aplikacji. Nie modyfikuj tego pliku ręcznie, ponieważ może to spowodować wygenerowanie przez agenta nieprawidłowego kodu lub niebezpiecznego 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 limitów współdzielonych bazy danych Cloud Firestore. Możesz to zrobić na 2 sposoby:

• Opcja 1. Poczekaj: limity są resetowane codziennie około północy czasu pacyficznego.
• Opcja 2. Uaktualnienie: przejdź na abonament Blaze z płatnością według wykorzystania.
  • Jeśli Google AI Studioagent skonfigurowałCloud Firestore za Ciebie bazę danych, musisz użyć przycisku Uaktualnij bazę danych opisanego w artykule Dodawanie płatności w celu zwiększenia limitu Cloud Firestore, aby przenieść bazę danych do zwykłego stanu płatnego. Jeśli skonfigurujesz Cloud Firestore ręcznie, nie musisz używać przycisku Uaktualnij bazę danych.

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  Cloud Firestore bazie danych, ale żądanie zostaje odrzucone przez Security Rules. Oznacza to, że Security Rules nie zezwala na próbę wykonania operacji na podstawie bieżącego stanu uwierzytelniania lub ścieżki danych. Kliknij przycisk Popraw błąd, aby poprosić agenta Google AI Studio o spróbowanie poprawienia Security Rules.

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

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

Jeśli dodasz backend Firebase, musisz ręcznie otworzyć Firebasekonsolę i usunąć projekt lub zwolnić miejsce w poszczególnych zasobach (np. Cloud Firestoreinstancji bazy danych i Authenticationaprowizatorach), aby mieć pewność, że wszystkie dane i konfiguracje zostaną usunięte.

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

Agent Google AI Studio ma za zadanie udostępniać niezbędne zasoby backendu i generować kod oraz Security Rules. Sam agent nie może bezpośrednio usuwać, edytować ani modyfikować wpisów w Twojej Cloud Firestore bazie danych, ale może pisać w aplikacji kod, który jest przeznaczony do wykonywania tych działań. 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 w Firebase znajduje się w Google Cloudfolderze organizacji, a następnie połącz projekt jedną z tych metod:

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

• Podczas iteracji: jeśli masz już włączoną usługę Firebase lub chcesz później przełączyć projekty, możesz poinstruować agenta, aby używał istniejącego projektu, za pomocą prompta takiego jak:

    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 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ę Cloud Firestore bazy danych?

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

Pamiętaj, że wybrana lokalizacja dotyczy wszystkich Cloud Firestorebaz danych, które Google AI Studioagent tworzy w tym projekcie w Firebase. Po ustawieniu tej lokalizacji nie można jej zmienić w przypadku tych baz danych.

Czy po uaktualnieniu bazy danych Cloud Firestore mogę przywrócić ją do grupy limitów współdzielonych?

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

• PROJECT_ID : identyfikator projektu w Firebase. Znajdziesz go na stronie settings Ustawienia > Ogólne w 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 kafelek Firebase Firestore i 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 wykorzystujemy Twoje dane, znajdziesz w Dodatkowych warunkach korzystania z usługi 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 w projekcie Google Cloud” i klucz interfejsu API wymieniony w tym e-mailu jest Twoim kluczem interfejsu API Firebase, upewnij się, że spełnia on te wymagania, aby można go było bezpiecznie umieścić w kodzie lub plikach konfiguracyjnych. Możesz to sprawdzić na stronie Interfejsy API i usługi > Dane logowania w konsoli Google Cloud.

• Jest to klucz API, którego używasz w aplikacji w Firebase i tylko w usługach Firebase. Te klawisze są zwykle nazywane Browser key (auto created by Firebase) lub Android key (auto created by Firebase) lub iOS key (auto created by Firebase).
• Zawiera wszystkie wymagane interfejsy API związane z Firebase, które są uwzględnione na liście dozwolonych „Ograniczenia interfejsu API” klucza.
• Nie ma on żadnych innych interfejsów API na liście dozwolonych „Ograniczenia interfejsu API”. W szczególności lista nie powinna zawierać Generative Language API.

Upewnij się też, że w przypadku używanych usług Firebase stosujesz znaki Firebase Security Rules i App Check zgodnie z zaleceniami.

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