Dodawanie Cloud Firestore i uwierzytelniania 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ć Google AI Studio agentowi 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 możesz dostosować konfigurację:

   • Wybierz lokalizację (opcjonalnie): w menu wybierz lokalizację bazy danych i aplikacji.
   • Wybierz projekt (opcjonalnie): kliknij ikonę Ustawienia settings, wybierz projekt, którego chcesz użyć, a potem kliknij Zapisz.Google Cloud
   • Potwierdź wybór: aby kontynuować, kliknij przycisk Włącz Firebase.

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

3. Wdrażanie: gdy aplikacja będzie gotowa, 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.

   .

Informacje o limicie udostępnionym na koncie Cloud Firestore

Wszystkie bazy danych Cloud Firestore udostępnione przez agenta Google AI Studio są umieszczane w tej samej „grupie” baz danych w projekcie w Firebase. Wszystkie mają te cechy:

• Limit udostępniony: 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 rozliczeń. 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.

Bazy danych w grupie z udostępnionym limitem mają te same limity:Cloud Firestore

(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 dostępne w ramach bezpłatnego poziomuCloud Firestore, możesz przenieść projekt na abonament Blaze z płatnością według wykorzystania.

1. Dodaj płatności (jeśli jeszcze tego nie zrobiono): otwórz konsolę Firebase i połącz konto rozliczeniowe z projektem.

2. Uaktualnij bazę danych: domyślnie bazy danych Cloud Firestore utworzone przez agenta Google AI Studio nadal korzystają ze wspólnego limitu nawet po uaktualnieniu planu cenowego. Aby włączyć pełne skalowanie płatne w przypadku konkretnej bazy danych, musisz ręcznie przenieść ją z grupy za pomocą polecenia curl.

   • PROJECT_ID – identyfikator projektu w Firebase. Znajdziesz go w Ustawieniach projektu w konsoli Firebase.

   • DATABASE_ID : Cloud Firestore identyfikator bazy danych, który będzie zgodny z identyfikatorem apletu. Znajdziesz go w kolumnie Nazwa na Cloud Firestorestronie baz danych w konsoli 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=free_tier_limited" \
   -d '{"free_tier_limited": false}'
   

Security Rules generowanie

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órego jesteś właścicielem:

1. Na karcie, która się pojawi, kliknij ikonę Ustawienia settings.
2. Wybierz projekt, a potem kliknij Zapisz.

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

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 z użyciem wspólnego limitu.
• Firebase Authentication z logowaniem przez Google.
• Konto usługi otrzyma dostęp do Twojej bazy danych Cloud Firestore. Aby zezwolić na dostęp administratora z domeny 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 Firestorebazę danych, agent nie będzie mógł dodać kolejnej. Musisz wybrać inny projekt lub utworzyć nowy, pusty projekt, aby go używać.

Korzystanie z konsoli Firebase

Dane i ustawienia aplikacji możesz wyświetlić w Firebasekonsoli. Aby uzyskać dostęp do projektów powiązanych z Google AI Studio, wykonaj te czynności:

1. Otwórz Firebasekonsolę i wybierz projekt oznaczony jako AI Studio.
2. W panelu nawigacji po lewej stronie kliknij Kompilacja > Cloud Firestore Baza danych, aby wyświetlić i edytować dane w Cloud Firestore, lub kliknij Kompilacja > Authentication, aby skonfigurować ustawienia i dane Authentication.

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:

• Wybierz lokalizację (opcjonalnie): wybierz lokalizację bazy danych i aplikacji za pomocą menu lokalizacji.
• Wybierz projekt (opcjonalnie): kliknij ikonę Ustawienia settings, wybierz projekt, którego chcesz użyć Google Cloud, a następnie kliknij Zapisz.

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 skonfigurowanie Authentication. Aby skonfigurować dodatkowe metody, włącz je w Firebasekonsoli i poproś Google AI Studioagenta o pomoc w aktualizacji bazy kodu.

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

Obecnie agent Google AI Studio może tworzyć tylko aplikacje internetowe. Więcej informacji o obsługiwanych funkcjach znajdziesz w Google AI Studiodokumentacji agenta.

Pamiętaj jednak, że tak jak w przypadku wszystkich aplikacji internetowych, do aplikacji utworzonych przez Google AI Studio można uzyskać dostęp jako do mobilnych aplikacji internetowych w przeglądarkach zainstalowanych na urządzeniach mobilnych.

Co to jest plik firebase-blueprint.json?

Jest to plik pośredni używany przez Google AI Studio agenta do zrozumienia bazy kodu aplikacji. Nie modyfikuj tego pliku ręcznie, ponieważ może to spowodować wygenerowanie przez agenta nieprawidłowego kodu lub niezabezpieczonego 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. Przejście na wyższą wersję: przejście na plan cenowy Blaze z płatnością według wykorzystania.
  • Jeśli Google AI Studioagent skonfigurowałCloud Firestore za Ciebie bazę danych, musisz użyć curlpolecenia opisanego w artykule Dodawanie płatności, aby uzyskać większy limit Cloud Firestore i przekształcić bazę danych w zwykłą bazę płatną. Jeśli skonfigurujesz Cloud Firestore ręcznie, nie musisz uruchamiać polecenia curl.

Co zrobić, jeśli wyświetli 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 jest odrzucane 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 Napraw 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 przejść do Firebasekonsoli i usunąć projekt lub zwolnić miejsce, usuwając poszczególne zasoby (np. Cloud Firestoreinstancję bazy danych i Authenticationaprowizatorów), aby mieć pewność, że wszystkie dane i konfiguracje zostaną usunięte.

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

Google AI Studio agent 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 manipulować wpisami w Twojej Cloud Firestorebazie 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 Cloud Firestorestronę bazy danych w Firebasekonsoli.

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. Sprawdź, czy projekt w Firebase znajduje się w Google Cloudfolderze organizacji, a potem połącz go jedną z tych metod:

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

• 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ł dotychczasowego 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ę 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 Firestorebaz danych, które agent Google AI Studio tworzy w tym projekcie w Firebase. Po ustawieniu tej lokalizacji nie można jej zmienić w przypadku tych baz danych.

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 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 poniższe wymagania, aby można go było bezpiecznie umieścić w kodzie lub plikach konfiguracyjnych. Możesz to sprawdzić w panelu 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. Klucze te są zwykle nazywane Browser key (auto created by Firebase) lub Android key (auto created by Firebase) lub iOS key (auto created by Firebase).
• Zawiera on wszystkie wymagane interfejsy API Firebase na liście dozwolonych „Ograniczenia interfejsu API”.
• 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 używasz Firebase Security Rules i App Check zgodnie z zaleceniami w przypadku usług Firebase, z których korzystasz.

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