Làm quen với API Gemini bằng các SDK của Vertex AI cho Firebase


Hướng dẫn này chỉ cho bạn cách bắt đầu thực hiện lệnh gọi đến API Gemini trong Vertex AI ngay trong ứng dụng của bạn bằng các SDK của Vertex AI cho Firebase.

Điều kiện tiên quyết

Hướng dẫn này giả định rằng bạn đã quen thuộc với việc sử dụng Xcode để phát triển ứng dụng cho các nền tảng của Apple (chẳng hạn như iOS).

  • Hãy đảm bảo rằng môi trường phát triển và ứng dụng trên nền tảng Apple của bạn đáp ứng các yêu cầu sau:

    • Xcode 15.0 trở lên
    • Ứng dụng của bạn phải nhắm đến iOS 15 trở lên hoặc macOS 12 trở lên.

  • (Không bắt buộc) Xem ứng dụng mẫu.

    Tải ứng dụng mẫu xuống

    Bạn có thể nhanh chóng dùng thử SDK, xem phương thức triển khai đầy đủ cho nhiều trường hợp sử dụng, hoặc dùng ứng dụng mẫu nếu bạn chưa có ứng dụng nền tảng Apple của riêng mình. Để dùng ứng dụng mẫu, bạn cần kết nối ứng dụng đó với một dự án Firebase.

Bước 1: Thiết lập dự án Firebase và kết nối ứng dụng của bạn với Firebase

Trường hợp bạn đã có một dự án Firebase và một ứng dụng kết nối với Firebase

  1. Trong bảng điều khiển của Firebase, hãy chuyển đến trang Xây dựng bằng Gemini, sau đó nhấp vào thẻ thứ hai để bắt đầu một quy trình công việc giúp bạn thực hiện những việc sau. Nếu bạn thấy một thẻ trong bảng điều khiển của Vertex AI, thì các tác vụ này đã hoàn tất.

  2. Tiếp tục chuyển sang bước tiếp theo trong hướng dẫn này để thêm SDK vào ứng dụng của bạn.

Trường hợp bạn chưa có dự án Firebase và ứng dụng được kết nối với Firebase


Bước 2: Thêm SDK

Sau khi thiết lập dự án Firebase và ứng dụng của bạn được kết nối với Firebase (xem bước trước), giờ đây, bạn có thể thêm SDK Vertex AI cho Firebase vào ứng dụng của mình.

Thư viện Vertex AI cho Firebase cho phép bạn truy cập vào Vertex AI Gemini API và có mặt trong SDK Firebase cho các nền tảng của Apple (firebase-ios-sdk). Đối với thư viện Vertex AI cho Firebase, bạn phải sử dụng Swift Package Manager để cài đặt và quản lý các phần phụ thuộc Firebase. Các trình quản lý gói khác (chẳng hạn như CocoaPods) hiện không được hỗ trợ.

  1. Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến File > Add Packages (Tệp > Thêm gói).

  2. Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple của Firebase:

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

  3. Chọn phiên bản SDK mới nhất.

  4. Chọn thư viện FirebaseVertexAI-Preview.

    Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc của bạn xuống ở chế độ nền.

Bước 3: Khởi chạy dịch vụ Vertex AI và mô hình tạo sinh

Để có thể thực hiện lệnh gọi API, bạn cần khởi chạy dịch vụ Vertex AI và mô hình tạo sinh.

  1. Nhập mô-đun FirebaseVertexAI:

    import FirebaseVertexAI

  2. Khởi chạy dịch vụ Vertex AI và mô hình tạo sinh:

    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")

Sau khi xem xong hướng dẫn bắt đầu sử dụng, hãy tìm hiểu cách chọn một mô hình Gemini và (không bắt buộc) một vị trí phù hợp với trường hợp sử dụng và ứng dụng của bạn.

Bước 4: Gọi Vertex AI Gemini API

Sau khi kết nối ứng dụng của mình với Firebase, thêm SDK và khởi chạy dịch vụ Vertex AI cũng như mô hình tạo sinh, bạn có thể gọi Vertex AI Gemini API.

Bạn có thể sử dụng generateContent() để tạo văn bản từ một yêu cầu lời nhắc chỉ có văn bản:

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)
if let text = response.text {
  print(text)
}

Bạn có thể làm gì khác?

Tìm hiểu thêm về các mô hình Gemini

Tìm hiểu về các mô hình có sẵn cho nhiều trường hợp sử dụng cũng như hạn mức và mức giá của các mô hình đó.

Dùng thử các tính năng khác của Gemini API

Tìm hiểu cách kiểm soát việc tạo nội dung

Bạn cũng có thể thử nghiệm các câu lệnh và cấu hình mô hình bằng Vertex AI Studio.


Gửi ý kiến phản hồi về trải nghiệm của bạn khi dùng Vertex AI cho Firebase