常见问题解答和问题排查

iOS+ Android Web Flutter

本页面提供了有关 Gemini API 和 Vertex AI in Firebase SDK 的常见问题解答 (FAQ)。如有其他问题，请参阅 Google Cloud 文档中的 Gemini API 常见问题解答。

必须启用哪些 API 才能使用 Vertex AI in Firebase SDK？如何启用这些功能？

如需使用 Vertex AI in Firebase SDK，您的项目必须启用以下两个 API：

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

您只需在 Firebase 控制台中点击几下，即可启用以下 API：

1. 前往使用 Gemini 构建页面。

2. 点击 Vertex AI in Firebase 卡片，启动用于启用这两个 API 的工作流。此工作流还会将 Vertex AI in Firebase API 添加到您的 Firebase API 密钥的许可名单。

或者，您也可以使用 Google Cloud 控制台（需要手动完成更多步骤）：

1. 点击此常见问题解答条目顶部的每个 API 链接，然后点击每个 API 页面中的启用。

2. 按照 Google Cloud 文档中添加 API 限制中的说明，将 Vertex AI in Firebase API 添加到 Firebase API 密钥的许可名单。

注意： Vertex AI in Firebase 的预览版需要 Firebase ML API (firebaseml.googleapis.com)，但由于 Vertex AI in Firebase 已正式发布 (GA)，该 API 不是必需的。

使用 Vertex AI in Firebase SDK 需要哪些权限？

操作	所需的 IAM 权限	默认包含所需权限的 IAM 角色
将结算方案升级为随用随付 (Blaze) 定价方案	firebase.billingPlans.update resourcemanager.projects.createBillingAssignment resourcemanager.projects.deleteBillingAssignment	Owner
在项目中启用 API	serviceusage.services.enable	Editor Owner
创建 Firebase 应用	firebase.clients.create	Firebase 管理员 编辑者 所有者

哪些模型可以与 Vertex AI in Firebase SDK 搭配使用？

您可以将 Vertex AI in Firebase SDK 与了解 Gemini 模型中列出的任何 Gemini 基础模型搭配使用。

您不能将非基础 Gemini 模型（例如 PaLM 模型、经过调优的模型或基于 Gemma 的模型）与 Vertex AI in Firebase SDK 搭配使用。

我们会经常向 SDK 添加新功能，因此请定期查看此常见问题解答，了解最新动态（以及查看版本说明、博客和社交媒体帖子）。

如何修复 400 错误 Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.？

如果您尝试使用 Cloud Storage for Firebase 网址发送多模态请求，则可能会遇到以下 400 错误：
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

此错误是由某个项目在启用 Vertex AI API 时未正确自动预配所需服务代理引起的。这是某些项目的已知问题，我们正在努力解决这一问题。

以下是修复项目并正确预配这些服务代理的权宜解决方法，以便您开始在多模态请求中添加 Cloud Storage for Firebase 网址。您必须是项目的所有者，并且只需为项目完成这组任务一次。

1. 使用 gcloud CLI 进行访问和身份验证。
   最简单的方法是通过 Cloud Shell 执行此操作。如需了解详情，请参阅 Google Cloud 文档。

2. 如果出现提示，请按照终端中显示的说明针对您的 Firebase 项目运行 gcloud CLI。

   您需要 Firebase 项目 ID，可以在 Firebase 控制台的 项目设置顶部找到。

3. 运行以下命令，在项目中预配所需的服务代理：

   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. 请等待几分钟，确保服务代理已预配完毕，然后重试发送包含 Cloud Storage for Firebase 网址的多模式请求。

如果您在等待几分钟后仍收到此错误消息，请与 Firebase 支持团队联系。

就您使用 Vertex AI in Firebase 的体验提供反馈