常見問題與疑難排解

您必須啟用哪些 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 SDK 需要哪些權限？

哪些型號可搭配 Vertex AI in Firebase SDK 使用？

• 您可以搭配 Vertex AI in Firebase SDK 使用任何 Gemini 基礎模型。如要查看這些型號的清單，請參閱「瞭解 Gemini 型號」。

• 您無法使用非基礎 Gemini 模型 (例如 PaLM 模型、調整過的模型或以 Gemma 為基礎的模型) 搭配 Vertex AI in Firebase SDK。

我們會經常在 SDK 中新增功能，因此請回來看看這份常見問題清單 (以及發布說明、部落格和社群媒體貼文)，瞭解最新消息。

使用 Vertex AI in Firebase 時，這些功能是否可用？是否有使用內容快取、將搜尋做為工具、以 Google 搜尋建立基準、執行程式碼、微調模型、產生嵌入資料和語意檢索的功能？

各種模型或 Vertex AI Gemini API 支援內容快取、以搜尋做為工具、以 Google 搜尋建立基準、程式碼執行、模型微調、嵌入生成和語義檢索功能，但使用 Vertex AI in Firebase 時無法使用這些功能。

如要將這些功能列為功能要求，或對現有功能要求進行投票，請前往 Firebase UserVoice。

如何設定每位使用者的頻率限制？

根據預設，Vertex AI in Firebase 會將每位使用者的要求限制設為每分鐘 100 個要求 (RPM)。

如要調整每位使用者的速率限制，您必須調整 Vertex AI in Firebase API 的配額設定。

進一步瞭解 Vertex AI in Firebase API 配額。您也可以在該頁面瞭解如何查看及編輯配額。

如何修正這個 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，可在 settings 專案設定 中找到。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 支援團隊聯絡。

如何修正這個 400 錯誤？API key not valid. Please pass a valid API key.

如果您收到 400 錯誤，並顯示 API key not valid. Please pass a valid API key.，通常表示 Firebase 設定檔/物件中的 API 金鑰不存在，或是未設定為與應用程式和/或 Firebase 專案搭配使用。

請確認 Firebase 設定檔/物件中列出的 API 金鑰，與應用程式的 API 金鑰相符。您可以在 Google Cloud 控制台的「API 和服務」>「憑證」面板中查看所有 API 金鑰。

如果發現兩者不相符，請取得新的 Firebase 設定檔/物件，然後取代應用程式中的設定檔。新的設定檔/物件應包含應用程式和 Firebase 專案的有效 API 金鑰。

如何修正這個 403 錯誤？Requests to this API firebasevertexai.googleapis.com ... are blocked.

如果您收到 403 錯誤，並顯示 Requests to this API firebasevertexai.googleapis.com ... are blocked.，通常表示 Firebase 設定檔/物件中的 API 金鑰，在您要使用的產品的許可清單中沒有必要的 API。

請確認應用程式使用的 API 金鑰含有所有金鑰「API 限制」許可清單中的必要 API。針對 Vertex AI in Firebase，API 金鑰的許可清單中至少必須包含 Vertex AI in Firebase API。

您可以在 Google Cloud 主控台的「API 和服務」>「憑證」面板中查看所有 API 金鑰。

如何修正這個 403 錯誤？PERMISSION_DENIED: The caller does not have permission.

如果您收到 403 錯誤，並顯示 PERMISSION_DENIED: The caller does not have permission.，通常表示 Firebase 設定檔/物件中的 API 金鑰屬於其他 Firebase 專案。

請確認 Firebase 設定檔/物件中列出的 API 金鑰，與應用程式的 API 金鑰相符。您可以在 Google Cloud 控制台的「API 和服務」>「憑證」面板中查看所有 API 金鑰。

如果發現兩者不相符，請取得新的 Firebase 設定檔/物件，然後取代應用程式中的設定檔。新的設定檔/物件應包含應用程式和 Firebase 專案的有效 API 金鑰。