Questa pagina fornisce risposte alle domande frequenti e informazioni sulla risoluzione dei problemi relativi agli SDK Gemini API e Vertex AI in Firebase. Per ulteriori domande, consulta le domande frequenti su Gemini API nella documentazione di Google Cloud.
Domande frequenti di carattere generale
Quali API devono essere abilitate per utilizzare gli SDK Vertex AI in Firebase? E come faccio ad attivarle?
Per utilizzare gli SDK Vertex AI in Firebase, nel progetto devono essere abilitate le seguenti due API:
- API Vertex AI (
aiplatform.googleapis.com) - API Vertex AI in Firebase (
firebasevertexai.googleapis.com)
Puoi abilitare queste API con pochi clic nella console Firebase:
Vai alla pagina Creare con Gemini.
Fai clic sulla scheda Vertex AI in Firebase per avviare un flusso di lavoro che attiva le due API. Questo flusso di lavoro aggiungerà anche l'API Vertex AI in Firebase alla lista consentita della chiave API di Firebase.
In alternativa, puoi utilizzare la console Google Cloud (opzione più manuale):
Fai clic su ogni link dell'API nella parte superiore di questa voce delle domande frequenti, quindi su Attiva nella pagina di ogni API.
Aggiungi l'API Vertex AI in Firebase alla lista consentita della chiave API Firebase seguendo le istruzioni riportate in Aggiungere limitazioni API nella documentazione di Google Cloud.
Quali autorizzazioni sono necessarie per utilizzare gli SDK Vertex AI in Firebase?
| Azione | Autorizzazioni IAM richieste | Ruoli IAM che includono le autorizzazioni richieste per impostazione predefinita |
|---|---|---|
| Eseguire l'upgrade della fatturazione al piano tariffario Blaze con pagamento a consumo | firebase.billingPlans.updateresourcemanager.projects.createBillingAssignmentresourcemanager.projects.deleteBillingAssignment
|
Proprietario |
| Abilita le API nel progetto | serviceusage.services.enable |
Editor Proprietario |
| Crea app Firebase | firebase.clients.create |
Amministratore Firebase Editor Proprietario |
Quali modelli possono essere utilizzati con gli SDK Vertex AI in Firebase?
Puoi utilizzare uno qualsiasi dei modelli di base Gemini con gli SDK Vertex AI in Firebase, incluse le versioni di anteprima ed sperimentali. Consulta un elenco di questi modelli in Scopri di più sui modelli Gemini.
Non puoi utilizzare modelli Gemini non di base (come i modelli PaLM, i modelli ottimizzati o i modelli basati su Gemma) con gli SDKVertex AI in Firebase.
Aggiungiamo spesso nuove funzionalità agli SDK, quindi ricontrolla queste domande frequenti per gli aggiornamenti (nonché nelle note di rilascio, nei blog e nei post sui social).
Queste funzionalità sono disponibili quando utilizzi Vertex AI in Firebase? Memorizzazione nella cache del contesto, Ricerca come strumento, grounding con la Ricerca Google, esecuzione di codice, ottimizzazione di un modello, generazione di embedding e recupero semantico?
La memorizzazione nella cache del contesto, la Ricerca come strumento, il grounding con la Ricerca Google, l'esecuzione del codice, la messa a punto di un modello, la generazione di embedding e il recupero semantico sono supportati da vari modelli o dall'API Vertex AI Gemini API, ma non sono disponibili quando si utilizza Vertex AI in Firebase.
Se vuoi aggiungerle come richieste di funzionalità o votare per una richiesta di funzionalità esistente, visita Firebase UserVoice.
Come faccio a impostare una limitazione di frequenza per utente?
Per impostazione predefinita, Vertex AI in Firebase imposta il limite di richieste per utente su 100 richieste al minuto (RPM).
Se vuoi modificare il limite di frequenza per utente, devi modificare le impostazioni della quota per l'API Vertex AI in Firebase.
Scopri di più sulla quota dell'API Vertex AI in Firebase. In questa pagina puoi anche scoprire come visualizzare e modificare la tua quota.
Risolvere gli errori
Come faccio a correggere questo errore 400? Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
Se stai tentando di inviare una richiesta multimodale con un URL Cloud Storage for Firebase, potresti riscontrare il seguente errore 400:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
Questo errore è causato da un progetto per il quale non è stato eseguito correttamente il provisioning automatico degli agenti di servizio richiesti quando è stata abilitata l'API Vertex AI nel progetto. Si tratta di un problema noto di alcuni progetti e stiamo lavorando a una correzione globale.
Ecco la soluzione alternativa per correggere il progetto e eseguire il provisioning corretto di questi agenti di servizio in modo da poter iniziare a includere gli URL Cloud Storage for Firebase nelle richieste multimodali. Devi essere un proprietario del progetto e devi completare questo insieme di attività solo una volta per il progetto.
Accedi e autenticati con gcloud CLI.
Il modo più semplice per farlo è da Cloud Shell. Scopri di più nella documentazione di Google Cloud.Se richiesto, segui le istruzioni visualizzate nel terminale per eseguire gcloud CLI nel tuo progetto Firebase.
Ti servirà l'ID progetto Firebase, che puoi trovare nella parte superiore di settings Impostazioni progetto nella console Firebase.
Esegui il provisioning degli agenti di servizio richiesti nel progetto eseguendo il seguente comando:
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
Attendi qualche minuto per assicurarti che sia stato eseguito il provisioning degli agenti di servizio, quindi riprova a inviare la richiesta multimodale che include l'URLCloud Storage for Firebase.
Se continui a ricevere questo errore dopo aver aspettato diversi minuti, contatta l'assistenza Firebase.
Come faccio a correggere questo errore 400? API key not valid. Please pass a valid API key.
Se ricevi un errore 400 con il messaggio
API key not valid. Please pass a valid API key., in genere significa che la chiave API nell'oggetto/file di configurazione di Firebase non esiste o non è configurata per essere utilizzata con la tua app e/o il tuo progetto Firebase.
Verifica che la chiave API elencata nell'oggetto/nel file di configurazione di Firebase corrisponda alla chiave API della tua app. Puoi visualizzare tutte le tue chiavi API nel riquadro API e servizi > Credenziali nella console Google Cloud.
Se scopri che non corrispondono, ottieni un file/oggetto di configurazione Firebase aggiornato, quindi sostituisci quello presente nella tua app. Il file/l'oggetto di configurazione aggiornato deve contenere una chiave API valida per la tua app e il tuo progetto Firebase.
Come faccio a correggere questo errore 403? Requests to this API firebasevertexai.googleapis.com ... are blocked.
Se ricevi un errore 403 con il messaggio
Requests to this API firebasevertexai.googleapis.com ... are blocked.,
in genere significa che la chiave API nell'oggetto/nel file di configurazione di Firebase
non ha un'API richiesta nella lista consentita per il prodotto che stai tentando
di utilizzare.
Assicurati che la chiave API utilizzata dalla tua app includa tutte le API richieste incluse nella lista consentita "Restrizioni API" della chiave. Per Vertex AI in Firebase, la chiave API deve contenere almeno l'API Vertex AI in Firebase nella lista consentita.
Puoi visualizzare tutte le tue chiavi API nel riquadro API e servizi > Credenziali della console Google Cloud.
Come faccio a correggere questo errore 403? PERMISSION_DENIED: The caller does not have permission.
Se ricevi un errore 403 con il messaggio
PERMISSION_DENIED: The caller does not have permission., in genere significa che
la chiave API nel file/nell'oggetto di configurazione di Firebase appartiene a un progetto
Firebase diverso.
Verifica che la chiave API elencata nell'oggetto/nel file di configurazione di Firebase corrisponda alla chiave API della tua app. Puoi visualizzare tutte le tue chiavi API nel riquadro API e servizi > Credenziali nella console Google Cloud.
Se scopri che non corrispondono, ottieni un file/oggetto di configurazione Firebase aggiornato, quindi sostituisci quello presente nella tua app. Il file/l'oggetto di configurazione aggiornato deve contenere una chiave API valida per la tua app e il tuo progetto Firebase.
Inviare un feedback sulla tua esperienza con Vertex AI in Firebase