Dodawanie Cloud Firestore i uwierzytelniania do aplikacji Google AI Studio

Google AI Studio integruje się bezpośrednio z Cloud Firestore i Firebase Authentication, co umożliwia tworzenie aplikacji z trwałymi danymi i bezpiecznymi procesami logowania. Gdy używasz funkcji „Dodaj backend Firebase” w Google AI Studio, agent generuje wymagany kod i łączy aplikację z projektem w Firebase.

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 (np. „Utwórz wspólną listę zadań”).

2. Włącz integrację z Firebase: kliknij element Dodaj backend Firebase. Agent generuje niezbędny kod, w tym plik /src/lib/firebase.ts i plik firestore.rules, a następnie łączy aplikację z usługami Cloud Firestore i Firebase Authentication.

3. Wdrażanie: gdy aplikacja będzie gotowa, użyj opcji Udostępnij > Opublikuj, aby wdrożyć ją w Cloud Run.

Informacje o limicie wspólnym dla Cloud Firestore

Wszystkie bazy danych Cloud Firestore utworzone przez agenta wGoogle AI Studio są umieszczane w tej samej „grupie” baz danych w Twoim projekcie w Firebase. 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 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 Cloud Firestore w grupie z udostępnionym limitem mają te same 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 dostępne w ramach bezpłatnego poziomu Cloud 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 Firebase konsolę i połącz konto rozliczeniowe z projektem.

2. Uaktualnij bazę danych: domyślnie Cloud Firestore bazy danych utworzone przez Google AI Studio agenta 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=limited_free_tier" \
   -d '{"limited_free_tier": false}'
   

Security Rules generowanie

Google AI Studio automatycznie generuje Firebase Security Rules na podstawie logiki aplikacji. Te Security Rules są zaprojektowane tak, aby domyślnie odmawiać dostępu, co oznacza, że użytkownicy Twojej aplikacji mogą uzyskać 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

Możesz też poprosić agenta o Google AI StudioudostępnienieCloud Firestore w istniejącym Google Cloudprojekcie, którego jesteś właścicielem. Poproś agenta o użycie istniejącego projektu, np. za pomocą prompta:

Add Firestore to this app using project PROJECT_ID.

• 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 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 utworzyć nowy, pusty projekt, aby go użyć.

Korzystanie z konsoli Firebase

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

1. Otwórz Firebase konsolę i wybierz projekt o nazwie 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.

Jakie metody uwierzytelniania są obsługiwane?

Google AI Studio Agent konfiguruje logowanie przez Google, gdy używasz funkcji Dodaj backend Firebase. Aby skonfigurować dodatkowe metody, włącz je w Firebase konsoli i poproś agenta Google AI Studio o pomoc w aktualizacji bazy kodu.

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 bazy danych Cloud Firestore w ramach grupy limitów współdzielonych. 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ższy pakiet: przejście na pakiet 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 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 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 Firebase, Cloud Firestore bazy danych ani Firebase Authenticationkonfiguracji.

Jeśli dodasz backend Firebase, musisz ręcznie przejść do Firebasekonsoli i usunąć projekt lub wyczyścić poszczególne zasoby (np. Cloud Firestoreinstancję bazy danych i Authenticationdostawcó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 is designed to help provision the necessary backend resources and generate code and Security Rules. Sam agent nie może bezpośrednio usuwać, edytować ani modyfikować wpisów w Twojej bazie danych Cloud Firestore, ale może pisać w aplecie kod zaprojektowany 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?

Sprawdź, czy projekt w Firebase znajduje się w określonym Google Cloud folderze organizacji:

1. Utwórz projekt w Firebase ręcznie z wyprzedzeniem.

2. Podczas konfigurowania backendu Firebase w Google AI Studio poproś agenta o użycie istniejącego projektu:

   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.

Jak wybierana jest lokalizacja bazy danych Cloud Firestore?

Obecnie lokalizacja bazy danych Cloud Firestore jest wybierana automatycznie na podstawie Twojej lokalizacji i nie można jej zmienić ani określić ręcznie. Jeśli chcesz mieć możliwość wyboru konkretnej lokalizacji, daj nam znać, klikając Ustawienia > Prześlij opinię w Google AI Studio.

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.