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 phát triển ứng dụng bằng Flutter.
Đảm bảo rằng môi trường phát triển và ứng dụng web của bạn đáp ứng các yêu cầu sau:
- Dart 3.2.0 trở lên
(Không bắt buộc) Xem ứng dụng mẫu.
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 web 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
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
.
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.
Trình bổ trợ Vertex AI cho Firebase dành cho Flutter (firebase_vertexai
) cung cấp quyền truy cập vào Vertex AI Gemini API.
Trong thư mục dự án Flutter, hãy chạy lệnh sau để cài đặt trình bổ trợ cốt lõi:
flutter pub add firebase_core
Trong tệp
lib/main.dart
, hãy nhập trình bổ trợ chính Firebase và tệp cấu hình mà bạn đã tạo trước đó:import 'package:firebase_core/firebase_core.dart'; import 'firebase_options.dart';
Ngoài ra, trong tệp
lib/main.dart
, hãy khởi chạy Firebase bằng cách sử dụng đối tượngDefaultFirebaseOptions
mà tệp cấu hình xuất:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
Tạo lại ứng dụng Flutter:
flutter run
Trong thư mục dự án Flutter, hãy chạy lệnh sau:
flutter pub add firebase_vertexai
Sau khi hoàn tất, hãy tạo lại dự án Flutter của bạn:
flutter run
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.
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
// Initialize FirebaseApp
await Firebase.initializeApp();
// 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
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash-preview-0514');
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 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
await Firebase.initializeApp();
// 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
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash-preview-0514');
// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];
// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.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 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