Trang này cung cấp câu trả lời cho các câu hỏi thường gặp (FAQ) và thông tin khắc phục sự cố về SDK Gemini API và Vertex AI in Firebase. Để biết thêm câu hỏi, hãy xem phần Câu hỏi thường gặp về Gemini API trong tài liệu về Google Cloud.
Câu hỏi thường gặp chung
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.updateresourcemanager.projects.createBillingAssignmentresourcemanager.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 bất kỳ mô hình nền tảng Gemini nào với SDK Vertex AI in Firebase, bao gồm cả các phiên bản xem trước và thử nghiệm. Xem danh sách các mô hình này trong bài viết 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) với 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).
Các tính năng này có dùng được khi sử dụng Vertex AI in Firebase không? Lưu vào bộ nhớ đệm ngữ cảnh, Tìm kiếm dưới dạng công cụ, liên kết với Google Tìm kiếm, thực thi mã, tinh chỉnh mô hình, tạo nội dung nhúng và truy xuất ngữ nghĩa?
Nhiều mô hình hoặc Vertex AI Gemini API hỗ trợ tính năng lưu ngữ cảnh vào bộ nhớ đệm, Tìm kiếm dưới dạng công cụ, liên kết với Google Tìm kiếm, thực thi mã, điều chỉnh mô hình, tạo nội dung nhúng và truy xuất ngữ nghĩa, nhưng các tính năng này sẽ không hoạt động khi bạn sử dụng Vertex AI in Firebase.
Nếu bạn muốn thêm các tính năng này dưới dạng yêu cầu tính năng hoặc bỏ phiếu cho một yêu cầu tính năng hiện có, hãy truy cập vào Firebase UserVoice.
Làm cách nào để đặt giới hạn tốc độ trên mỗi người dùng?
Theo mặc định, Vertex AI in Firebase đặt hạn mức yêu cầu cho mỗi người dùng là 100 yêu cầu mỗi phút (RPM).
Nếu muốn điều chỉnh hạn mức tốc độ trên mỗi người dùng, bạn cần điều chỉnh chế độ cài đặt hạn mức cho API Vertex AI in Firebase.
Tìm hiểu thêm về hạn mức API Vertex AI in Firebase. Trên trang đó, bạn cũng có thể tìm hiểu cách xem và chỉnh sửa hạn mức.
Khắc phục lỗ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à phân bổ 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 settings 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 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.
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.
Gửi ý kiến phản hồi về trải nghiệm của bạn với Vertex AI in Firebase