Di chuyển sang SDK Logic AI Firebase từ phiên bản Xem trước của SDK Vertex AI trong Firebase

Hướng dẫn này giúp bạn di chuyển từ các phiên bản Xem trước (hoặc beta) của SDK "Vertex AI in Firebase" sang SDK Firebase AI Logic client.
Các SDK ứng dụng này có sẵn bằng Swift cho các nền tảng của Apple, Kotlin và Java cho Android, JavaScript cho Web, Dart cho Flutter và Unity.

Nếu bạn đang sử dụng phiên bản GA của SDK "Vertex AI in Firebase", hãy xem hướng dẫn về cách di chuyển từ phiên bản GA của SDK.

Firebase AI Logic và các SDK ứng dụng của dịch vụ này trước đây có tên là "Vertex AI in Firebase". Để phản ánh chính xác hơn các dịch vụ và tính năng mở rộng của chúng tôi (ví dụ: hiện chúng tôi hỗ trợ Gemini Developer API!), chúng tôi đã đổi tên và đóng gói lại các dịch vụ của mình thành Firebase AI Logic.

Để truy cập an toàn vào các mô hình AI tạo sinh của Google ngay từ ứng dụng di động hoặc ứng dụng web của bạn, giờ đây, bạn có thể chọn nhà cung cấp "Gemini API" – Vertex AI Gemini API đã có từ lâu hoặc Gemini Developer API mới ra mắt. Điều này có nghĩa là bạn hiện có thể sử dụng Gemini Developer API. API này cung cấp một cấp miễn phí với hạn mức và hạn ngạch hợp lý.

Tổng quan về các bước di chuyển sang Firebase AI Logic SDK

• Bước 1: Chọn nhà cung cấp "Gemini API" phù hợp nhất cho ứng dụng và các trường hợp sử dụng của bạn.

• Bước 2: Bật các API bắt buộc.

• Bước 3: Cập nhật thư viện được dùng trong ứng dụng của bạn.

• Bước 4: Cập nhật quá trình khởi chạy trong ứng dụng.

• Bước 5: Cập nhật mã tuỳ theo các tính năng mà bạn sử dụng.

Bước 1: Chọn nhà cung cấp "Gemini API" phù hợp nhất cho ứng dụng của bạn

Với quá trình di chuyển này, bạn có thể chọn nhà cung cấp "Gemini API":

• SDK "Vertex AI in Firebase" cũ chỉ có thể sử dụng Vertex AI Gemini API.

• Các SDK Firebase AI Logic mới cho phép bạn chọn nhà cung cấp "Gemini API" mà bạn muốn gọi trực tiếp từ ứng dụng di động hoặc ứng dụng web – có thể là Gemini Developer API hoặc Vertex AI Gemini API.

Xem xét sự khác biệt giữa việc sử dụng 2 nhà cung cấp Gemini API, đặc biệt là về các tính năng được hỗ trợ, giá cả và hạn mức. Ví dụ: Gemini Developer API không hỗ trợ việc cung cấp tệp bằng URL Cloud Storage, nhưng đây có thể là lựa chọn phù hợp nếu bạn muốn tận dụng cấp miễn phí và hạn mức hợp lý của dịch vụ này.

Lưu ý quan trọng: Nếu muốn sử dụng "bậc miễn phí" cho Gemini Developer API, bạn cần hạ cấp dự án Firebase mà bạn hiện đang sử dụng với SDK máy khách xuống gói giá Spark không mất phí (tức là huỷ liên kết tài khoản Cloud Billing). Trước khi hạ cấp, hãy đảm bảo rằng bạn không phụ thuộc vào bất kỳ dịch vụ hoặc hạn mức nào khác yêu cầu gói giá Blaze.

Nếu dự án Firebase của bạn vẫn sử dụng Gói giá linh hoạt, thì bạn sẽ sử dụng một trong các "bậc có tính phí" cho Gemini Developer API.

Bước 2: Bật các API bắt buộc

Đảm bảo rằng bạn đã bật tất cả các API bắt buộc trong dự án Firebase để sử dụng nhà cung cấp "Gemini API" mà bạn đã chọn.

Xin lưu ý rằng bạn có thể bật cả hai nhà cung cấp API trong dự án của mình cùng một lúc.

1. Đăng nhập vào bảng điều khiển Firebase, sau đó chọn dự án Firebase của bạn.

2. Trong bảng điều khiển Firebase, hãy chuyển đến trang Firebase AI Logic.

3. Nhấp vào Bắt đầu để chạy một quy trình có hướng dẫn giúp bạn thiết lập các API bắt buộc và tài nguyên cho dự án của mình.

4. Chọn nhà cung cấp "Gemini API" mà bạn muốn dùng với các SDK Firebase AI Logic. Bạn luôn có thể thiết lập và sử dụng nhà cung cấp API khác sau này nếu muốn.

   • Gemini Developer API – thanh toán không bắt buộc (có trong gói giá Spark không tốn phí)
     Quy trình làm việc của bảng điều khiển sẽ bật các API bắt buộc và tạo khoá API Gemini trong dự án của bạn.
     Đừng thêm khoá API Gemini này vào cơ sở mã của ứng dụng. Tìm hiểu thêm.

   • Vertex AI Gemini API – bắt buộc phải thanh toán (yêu cầu gói giá linh hoạt Blaze)
     Quy trình làm việc của bảng điều khiển sẽ bật các API bắt buộc trong dự án của bạn.

5. Tiếp tục theo dõi hướng dẫn di chuyển này để cập nhật thư viện và quá trình khởi chạy trong ứng dụng của bạn.

Bước 3: Cập nhật thư viện được dùng trong ứng dụng của bạn

Cập nhật cơ sở mã của ứng dụng để sử dụng thư viện Firebase AI Logic.

Swift

1. Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy cập nhật gói Firebase lên phiên bản 11.13.0 trở lên bằng một trong các lựa chọn sau:

   • Cách 1: Cập nhật tất cả các gói: Chuyển đến File > Packages > Update to Latest Package Versions (Tệp > Gói > Cập nhật lên phiên bản gói mới nhất).

   • Cách 2: Cập nhật Firebase riêng lẻ: Chuyển đến gói Firebase trong phần có tên là Phần phụ thuộc của gói. Nhấp chuột phải vào gói Firebase, rồi chọn Update Package (Cập nhật gói).

2. Đảm bảo rằng gói Firebase hiện hiển thị phiên bản 11.13.0 trở lên. Nếu không, hãy xác minh rằng Yêu cầu về gói mà bạn chỉ định cho phép cập nhật lên phiên bản 11.13.0 trở lên.

3. Chọn mục tiêu của ứng dụng trong Project Editor (Trình chỉnh sửa dự án), sau đó chuyển đến phần Frameworks, Libraries, and Embedded Content (Khung, thư viện và nội dung được nhúng).

4. Thêm thư viện mới: Chọn nút +, rồi thêm FirebaseAI từ gói Firebase.

5. Sau khi bạn hoàn tất việc di chuyển ứng dụng (xem các phần còn lại trong hướng dẫn này), hãy nhớ xoá thư viện cũ:
   Chọn FirebaseVertexAI-Preview, sau đó nhấn nút —.

Kotlin

1. Trong tệp Gradle (cấp ứng dụng) của mô-đun (thường là <project>/<app-module>/build.gradle.kts hoặc <project>/<app-module>/build.gradle), hãy thay thế các phần phụ thuộc cũ (nếu có) bằng phần phụ thuộc sau.

   Xin lưu ý rằng bạn có thể dễ dàng di chuyển cơ sở mã của ứng dụng (xem các phần còn lại trong hướng dẫn này) trước khi xoá phần phụ thuộc cũ.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:33.16.0"))
   
     // Add the dependency for the Firebase AI Logic library
     // When using the BoM, you don't specify versions in Firebase library dependencies
     implementation("com.google.firebase:firebase-ai")
   }

2. Đồng bộ hoá dự án Android với các tệp Gradle.

Xin lưu ý rằng nếu bạn chọn không sử dụng Firebase Android BoM, thì chỉ cần thêm phần phụ thuộc cho thư viện firebase-ai và chấp nhận phiên bản mới nhất do Android Studio đề xuất.

Java

1. Trong tệp Gradle (cấp ứng dụng) của mô-đun (thường là <project>/<app-module>/build.gradle.kts hoặc <project>/<app-module>/build.gradle), hãy thay thế các phần phụ thuộc cũ (nếu có) bằng phần phụ thuộc sau.

   Xin lưu ý rằng bạn có thể dễ dàng di chuyển cơ sở mã của ứng dụng (xem các phần còn lại trong hướng dẫn này) trước khi xoá phần phụ thuộc cũ.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:33.16.0"))
   
     // Add the dependency for the Firebase AI Logic library
     // When using the BoM, you don't specify versions in Firebase library dependencies
     implementation("com.google.firebase:firebase-ai")
   }

2. Đồng bộ hoá dự án Android với các tệp Gradle.

Xin lưu ý rằng nếu bạn chọn không sử dụng Firebase Android BoM, thì chỉ cần thêm phần phụ thuộc cho thư viện firebase-ai và chấp nhận phiên bản mới nhất do Android Studio đề xuất.

Web

1. Tải phiên bản mới nhất của Firebase JS SDK cho Web bằng npm:

   npm i firebase@latest

   HOẶC

   yarn add firebase@latest

2. Bất cứ nơi nào bạn đã nhập thư viện, hãy cập nhật câu lệnh nhập để sử dụng firebase/ai thay thế.

   Xin lưu ý rằng bạn có thể dễ dàng di chuyển cơ sở mã của ứng dụng (xem các phần còn lại trong hướng dẫn này) trước khi xoá các hoạt động nhập cũ.

   // BEFORE
   import { initializeApp } from "firebase/app";
   import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";
   
   
   // AFTER
   import { initializeApp } from "firebase/app";
   import { getAI, getGenerativeModel } from "firebase/ai";

Dart

1. Cập nhật để sử dụng gói firebase_ai trong tệp pubspec.yaml bằng cách chạy lệnh sau trong thư mục dự án Flutter:

   flutter pub add firebase_ai

2. Tạo lại dự án Flutter:

   flutter run

3. Sau khi bạn hoàn tất việc di chuyển ứng dụng (xem các phần còn lại trong hướng dẫn này), hãy nhớ xoá gói cũ:

   flutter pub remove firebase_vertexai

Unity

Không có dịch vụ hỗ trợ cho Unity từ "Vertex AI in Firebase".

Tìm hiểu cách bắt đầu sử dụng Firebase AI Logic SDK cho Unity.

Bước 4: Cập nhật quá trình khởi tạo trong ứng dụng

Nhấp vào nhà cung cấp Gemini API để xem nội dung và mã dành riêng cho nhà cung cấp trên trang này. Gemini Developer API Vertex AI Gemini API

Cập nhật cách bạn khởi chạy dịch vụ cho nhà cung cấp API đã chọn và tạo một thực thể GenerativeModel.

Swift

import FirebaseAI

// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-2.5-flash")

Kotlin

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
                        .generativeModel("gemini-2.5-flash")

Java

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
        .generativeModel("gemini-2.5-flash");

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

Web

import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";

// 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 Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-2.5-flash" });

Dart

import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.googleAI().generativeModel(model: 'gemini-2.5-flash');

Unity

Không có dịch vụ hỗ trợ cho Unity từ "Vertex AI in Firebase".

Tìm hiểu cách bắt đầu sử dụng Firebase AI Logic SDK cho Unity.

Xin lưu ý rằng tuỳ thuộc vào chức năng mà bạn đang sử dụng, không phải lúc nào bạn cũng tạo một thực thể GenerativeModel.

• Để truy cập vào một mô hình Imagen, hãy tạo một thực thể ImagenModel.

Bước 5: Cập nhật mã tuỳ theo các tính năng mà bạn sử dụng

Bước này mô tả những thay đổi có thể cần thiết, tuỳ thuộc vào những tính năng bạn sử dụng.

• Nếu bạn sử dụng URL Cloud Storage và bạn đã chuyển đổi để sử dụng Gemini Developer API trong quá trình di chuyển này, thì bạn phải cập nhật các yêu cầu đa phương thức để đưa tệp vào dưới dạng dữ liệu nội tuyến (hoặc sử dụng URL YouTube cho video).

• Một số thay đổi đã được áp dụng cho các phiên bản GA của SDK "Vertex AI in Firebase". Bạn cũng phải thực hiện những thay đổi tương tự để sử dụng các SDK Firebase AI Logic. Hãy xem xét các danh sách sau để biết mọi thay đổi mà bạn có thể cần thực hiện trong mã của mình để đáp ứng việc sử dụng SDK Firebase AI Logic.

Bắt buộc đối với tất cả ngôn ngữ và nền tảng

• Gọi hàm
  Nếu đã triển khai tính năng này trước khi phát hành công khai, thì bạn cần phải cập nhật cách xác định giản đồ. Bạn nên xem hướng dẫn gọi hàm mới cập nhật để tìm hiểu cách viết các khai báo hàm.

• Tạo đầu ra có cấu trúc (chẳng hạn như JSON) bằng cách sử dụng responseSchema
  Nếu đã triển khai tính năng này trước khi GA, thì bạn cần phải cập nhật cách xác định giản đồ. Bạn nên tham khảo hướng dẫn mới về đầu ra có cấu trúc để tìm hiểu cách viết giản đồ JSON.

• Hết thời gian

  • Đã thay đổi thời gian chờ mặc định cho các yêu cầu thành 180 giây.

Bắt buộc dựa trên nền tảng hoặc ngôn ngữ

Swift

• Liệt kê

  • Thay thế hầu hết các loại enum bằng struct có các biến tĩnh. Thay đổi này giúp API linh hoạt hơn khi phát triển theo cách tương thích ngược. Khi sử dụng câu lệnh switch, giờ đây, bạn phải thêm trường hợp default: để bao gồm các giá trị không xác định hoặc chưa được xử lý, kể cả các giá trị mới được thêm vào SDK trong tương lai.

  • Đổi tên phép liệt kê BlockThreshold thành HarmBlockThreshold; loại này hiện là struct.

  • Đã xoá các trường hợp unknown và unspecified khỏi các kiểu liệt kê sau (hiện là struct): HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason và FinishReason.

  • Thay thế kiểu liệt kê ModelContent.Part bằng một giao thức có tên là Part để cho phép thêm các loại mới theo cách tương thích ngược. Thay đổi này được mô tả chi tiết hơn trong phần Các phần nội dung.

• Các phần nội dung

  • Xoá giao thức ThrowingPartsRepresentable và đơn giản hoá trình khởi chạy cho ModelContent để tránh lỗi trình biên dịch không thường xuyên. Những hình ảnh không được mã hoá đúng cách vẫn sẽ gửi lỗi khi được dùng trong generateContent.

  • Thay thế các trường hợp ModelContent.Part bằng các loại struct sau đây tuân theo giao thức Part:

    • .text đến TextPart
    • .data đến InlineDataPart
    • .fileData đến FileDataPart
    • .functionCall đến FunctionCallPart
    • .functionResponse đến FunctionResponsePart

• Danh mục nội dung gây hại

  • Thay đổi HarmCategory để không còn được lồng trong loại SafetySetting nữa. Nếu bạn đang đề cập đến SafetySetting.HarmCategory, thì bạn có thể thay thế bằng HarmCategory.

• Ý kiến phản hồi về an toàn

  • Đã xoá loại SafetyFeedback vì loại này không được dùng trong bất kỳ phản hồi nào.

• Siêu dữ liệu trích dẫn

  • Đổi tên thuộc tính citationSources thành citations trong CitationMetadata.

• Tổng số ký tự có tính phí

  • Đã thay đổi thuộc tính totalBillableCharacters trong CountTokensResponse thành không bắt buộc để phản ánh những trường hợp không có ký tự nào được gửi.

• Phản hồi của ứng viên

  • Đổi tên CandidateResponse thành Candidate cho phù hợp với các nền tảng khác.

• Cấu hình tạo

  • Đã thay đổi các thuộc tính công khai của GenerationConfig thành internal. Tất cả các tham số này vẫn có thể định cấu hình trong trình khởi tạo.

Kotlin

• Liệt kê

  • Thay thế các lớp enum và sealed bằng các lớp thông thường. Thay đổi này giúp API linh hoạt hơn khi phát triển theo cách tương thích ngược.

  • Đổi tên giá trị liệt kê BlockThreshold thành HarmBlockThreshold.

  • Đã xoá các giá trị khỏi các giá trị liệt kê sau: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason và FinishReason.

• Phương thức Blob

  • Đã đổi tên tất cả các phương thức có Blob trong tên để sử dụng InlineData thay thế.

• Chế độ cài đặt an toàn

  • Đã thay đổi trường method thành có thể rỗng.

• Lớp thời lượng

  • Xoá tất cả các cách sử dụng lớp Duration của Kotlin và thay thế bằng long. Thay đổi này giúp cải thiện khả năng tương tác với Java.

• Siêu dữ liệu trích dẫn

  • Bao bọc tất cả các trường đã khai báo trước đó trong CitationMetadata vào một lớp mới có tên là Citation. Bạn có thể tìm thấy các trích dẫn trong danh sách có tên là citations trong CitationMetadata. Thay đổi này giúp điều chỉnh các loại trên nhiều nền tảng một cách hiệu quả hơn.

• Đếm số lượng mã thông báo

  • Đã thay đổi trường totalBillableCharacters thành có thể rỗng.

• Tổng số ký tự có tính phí

  • Đã thay đổi thuộc tính totalBillableCharacters trong CountTokensResponse thành không bắt buộc để phản ánh những trường hợp không có ký tự nào được gửi.

• Khởi tạo một mô hình

  • Đã di chuyển tham số requestOptions xuống cuối danh sách tham số để phù hợp với các nền tảng khác.

• Live API

  • Đã xoá giá trị UNSPECIFIED cho lớp enum ResponseModality. Thay vào đó, hãy dùng null.

  • Đổi tên LiveGenerationConfig.setResponseModalities thành LiveGenerationConfig.setResponseModality.

  • Xoá lớp LiveContentResponse.Status và thay vào đó, lồng các trường trạng thái làm thuộc tính của LiveContentResponse.

  • Xoá lớp LiveContentResponse và thay vào đó, cung cấp các lớp con của LiveServerMessage khớp với các phản hồi từ mô hình.

  • Đã thay đổi LiveModelFutures.connect để trả về ListenableFuture<LiveSessionFutures> thay vì ListenableFuture<LiveSession>.

Java

• Liệt kê

  • Thay thế các lớp enum và sealed bằng các lớp thông thường. Thay đổi này giúp API linh hoạt hơn khi phát triển theo cách tương thích ngược.

  • Đổi tên giá trị liệt kê BlockThreshold thành HarmBlockThreshold.

  • Đã xoá các giá trị khỏi các giá trị liệt kê sau: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason và FinishReason.

• Phương thức Blob

  • Đã đổi tên tất cả các phương thức có Blob trong tên để sử dụng InlineData thay thế.

• Chế độ cài đặt an toàn

  • Đã thay đổi trường method thành có thể rỗng.

• Lớp thời lượng

  • Xoá tất cả các cách sử dụng lớp Duration của Kotlin và thay thế bằng long. Thay đổi này giúp cải thiện khả năng tương tác với Java.

• Siêu dữ liệu trích dẫn

  • Bao bọc tất cả các trường đã khai báo trước đó trong CitationMetadata vào một lớp mới có tên là Citation. Bạn có thể tìm thấy các trích dẫn trong danh sách có tên là citations trong CitationMetadata. Thay đổi này giúp điều chỉnh các loại trên nhiều nền tảng một cách hiệu quả hơn.

• Đếm số lượng mã thông báo

  • Đã thay đổi trường totalBillableCharacters thành có thể rỗng.

• Tổng số ký tự có tính phí

  • Đã thay đổi thuộc tính totalBillableCharacters trong CountTokensResponse thành không bắt buộc để phản ánh những trường hợp không có ký tự nào được gửi.

• Khởi tạo một mô hình

  • Đã di chuyển tham số requestOptions xuống cuối danh sách tham số để phù hợp với các nền tảng khác.

• Live API

  • Đã xoá giá trị UNSPECIFIED cho lớp enum ResponseModality. Thay vào đó, hãy dùng null.

  • Đổi tên LiveGenerationConfig.setResponseModalities thành LiveGenerationConfig.setResponseModality.

  • Xoá lớp LiveContentResponse.Status và thay vào đó, lồng các trường trạng thái làm thuộc tính của LiveContentResponse.

  • Xoá lớp LiveContentResponse và thay vào đó, cung cấp các lớp con của LiveServerMessage khớp với các phản hồi từ mô hình.

  • Đã thay đổi LiveModelFutures.connect để trả về ListenableFuture<LiveSessionFutures> thay vì ListenableFuture<LiveSession>.

• Đã thay đổi nhiều phương thức trình tạo Java để hiện trả về chính xác thực thể của lớp, thay vì void.

Web

• Liệt kê

  • Đã xoá các giá trị khỏi các giá trị liệt kê sau: HarmCategory, BlockThreshold, HarmProbability, HarmSeverity, BlockReason và FinishReason.

• Lý do chặn

  • Đã thay đổi blockReason trong PromptFeedback thành không bắt buộc.

Bạn chỉ cần thay đổi nếu bắt đầu sử dụng Gemini Developer API (thay vì Vertex AI Gemini API):

• Chế độ cài đặt an toàn

  • Xoá các lượt sử dụng SafetySetting.method không được hỗ trợ.

• Dữ liệu nội tuyến

  • Xoá các lượt sử dụng InlineDataPart.videoMetadata không được hỗ trợ.

Dart

• Liệt kê

  • Đã xoá các giá trị khỏi các giá trị liệt kê sau: HarmCategory, HarmProbability, BlockReason và FinishReason.

• Phần dữ liệu

  • Đổi tên DataPart thành InlineDataPart và hàm static data thành inlineData để phù hợp với các nền tảng khác.

• Lựa chọn yêu cầu

  • Xoá RequestOptions vì timeout không hoạt động. Chúng tôi sẽ thêm lại tính năng này trong tương lai gần, nhưng sẽ chuyển tính năng này sang loại GenerativeModel để phù hợp với các nền tảng khác.

• Dừng chuỗi

  • Thay đổi tham số stopSequences trong GenerationConfig thành tham số không bắt buộc và mặc định là null thay vì một mảng trống.

• Trích dẫn

  • Đổi tên thuộc tính citationSources thành citations trong CitationMetadata. Loại CitationSource được đổi tên thành Citation để phù hợp với các nền tảng khác.

• Các loại, phương thức và thuộc tính công khai không cần thiết

  • Xoá các loại, phương thức và thuộc tính sau đây đã vô tình bị lộ: defaultTimeout, CountTokensResponseFields, parseCountTokensResponse, parseEmbedContentResponse, parseGenerateContentResponse, parseContent, BatchEmbedContentsResponse, ContentEmbedding, EmbedContentRequest và EmbedContentResponse.

• Đếm số lượng mã thông báo

  • Xoá các trường bổ sung không còn cần thiết khỏi hàm countTokens. Bạn chỉ cần contents.

• Khởi tạo một mô hình

  • Di chuyển tham số systemInstruction xuống cuối danh sách tham số để phù hợp với các nền tảng khác.

• Chức năng nhúng

  • Xoá chức năng nhúng không được hỗ trợ (embedContent và batchEmbedContents) khỏi mô hình.

Unity

Không có dịch vụ hỗ trợ cho Unity từ "Vertex AI in Firebase".

Tìm hiểu cách bắt đầu sử dụng Firebase AI Logic SDK cho Unity.

Các lỗi có thể xảy ra liên quan đến việc di chuyển

Khi di chuyển để sử dụng phiên bản GA của Firebase AI Logic, bạn có thể gặp lỗi nếu chưa hoàn tất tất cả các thay đổi bắt buộc như mô tả trong hướng dẫn di chuyển này.

Lỗi 403: Requests to this API firebasevertexai.googleapis.com ... are blocked.

Nếu bạn nhận được lỗi 403 có nội dung Requests to this API firebasevertexai.googleapis.com ... are blocked., thì điều này thường có nghĩa là khoá API Firebase trong tệp hoặc đối tượng cấu hình Firebase của bạn không có API bắt buộc trong danh sách cho phép đối với sản phẩm mà bạn đang cố gắng sử dụng.

Đảm bảo rằng khoá API Firebase mà ứng dụng của bạn sử dụng có tất cả các API bắt buộc có trong danh sách cho phép "hạn chế API" của khoá. Đối với Firebase AI Logic, khoá API Firebase của bạn cần có ít nhất API Firebase AI Logic trong danh sách cho phép. API này sẽ tự động được thêm vào danh sách cho phép của khoá API khi bạn bật các API bắt buộc trong bảng điều khiển Firebase.

Bạn có thể xem tất cả khoá API trong bảng điều khiển API và Dịch vụ > Thông tin xác thực trong bảng điều khiển Google Cloud.

Lưu ý: Các API liên quan đến Firebase chỉ sử dụng khoá API để xác định dự án hoặc ứng dụng Firebase, không dùng để uỷ quyền gọi API (như một số API khác cho phép). Việc uỷ quyền cho các API liên quan đến Firebase được xử lý riêng biệt với khoá API, thông qua quyền quản lý danh tính và quyền truy cập (IAM) Google Cloud, Firebase Security Rules hoặc Firebase App Check. Tìm hiểu thêm về khoá API Firebase.

Gửi ý kiến phản hồi về trải nghiệm của bạn với Firebase AI Logic