Aggiungere Cloud Firestore e l'autenticazione all'app Google AI Studio

La modalità di creazione in Google AI Studio può configurare e integrare automaticamente Cloud Firestore e Firebase Authentication nelle app web, semplificando la creazione di app con archiviazione permanente dei dati e flussi di accesso sicuri. Con un solo prompt e pochi clic, puoi consentire all'agente Google AI Studio di configurare un progetto Firebase, collegare la tua app a questo progetto e generare tutto il codice Cloud Firestore e Authentication direttamente nella tua app.

Panoramica: aggiungi un backend alla tua Google AI Studio app

Descrivi la tua idea: crea una nuova app in Google AI Studio e descrivi una funzionalità che richiede un database o l'autenticazione. Ad esempio, puoi inserire il prompt: Build a shared to-do list app using Firebase as a backend.

**Suggerimento**: per risultati ottimali, chiedi esplicitamente all'agente di utilizzare Firebase come backend per la tua app.
Attiva l'integrazione di Firebase: quando richiesto dall'agente, attiva Firebase, seleziona una località per il tuo progetto e accetta i Termini di Firebase. L'agente collega automaticamente la tua app al tuo progetto Firebase e genera il codice Cloud Firestore e Authentication necessario per la tua app, inclusi un file /src/lib/firebase.ts e un file firestore.rules.
Esegui il deployment: quando è tutto pronto, utilizza l'opzione Condividi > Pubblica per eseguire il deployment della tua app web in Cloud Run.

Importante: prima di condividere o eseguire il deployment dell'app, esamina sempre le regole di sicurezza di Firebase generate dall'AIFirebase Security Rules.

Informazioni sulla quota condivisa per Cloud Firestore

Tutti i database Cloud Firestore di cui è stato eseguito il provisioning dall'agente Google AI Studio vengono inseriti nello stesso "gruppo" di database nel tuo progetto Firebase. Condividono tutti queste caratteristiche:

Quota condivisa: tutti i database del gruppo condividono una quota di utilizzo (vedi i dettagli di seguito).
Nessun account Cloud Billing richiesto: puoi creare e testare la tua app senza aggiungere la fatturazione. Vedi i dettagli di seguito sull'aggiunta facoltativa della fatturazione.
Reimpostazioni giornaliere: se raggiungi un limite di quota giornaliero (ad esempio, 50.000 letture al giorno), il servizio verrà messo in pausa per tutti i database del gruppo e riprenderà il giorno successivo intorno alla mezzanotte del fuso orario del Pacifico.

Cloud Firestore database nel gruppo di quote condivise condividono i seguenti limiti:

Metrica	Quota
Dati archiviati	1 GiB totale
Traffico in uscita dalla rete	10 GiB al mese
Unità di scrittura	40.000 scritture al giorno
Unità di lettura	50.000 letture al giorno
Unità di aggiornamento in tempo reale	50.000 aggiornamenti al giorno

(Facoltativo) Aggiungi la fatturazione per ottenere una quota Cloud Firestore maggiore

Se la tua app acquisisce popolarità e devi superare i limiti senza costi per Cloud Firestore, puoi eseguire l'upgrade del tuo progetto al piano tariffario Blaze con pagamento a consumo.

Aggiungi la fatturazione (se non l'hai già fatto): vai alla Firebase console e collega un account di fatturazione al tuo progetto.
Esegui l'upgrade del database: per impostazione predefinita, i database Cloud Firestore creati dall' agente Google AI Studio continuano a utilizzare la quota condivisa anche dopo l' upgrade del piano tariffario. Per abilitare la scalabilità a pagamento completa per un database specifico, devi spostarlo manualmente dal gruppo utilizzando un comando curl.
- PROJECT_ID : ID progetto Firebase; trova questo ID nelle le Impostazioni progetto della console Firebase.
- DATABASE_ID : ID database Cloud Firestore, che corrisponderà all'ID dell'applet; trova questo ID database nella colonna Nome nella pagina dei database Cloud Firestore nella console 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}'
```

Importante: il collegamento di un account Cloud Billing non rimuove automaticamente i limiti di quota condivisa.

Errore condiviso: se la quota condivisa è esaurita, tutti i database del gruppo restituiranno errori. Non hanno accesso all' account di fatturazione collegato.
Utilizzo aggiuntivo: per abilitare l'utilizzo aggiuntivo per un database specifico devi spostare il database dal gruppo di quote condivise utilizzando il comando curl fornito. In questo modo, l'istanza viene convertita in un database a pagamento normale in cui tutto l'utilizzo viene addebitato alle Cloud Firestore tariffe.
Esegui la transizione di un database: una volta spostato un database dal gruppo di quote condivise e convertito in un'istanza a pagamento normale, puoi invertire il valore booleano nel comando curl per riportarlo al gruppo di quote condivise. Tieni presente che tutti i database all'interno del gruppo di quote condivise devono essere della stessa edizione e trovarsi nella stessa regione.

GenerazioneSecurity Rules

L'Google AI Studio agente genera automaticamente Firebase Security Rules in base alla logica della tua app. Questi Security Rules sono progettati per essere "default deny", il che significa che gli utenti finali della tua app possono accedere solo ai dati di loro proprietà.

Tieni presente che se modifichi manualmente i tuoi Security Rules direttamente nella Firebase console, l'agente Google AI Studio non verrà a conoscenza delle modifiche, e queste verranno sovrascritte durante le successive iterazioni dell'app. Ti consigliamo di utilizzare l'agente Google AI Studio per modificare Firebase Security Rules per assicurarti che le modifiche vengano mantenute e siano allineate alla logica della tua app.

Utilizza un progetto esistente

Puoi anche chiedere all'agente Google AI Studio di eseguire il provisioning Cloud Firestore in un progetto Google Cloud esistente di tua proprietà. Chiedi all'agente di utilizzare il tuo progetto esistente con un prompt come:

Add Firestore to this app using project PROJECT_ID.

Verrà eseguito il provisioning di un nuovo database Cloud Firestore nel progetto utilizzando la quota condivisa.
Firebase Authentication con Accedi con Google verrà configurato.
A un account di servizio verrà concesso l'accesso al tuo database Cloud Firestore. Per consentire l'accesso amministratore da Google AI Studio, a un nuovo account di servizio denominato ais-sandbox@PROJECT_ID.iam.gservice.com verrà concessa l'autorizzazione ad accedere al tuo database Cloud Firestore. Questo account è associato solo alle tue Google AI Studio app.
Limitazioni: se il progetto Firebase ha già un Cloud Firestore database, l'agente non potrà aggiungerne un altro. Dovrai creare un nuovo progetto vuoto da utilizzare.

Utilizza la Firebase console

Puoi visualizzare i dati e le impostazioni della tua app nella console Firebase. Per accedere ai progetti associati a Google AI Studio, segui questi passaggi:

Vai alla Firebase console e seleziona il progetto con l'etichetta AI Studio.
Nel riquadro di navigazione a sinistra, fai clic su Crea > Cloud Firestore Database per visualizzare e modificare i dati in Cloud Firestore, oppure fai clic su Crea > Authentication per configurare le impostazioni e i dati di Authentication.

Risoluzione dei problemi e domande frequenti

Trova le risposte alle domande più comuni e scopri come risolvere i problemi quando integri Firebase con la tua app Google AI Studio.

Come viene selezionato il mio progetto Google Cloud / Firebase?

Quando utilizzi la funzionalità Aggiungi backend Firebase, l'agente Google AI Studio seleziona automaticamente un progetto Firebase da utilizzare per i servizi di backend della tua app (Cloud Firestore e Firebase Authentication).

Se invece vuoi utilizzare un progetto specifico, puoi chiedere all'agente di farlo con un prompt come:

Use project PROJECT_ID for the Firebase backend.

Se in un secondo momento decidi di pubblicare la tua app in Cloud Run, è importante continuare a utilizzare lo stesso progetto. La scelta di un progetto diverso comporterà errori perché non corrisponderà al progetto utilizzato per il backend.

Quali metodi di autenticazione sono supportati?

L'agente Google AI Studio configura Accedi con Google quando utilizzi la funzionalità Aggiungi backend Firebase. Per configurare altri metodi, attivali in the Firebase console e chiedi all'agente Google AI Studio di aiutarti ad aggiornare la codebase.

Posso creare un'app mobile (ad esempio Android o iOS) con Google AI Studio?

Al momento, l'agente Google AI Studio può creare solo app web. Scopri di più su cosa è supportato nella Google AI Studio documentazione dell'agente.

Tieni presente, tuttavia, che proprio come tutte le app web, le app create da Google AI Studio sono accessibili come app web per dispositivi mobili dai browser installati sui dispositivi mobili.

Che cos'è il file `firebase-blueprint.json`?

Si tratta di un file intermedio utilizzato dall'agente Google AI Studio per comprendere la codebase della tua app. Non modificare manualmente questo file, in quanto potrebbe causare la generazione di codice errato o regole di sicurezza non sicure da parte dell'agente Security Rules.

Che cosa devo fare se ricevo un errore "Quota superata"?

Se raggiungi un limite di quota di Cloud Firestore, significa che la tua app ha raggiunto il limite di utilizzo giornaliero per il gruppo di quote condivise del database Cloud Firestore. Esistono due modi per risolvere questo problema:

Opzione 1: attendi: le quote vengono reimpostate ogni giorno intorno alla mezzanotte del fuso orario del Pacifico.
Opzione 2: esegui l'upgrade: esegui l'upgrade al piano tariffario Blaze con pagamento a consumo.
- Se l'agente Google AI Studio ha configurato Cloud Firestore per te, devi quindi utilizzare il comando curl descritto in Aggiungi la fatturazione per ottenere una quota Cloud Firestore maggiore per spostare il database in uno stato a pagamento normale. Se hai configurato Cloud Firestore manualmente, non è necessario eseguire il comando curl.

Che cosa devo fare se ricevo un errore "Autorizzazioni mancanti o insufficienti"?

Questo errore si verifica quando la tua app tenta di leggere o scrivere dati nel tuo Cloud Firestore database, ma la richiesta viene rifiutata dal tuo Security Rules. Indica che i Security Rules non consentono l' operazione tentata in base allo stato di autenticazione o al percorso dei dati corrente. Fai clic sul pulsante Correggi errore per chiedere all'agente Google AI Studio di tentare di correggere Security Rules.

Che cosa succede al mio backend Firebase quando elimino la mia app Google AI Studio?

L'eliminazione dell'applicazione in Google AI Studio non comporta l'eliminazione automatica del progetto Firebase, del database Cloud Firestore o delle configurazioni Firebase Authentication.

Se hai aggiunto un backend Firebase, devi andare manualmente alla Firebase console ed eliminare il progetto o liberare spazio dalle singole risorse (come l' Cloud Firestore istanza del database e i Authentication provider) per assicurarti che tutti i dati e le configurazioni vengano rimossi.

L'agente Google AI Studio può eliminare o modificare i dati nel mio database Cloud Firestore?

L'agente Google AI Studio è progettato per aiutarti a eseguire il provisioning delle risorse di backend necessarie e a generare codice e Security Rules. Anche se l'agente stesso non può eliminare, modificare o manipolare direttamente le voci di dati all'interno del database Cloud Firestore, può scrivere codice nell'applet progettato per eseguire queste azioni. Per eseguire attività di gestione dei dati, come l'eliminazione delle voci, vai alla pagina del Cloud Firestore database nella Firebase console.

Faccio parte di un'organizzazione che utilizza Google Cloud. Posso collegare la mia app Google AI Studio a un progetto esistente nell'ambiente Google Cloud della mia organizzazione?

Assicurati che il tuo progetto Firebase sia inserito in una cartella dell'organizzazione Google Cloud specifica:

Crea manualmente il progetto Firebase in anticipo.
Quando configuri il backend Firebase in Google AI Studio, chiedi all' agente di utilizzare il tuo progetto esistente:
```
Add Firestore to this app using project PROJECT_ID.
```

Perché non riesco a trovare determinati documenti nella Firebase console?

Quando l'agente di AI Studio salva i dati in un percorso nidificato (ad esempio /users/user1/messages/msg1) senza prima creare il documento principale (user1), crea quello che è noto come documento principale inesistente. Questi documenti non vengono visualizzati nella console Firebase, il che può rendere difficile trovarli durante la navigazione nel database Cloud Firestore. Anche se questo non influisce sul funzionamento dell'app, spesso puoi descrivere il problema all'agente di AI Studio per chiedergli di creare i documenti principali mancanti.

Per maggiori dettagli, consulta Documenti principali inesistenti.

In che modo Google utilizza i miei dati (ad esempio codice e prompt) in Google AI Studio?

Per informazioni dettagliate su come vengono utilizzati i tuoi dati, consulta i Termini di servizio aggiuntivi dell'API Gemini.

Ho ricevuto un'email da Google Cloud relativa a una "chiave API Google accessibile pubblicamente per il tuo progetto Google Cloud". Che cosa devo fare?

Se hai ricevuto un'email da Google Cloud relativa a una "chiave API Google accessibile pubblicamente per il tuo progetto Google Cloud" e la chiave API elencata nell'email è la tua chiave API Firebase, assicurati che la chiave API soddisfi i seguenti requisiti per essere inclusa in modo sicuro nei file di codice o di configurazione. Puoi verificare quanto segue nel API e servizi > Credenziali nel riquadro della console Google Cloud.

È la chiave API che utilizzi per la tua app Firebase e solo per i servizi Firebase. Queste chiavi vengono in genere chiamate Browser key (auto created by Firebase) o Android key (auto created by Firebase) o iOS key (auto created by Firebase).
Include tutte le API correlate a Firebase richieste nell'elenco consentiti "Restrizioni API" della chiave.
Non include altre API nell'elenco consentiti "Restrizioni API" allowlist. In particolare, l'elenco non deve includere Generative Language API.

Inoltre, assicurati di utilizzare Firebase Security Rules e App Check come consigliato per i prodotti Firebase che utilizzi.

Puoi trovare i dettagli sulle chiavi API per Firebase e un elenco di domande frequenti in Informazioni sull'utilizzo e sulla gestione delle chiavi API per Firebase

Importante: la chiave API che utilizzi per le chiamate a Gemini Developer API nella tua app non deve mai essere inclusa nei file di codice o di configurazione. Deve essere protetta dall'esposizione pubblica. Nella console Google Cloud, verrà chiamata Gemini API Key o Gemini Developer API key (auto created by Firebase), e sarà limitata alla Generative Language API.