透過 Firebase SDKs 的 Vertex AI AI 開始使用 Gemini'API


本指南將說明如何使用所選平台的 Vertex AI in Firebase SDK，直接從應用程式呼叫 Vertex AI Gemini API。

事前準備

本指南假設您已熟悉如何使用 Xcode 開發適用於 iOS 等 Apple 平台的應用程式。

  • 請確認您的開發環境和 Apple 平台應用程式符合下列規定：

    • Xcode 15.0 以上版本
    • 應用程式必須指定 iOS 15 以上版本，或 macOS 12 以上版本。

  • (選用) 查看範例應用程式。

    下載範例應用程式

    您可以快速試用 SDK、查看各種用途的完整實作方式，或使用範例應用程式 (如果您沒有自己的 Apple 平台應用程式)。如要使用範例應用程式，您必須將其連結至 Firebase 專案。

步驟 1：設定 Firebase 專案並將應用程式連結至 Firebase

如果您已擁有 Firebase 專案和已連結至 Firebase 的應用程式

  1. 在 Firebase 主控台中，前往「使用 Gemini 進行建構」頁面。

  2. 按一下 Vertex AI in Firebase 資訊卡來啟動工作流程，協助您完成以下工作：

  3. 請繼續進行本指南的下一步驟，將 SDK 加入應用程式。

如果您尚未有 Firebase 專案，且有一個應用程式連結至 Firebase


步驟 2：新增 SDK

設定 Firebase 專案並將應用程式連結至 Firebase 後 (請查看上一步)，您可以將 Vertex AI in Firebase SDK 新增至應用程式。

使用 Swift Package Manager 安裝及管理 Firebase 依附元件。

Vertex AI in Firebase 程式庫可提供對 Vertex AI Gemini API 的存取權，並納入 Apple 平台 (firebase-ios-sdk) 的 Firebase SDK。

  1. 在 Xcode 中保持開啟應用程式專案，然後依序點選「File」>「Add Packages」。

  2. 系統顯示提示訊息時，請新增 Firebase Apple 平台 SDK 存放區：

      https://github.com/firebase/firebase-ios-sdk

  3. 選取最新版 SDK。

  4. 選取 FirebaseVertexAI 程式庫。

    完成後，Xcode 就會自動開始在背景中解析並下載依附元件。

步驟 3：初始化 Vertex AI 服務和生成式模型

您必須先初始化 Vertex AI 服務和生成式模型，才能發出 API 呼叫。

  1. 匯入 FirebaseVertexAI 模組：

    import FirebaseVertexAI

  2. 初始化 Vertex AI 服務和生成式模型：

    import FirebaseVertexAI

// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()

// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash")

完成入門指南後，請瞭解如何選擇 Gemini 模型，以及 (選用) 符合您用途和應用程式的位置。

步驟 4：呼叫 Vertex AI Gemini API

現在您已將應用程式連結至 Firebase、新增 SDK，並初始化 Vertex AI 服務和生成式模型，可以呼叫 Vertex AI Gemini API 了。

您可以使用 generateContent()，透過純文字提示要求生成文字：

import FirebaseVertexAI

// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()

// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash")

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
print(response.text ?? "No text in response.")

你還可以做些什麼？

進一步瞭解 Gemini 模型

瞭解不同用途適用的模型及配額與定價。

試用 Gemini API 的其他功能

瞭解如何控管內容產生

您也可以使用 Vertex AI Studio 測試提示和模型設定。


提供使用 Vertex AI in Firebase 的意見回饋