Câu hỏi thường gặp và cách khắc phục sự cố

Bạn phải bật API nào để sử dụng SDK Vertex AI in Firebase? Làm cách nào để bật các tính năng này?

Để sử dụng SDK Vertex AI in Firebase, dự án của bạn phải bật hai API sau:

Vertex AI API (aiplatform.googleapis.com)
Vertex AI in Firebase API (firebasevertexai.googleapis.com)

Bạn có thể bật các API này chỉ bằng vài thao tác nhấp chuột trong bảng điều khiển Firebase:

Chuyển đến trang Tạo bằng Gemini.
Nhấp vào thẻ Vertex AI in Firebase để chạy quy trình công việc cho phép hai API. Quy trình công việc này cũng sẽ thêm API Vertex AI in Firebase vào danh sách cho phép của khoá API Firebase.

Ngoài ra, bạn có thể sử dụng bảng điều khiển Google Cloud (tuỳ chọn thủ công hơn):

Nhấp vào từng đường liên kết API ở đầu mục Câu hỏi thường gặp này, sau đó nhấp vào Bật trong trang của từng API.
Thêm API Vertex AI in Firebase vào danh sách cho phép của khoá API Firebase bằng cách làm theo hướng dẫn trong phần Thêm quy tắc hạn chế API trong tài liệu về Google Cloud.

Cần có những quyền nào để sử dụng SDK Vertex AI in Firebase?

Thao tác	Các quyền IAM bắt buộc	(Các) vai trò IAM có các quyền bắt buộc theo mặc định
Nâng cấp gói thanh toán lên gói giá trả tiền theo mức dùng (Blaze)	`firebase.billingPlans.update` `resourcemanager.projects.createBillingAssignment` `resourcemanager.projects.deleteBillingAssignment`	Chủ sở hữu
Bật API trong dự án	`serviceusage.services.enable`	Người chỉnh sửa Chủ sở hữu
Tạo ứng dụng Firebase	`firebase.clients.create`	Quản trị viên Firebase Người chỉnh sửa Chủ sở hữu

Bạn có thể sử dụng những mô hình nào với SDK Vertex AI in Firebase?

Bạn có thể sử dụng SDK Vertex AI in Firebase với bất kỳ mô hình nền tảng Gemini nào được liệt kê trong phần Tìm hiểu về các mô hình Gemini.

Bạn không thể sử dụng các mô hình Gemini không phải nền tảng như mô hình PaLM, mô hình được điều chỉnh hoặc mô hình dựa trên Gemma bằng SDK Vertex AI in Firebase.

Chúng tôi thường xuyên thêm các tính năng mới vào SDK. Vì vậy, hãy quay lại phần Câu hỏi thường gặp này để xem nội dung cập nhật (cũng như trong ghi chú phát hành, blog và bài đăng trên mạng xã hội).

Làm cách nào để khắc phục lỗi 400 này? `Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.`

Nếu đang cố gắng gửi một yêu cầu đa phương thức bằng URL Cloud Storage for Firebase, bạn có thể gặp lỗi 400 sau:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

Lỗi này xảy ra do dự án không có các tác nhân dịch vụ bắt buộc được tự động cấp phép đúng cách khi API Vertex AI được bật trong dự án. Đây là vấn đề đã biết với một số dự án và chúng tôi đang nỗ lực khắc phục trên toàn cầu.

Dưới đây là giải pháp khắc phục dự án và cấp phát chính xác các tác nhân dịch vụ này để bạn có thể bắt đầu đưa URL Cloud Storage for Firebase vào các yêu cầu đa phương thức. Bạn phải là Chủ sở hữu của dự án và chỉ cần hoàn thành một lần bộ nhiệm vụ này cho dự án của mình.

Truy cập và xác thực bằng gcloud CLI.
Cách dễ nhất để làm việc này là từ Cloud Shell. Tìm hiểu thêm trong tài liệu về Google Cloud.
Nếu được nhắc, hãy làm theo hướng dẫn xuất hiện trong dòng lệnh để chạy gcloud CLI trên dự án Firebase của bạn.

Bạn sẽ cần mã dự án Firebase. Bạn có thể tìm thấy mã này ở đầu phần Cài đặt dự án trong bảng điều khiển Firebase.

Cung cấp các tác nhân dịch vụ bắt buộc trong dự án của bạn bằng cách chạy lệnh sau:

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"  https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''

Chờ vài phút để đảm bảo rằng các tác nhân dịch vụ đã được cấp phép, sau đó thử gửi lại yêu cầu đa phương thức có chứa URL Cloud Storage for Firebase.

Nếu bạn vẫn gặp lỗi này sau khi đợi vài phút, hãy liên hệ với Nhóm hỗ trợ Firebase.

Làm cách nào để khắc phục lỗi 400 này? `API key not valid. Please pass a valid API key.`

Nếu bạn nhận được lỗi 400 có nội dung API key not valid. Please pass a valid API key., 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 tồn tại hoặc chưa được thiết lập để sử dụng với ứng dụng và/hoặc dự án Firebase.

Kiểm tra để đảm bảo khoá API được liệt kê trong tệp/đối tượng cấu hình Firebase khớp với khoá API cho ứng dụng của bạn. 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.

Nếu bạn phát hiện thấy các khoá không khớp, hãy tải một tệp/đối tượng cấu hình Firebase mới, sau đó thay thế tệp/đối tượng cấu hình hiện có trong ứng dụng. Tệp/đối tượng cấu hình mới phải chứa một khoá API hợp lệ cho ứng dụng và dự án Firebase của bạn.

Làm cách nào để khắc phục lỗi 403 này? `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.

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àm cách nào để khắc phục lỗi 403 này? `PERMISSION_DENIED: The caller does not have permission.`

Nếu bạn nhận được lỗi 403 có nội dung PERMISSION_DENIED: The caller does not have permission., thì điều này thường có nghĩa là khoá API trong tệp/đối tượng cấu hình Firebase thuộc về một dự án Firebase khác.