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

iOS+ Android Web Flutter

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 xem trước của thư viện Vertex AI in Firebase (FirebaseVertexAI-Preview), 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 (FirebaseVertexAI).

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)
• 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)
• 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)

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.

Lưu ý: Bạn vẫn cần bật Vertex AI API (aiplatform.googleapis.com) trong dự án (nhưng không được đưa vào danh sách cho phép của khoá API).

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)

iOS+ Android Web Flutter

Hãy làm theo hướng dẫn sau để cập nhật cơ sở mã của ứng dụng nhằm sử dụng phiên bản GA của thư viện:

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

   • Cách 1: Cập nhật tất cả gói: Chuyển đến File (Tệp) > Packages (Gói) > Update to Latest Package Versions (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 mục Package Dependencies (Phần phụ thuộc gói). Nhấp chuột phải vào gói Firebase, sau đó chọn 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.4.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.8.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 nhúng).

4. Chọn nút +, sau đó thêm FirebaseVertexAI từ gói Firebase.

5. Chọn FirebaseVertexAI-Preview, rồi nhấn nú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)

iOS+ Android Web Flutter

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ế hầu hết các loại enum bằng struct có biến tĩnh. 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. 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ý, bao gồm cả các giá trị mới được thêm vào SDK trong tương lai.

  • Đổi tên enum 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 giá trị liệt kê sau (hiện là struct): HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason và FinishReason.

  • Thay thế enum ModelContent.Part bằng một giao thức có tên 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 Phần nội dung.

• 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 các lỗi trình biên dịch thỉnh thoảng xảy ra. Những hình ảnh không được mã hoá đúng cách vẫn sẽ gửi lỗi khi được sử 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 thủ giao thức Part:

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

• Danh mục gây hại

  • Thay đổi HarmCategory để không còn lồng trong loại SafetySetting. Nếu bạn đang tham chiếu đến lớp này là SafetySetting.HarmCategory, thì bạn có thể thay thế bằng HarmCategory.

• Ý kiến phản hồi về sự 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ó 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.

• Phản hồi của đề xuất

  • Đổi tên CandidateResponse thành Candidate để khớ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 thuộc tính này vẫn có thể định cấu hình trong trình khởi tạo.

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.

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 phải để 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 với khoá API, thông qua các quyền IAM Google Cloud, Firebase Security Rules hoặc Firebase App Check. Tìm hiểu thêm về khoá API Firebase.