Perguntas frequentes e solução de problemas

Quais APIs precisam ser ativadas para usar os SDKs Vertex AI in Firebase? E como faço para ativá-los?

Para usar os SDKs Vertex AI in Firebase, seu projeto precisa ter as seguintes APIs ativadas:

• API Vertex AI (aiplatform.googleapis.com)
• API Vertex AI in Firebase (firebasevertexai.googleapis.com)

É possível ativar essas APIs com alguns cliques no console do Firebase:

1. Acesse a página Criar com o Gemini.

2. Clique no card Vertex AI in Firebase para iniciar um fluxo de trabalho que ativa as duas APIs. Esse fluxo de trabalho também adicionará a API Vertex AI in Firebase à lista de permissões da sua chave de API do Firebase.

Como alternativa, você pode usar o console Google Cloud (opção mais manual):

1. Clique em cada link de API na parte de cima desta entrada de perguntas frequentes e, depois, em Ativar na página de cada API.

2. Adicione a API Vertex AI in Firebase à lista de permissões da chave de API do Firebase seguindo as instruções em Adicionar restrições de API na documentação da Google Cloud.

Quais permissões são necessárias para usar os SDKs Vertex AI in Firebase?

Quais modelos podem ser usados com os SDKs Vertex AI in Firebase?

Você pode usar os SDKs do Vertex AI in Firebase com qualquer um dos modelos de fundação do Gemini listados em Saiba mais sobre os modelos do Gemini.

Não é possível usar modelos do Gemini que não sejam de fundação, como modelos do PaLM, modelos ajustados ou modelos baseados no Gemma com os SDKs Vertex AI in Firebase.

Adicionamos novos recursos aos SDKs com frequência. Por isso, confira as atualizações destas perguntas frequentes (assim como nas notas da versão, blogs e postagens nas redes sociais).

Como corrigir o erro 400 Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.?

Se você estiver tentando enviar uma solicitação multimodal com um URL Cloud Storage for Firebase, poderá encontrar o seguinte erro 400:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

Esse erro é causado por um projeto sem os agentes de serviço necessários provisionados automaticamente corretamente quando a API Vertex AI foi ativada no projeto. Esse é um problema conhecido em alguns projetos, e estamos trabalhando em uma correção global.

Confira a solução alternativa para corrigir seu projeto e provisionar corretamente esses agentes de serviço para que você possa começar a incluir URLs Cloud Storage for Firebase nas suas solicitações multimodais. Você precisa ser um proprietário do projeto e só precisa concluir esse conjunto de tarefas uma vez.

1. Acesse e autentique com o gcloud CLI.
   A maneira mais fácil de fazer isso é em Cloud Shell. Saiba mais na documentação da Google Cloud.

2. Se solicitado, siga as instruções exibidas no terminal para executar o gcloud CLI no seu projeto do Firebase.

   Você vai precisar do ID do projeto do Firebase, que pode ser encontrado na parte de cima da settings Configurações do projeto no console Firebase.

3. Provisione os agentes de serviço necessários no projeto executando o seguinte 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 ''
   

4. Aguarde alguns minutos para garantir que os agentes de serviço sejam provisionados e tente enviar a solicitação multimodal que inclui o URL Cloud Storage for Firebase novamente.

Se o erro continuar ocorrendo depois de alguns minutos, entre em contato com o suporte do Firebase.