Domande frequenti e risoluzione dei problemi

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 attivate 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.update` `resourcemanager.projects.createBillingAssignment` `resourcemanager.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 gli SDK Vertex AI in Firebase con uno qualsiasi dei modelli di base Gemini elencati 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 SDK Vertex 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).

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 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.