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

iOS+ Android Web Flutter

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 Android Studio để phát triển ứng dụng cho Android.

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

  • Android Studio (phiên bản mới nhất)
  • Ứng dụng Android của bạn phải nhắm đến API cấp 21 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 cách triển khai đầy đủ các 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 Android của riêng mình. Để sử 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.

   • Nâng cấp dự án của bạn để sử dụng Gói giá theo mức dùng trả trước.

   • Bật 2 API sau cho dự án của bạn:
     aiplatform.googleapis.com và firebaseml.googleapis.com.

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.

SDK Vertex AI cho Firebase dành cho Android (firebase-vertexai) cung cấp quyền truy cập vào Vertex AI Gemini API.

Trong tệp cấu hình Gradle mô-đun (cấp ứng dụng) (chẳng hạn như <project>/<app-module>/build.gradle.kts), hãy thêm phần phụ thuộc cho SDK Vertex AI cho Firebase dành cho Android:

dependencies {
  // ... other androidx dependencies

  // add the dependency for the Vertex AI for Firebase SDK for Android
  implementation("com.google.firebase:firebase-vertexai:16.0.0-beta02")
}

dependencies {
  // ... other androidx dependencies

  // add the dependency for the Vertex AI for Firebase SDK for Android
  implementation("com.google.firebase:firebase-vertexai:16.0.0-beta02")

  // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
  implementation("com.google.guava:guava:31.0.1-android")

  // Required for streaming operations (to use `Publisher` from Reactive Streams)
  implementation("org.reactivestreams:reactive-streams:1.0.4")
}

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.

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
val generativeModel = Firebase.vertexAI.generativeModel("gemini-1.5-flash")

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
GenerativeModel gm = FirebaseVertexAI.getInstance()
        .generativeModel("gemini-1.5-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(gm);

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:

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
val generativeModel = Firebase.vertexAI.generativeModel("gemini-1.5-flash")

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

// To generate text output, call generateContent with the text input
val response = generativeModel.generateContent(prompt)
print(response.text)

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
GenerativeModel gm = FirebaseVertexAI.getInstance()
        .generativeModel("gemini-1.5-flash");
GenerativeModelFutures model = GenerativeModelFutures.from(gm);

// Provide a prompt that contains text
Content prompt = new Content.Builder()
    .addText("Write a story about a magic backpack.")
    .build();

// To generate text output, call generateContent with the text input
ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        System.out.println(resultText);
    }

    @Override
    public void onFailure(Throwable t) {
        t.printStackTrace();
    }
}, executor);

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

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

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

• Tìm hiểu thêm về cách tạo văn bản từ các câu lệnh chỉ có văn bản, bao gồm cả cách truyền trực tuyến phản hồi.
• Tạo văn bản từ các câu lệnh đa phương thức (bao gồm văn bản, hình ảnh, tệp PDF, video và âm thanh).
• Tạo cuộc trò chuyện nhiều lượt (trò chuyện).
• Sử dụng phương thức gọi hàm để kết nối các mô hình tạo sinh với các hệ thống và thông tin bên ngoài.

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

• Tìm hiểu về thiết kế lời nhắc, bao gồm cả các phương pháp hay nhất, chiến lược và ví dụ về câu lệnh.
• Định cấu hình các tham số của mô hình như nhiệt độ và mã thông báo đầu ra tối đa.
• Sử dụng chế độ cài đặt an toàn để điều chỉnh khả năng nhận được những phản hồi có thể được coi là gây hại.

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