Di chuyển để sử dụng phiên bản GA của Vertex AI trong Firebase


Vertex AI in Firebase ra mắt phiên bản chính thức (GA) vào ngày 21 tháng 10 năm 2024.

Nếu đã sử dụng phiên bản beta của thư viện Vertex AI in Firebase (firebase-vertexai:16.0.0-betaXX), thì bạn cần thực hiện các thay đổi sau để nâng cấp lên phiên bản GA của thư viện (firebase-vertexai:16.0.0 trở lên).

Sau đây là danh sách các thay đổi cần thiết để di chuyển:

Bật API bắt buộc mới trong dự án Firebase (bắt buộc đối với mọi người)

Bạn cần bật API Vertex AI in Firebase trong dự án Firebase và thêm API đó vào danh sách cho phép của khoá API Firebase. Đây là một API mới bắt buộc phải sử dụng phiên bản GA của Vertex AI in Firebase.

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang Tạo bằng Gemini.

  2. Trong thẻ Vertex AI in Firebase, hãy nhấp vào Bắt đầu để chạy quy trình giúp bạn bật API này và thêm API này vào danh sách cho phép của khoá API Firebase.

  3. Bạn có thể bỏ qua phần còn lại của quy trình công việc trong bảng điều khiển.

Cập nhật lên phiên bản GA của thư viện (bắt buộc đối với tất cả mọi người)

Làm theo hướng dẫn sau để cập nhật các phần phụ thuộc nhằm sử dụng phiên bản mới nhất của Firebase Android BoM. Bạn không bắt buộc phải sử dụng BoM, nhưng bạn nên sử dụng vì điều này giúp đảm bảo rằng ứng dụng của bạn đang sử dụng các phiên bản tương thích của từng thư viện Firebase.

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

    // 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.10.0"))
    
      // Add the dependency for the Vertex AI in Firebase library
      // When using the BoM, you don't specify versions in Firebase library dependencies
      implementation("com.google.firebase:firebase-vertexai")
    }
  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 BoM, thì chỉ cần chấp nhận phiên bản firebase-vertexai mới nhất do Android Studio đề xuất.

Các thay đổi khác (bắt buộc tuỳ thuộc vào các tính năng bạn sử dụng)

Một số thay đổi đã được triển khai cho các phiên bản GA của SDK. Xem xét các danh sách sau đây để biết mọi thay đổi mà bạn có thể cần thực hiện trong mã của mình nhằm hỗ trợ việc sử dụng phiên bản GA của SDK trong ứng dụng.

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

  • Tạo đầu ra có cấu trúc (như JSON) bằng responseSchema
    Nếu đã triển khai tính năng này trước khi GA, bạn cần 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.

  • Giới hạn thời gian

    • Thay đổi thời gian chờ mặc định cho các yêu cầu thành 180 giây.
  • Danh sách liệt kê

    • Thay thế các lớp enumsealed bằng các lớp thông thường. Thay đổi này cho phép linh hoạt hơn trong việc phát triển API theo cách tương thích ngược.

    • Đổi tên enum BlockThreshold thành HarmBlockThreshold.

    • Xoá các giá trị khỏi các enum sau: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReasonFinishReason.

  • Phương thức blob

    • Đổi tên tất cả các phương thức có tên bao gồm Blob thành InlineData.
  • Cài đặt an toàn

    • Thay đổi trường method thành có thể nhận giá trị rỗng.
  • Lớp thời lượng

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

    • Gói 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 citations trong CitationMetadata. Thay đổi này cho phép căn chỉnh các loại tốt hơn trên các nền tảng.
  • Tính số lượng mã thông báo

    • Thay đổi trường totalBillableCharacters thành có thể nhận giá trị rỗng.
  • Tổng số ký tự có thể tính phí

    • Thay đổi thuộc tính totalBillableCharacters trong CountTokensResponse thành không bắt buộc để phản ánh các trường hợp không gửi ký tự nào.
  • Tạo bản sao mô hình

    • Chuyển tham số requestOptions vào cuối danh sách tham số để phù hợp với các nền tảng khác.

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 Vertex AI in Firebase, 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 trong tệp/đối tượng cấu hình Firebase không có API bắt buộc trong danh sách cho phép cho sản phẩm mà bạn đang cố gắng sử dụng.

Đảm bảo rằng khoá API mà ứng dụng của bạn sử dụng có tất cả API bắt buộc có trong danh sách cho phép "Hạn chế API" của khoá. Đối với Vertex AI in Firebase, khoá API của bạn cần có ít nhất API Vertex AI in Firebase 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 API mới thông qua 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.