Hướng dẫn này chỉ cho bạn cách bắt đầu gọi điện đến Vertex AI Gemini API ngay trong ứng dụng của bạn bằng cách sử dụng SDK Vertex AI in Firebase dành cho nền tảng mà bạn đã chọn.
Đ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 JavaScript để phát triển ứng dụng web. Hướng dẫn này độc lập với khung.
Đả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 các yêu cầu:
- (Không bắt buộc) Node.js
- Trình duyệt web hiện đại
(Không bắt buộc) Xem ứng dụng mẫu.
Bạn có thể nhanh chóng dùng thử SDK, xem việc triển khai đầy đủ nhiều cách sử dụng hoặc sử 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 sẽ cần phải kết nối tài khoản đó 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 Firebase, hãy chuyển đến Trang Xây dựng bằng Gemini.
Nhấp vào thẻ Vertex AI in Firebase để bắt đầu một quy trình công việc giúp bạn hoàn thành các nhiệm vụ sau. (Lưu ý rằng nếu bạn thấy một thẻ trong bảng điều khiển dành cho Vertex AI, thì các nhiệm vụ này đã hoàn thành.)
Nâng cấp dự án của bạn để sử dụng Gói giá linh hoạt trả tiền theo mức dùng.
Hãy bật hai 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 in Firebase vào ứng dụng của mình.
Thư viện Vertex AI in Firebase cung cấp quyền truy cập vào Vertex AI Gemini API và được đưa vào như một phần của Firebase JavaScript SDK dành cho Web.
Cài đặt Firebase JS SDK cho Web bằng cách sử dụng npm:
npm install firebase
Khởi chạy Firebase trong ứng dụng của bạn:
import { initializeApp } from "firebase/app"; // TODO(developer) Replace the following with your app's Firebase configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize FirebaseApp const firebaseApp = initializeApp(firebaseConfig);
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 Vertex AI và mô hình tạo sinh.
import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";
// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
// ...
};
// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);
// Initialize the Vertex AI service
const vertexAI = getVertexAI(firebaseApp);
// 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
const model = getGenerativeModel(vertexAI, { model: "gemini-1.5-flash" });
Khi bạn đọc xong hướng dẫn bắt đầu, hãy tìm hiểu cách chọn một Mô hình Gemini và (không bắt buộc) 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
Bây giờ, bạn đã 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 và mô hình tạo sinh, bạn đã sẵn sàng gọi Vertex AI Gemini API.
Bạn có thể dùng generateContent()
để tạo văn bản từ một câu lệnh chỉ có văn bản
yêu cầu:
import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";
// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
// ...
};
// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);
// Initialize the Vertex AI service
const vertexAI = getVertexAI(firebaseApp);
// 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
const model = getGenerativeModel(vertexAI, { model: "gemini-1.5-flash" });
// Wrap in an async function so you can use await
async function run() {
// Provide a prompt that contains text
const prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
const result = await model.generateContent(prompt);
const response = result.response;
const text = response.text();
console.log(text);
}
run();
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ề những mô hình có sẵn cho nhiều trường hợp sử dụng và hạn mức và giá.
Hãy 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ách phát trực tuyến câu trả lời.
- Tạo văn bản từ câu lệnh đa phương thức (bao gồm văn bản, hình ảnh, PDF, video và âm thanh).
- Tạo cuộc trò chuyện nhiều lượt (trò chuyện).
- Sử dụng tính năng gọi hàm để kết nối các mô hình tạo sinh sang 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 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 thông số của mô hình như nhiệt độ và mã thông báo đầu ra tối đa.
- Sử dụng cài đặt an toàn để điều chỉnh khả năng nhận được phản hồi có thể bị coi là gây hại.
Gửi ý kiến phản hồi về trải nghiệm của bạn với Vertex AI in Firebase