Thực thi chế độ chỉ mẫu


Bạn có thể thực thi chế độ chỉ dùng mẫu cho dự án Firebase của mình để tất cả yêu cầu Gemini API thông qua Firebase AI Logic đều phải sử dụng mẫu câu lệnh của máy chủ.

Khi một yêu cầu bị chặn, phản hồi sẽ là lỗi 403: unauthorized.

Những điểm quan trọng cần lưu ý

Hãy lưu ý những điểm quan trọng sau đây đối với chế độ chỉ mẫu.

Khi chế độ chỉ mẫu được thực thi

Khi chế độ chỉ dùng mẫu được thực thi, hãy lưu ý những điều sau:

  • Đây là chế độ cài đặt trên toàn dự án cho Firebase AI Logic.

    • Chế độ này áp dụng cho tất cả ứng dụng đã đăng ký trong dự án.
    • Chính sách này chỉ áp dụng cho dự án mà chính sách được thực thi.

  • Chế độ cài đặt này áp dụng cho tất cả yêu cầu thông qua Firebase AI Logic cho cả Gemini Developer API và Agent Platform Gemini API (formerly Vertex AI).

  • Chế độ cài đặt này chặn mọi yêu cầu qua Firebase AI Logic không sử dụng mẫu câu lệnh phía máy chủ. Điều này bao gồm cả việc chặn các yêu cầu từ ứng dụng của bạn sử dụng các chức năng chưa được hỗ trợ cho mẫu câu lệnh của máy chủ.

  • Chế độ cài đặt này không chặn các yêu cầu Gemini API trong dự án của bạn không thông qua Firebase AI Logic.

  • Nếu bạn đang sử dụng API REST Firebase AI Logic:

    • Chế độ cài đặt này không chặn các yêu cầu suy luận sử dụng mẫu câu lệnh của máy chủ (chẳng hạn như sử dụng templateGenerateContent hoặc templateStreamGenerateContent).
    • Chế độ cài đặt này không chặn các yêu cầu mặt phẳng điều khiển (chẳng hạn như các yêu cầu quản lý mẫu và cấu hình).

  • Chế độ cài đặt này không chặn các yêu cầu đến countTokens (API Count Tokens).

Trước khi thực thi chế độ chỉ dùng mẫu

Hãy lưu ý những điều sau trước khi bạn thực thi chế độ chỉ dùng mẫu:

  • Nếu bạn có các phiên bản hiện tại của ứng dụng không sử dụng mẫu câu lệnh của máy chủ:

    • Chế độ cài đặt này sẽ chặn các yêu cầu qua Firebase AI Logic từ các phiên bản ứng dụng hiện có đó.
    • Đảm bảo rằng tất cả ứng dụng đang hoạt động đều được cập nhật để sử dụng mẫu câu lệnh của máy chủ trước khi thực thi chế độ chỉ dùng mẫu.

  • Nếu ứng dụng của bạn sử dụng các tính năng chưa được hỗ trợ cho mẫu câu lệnh của máy chủ:

    • Chế độ cài đặt này sẽ chặn các yêu cầu thông qua Firebase AI Logic đối với những chức năng chưa được hỗ trợ này vì chúng không (và không thể) sử dụng mẫu câu lệnh của máy chủ.
    • Đảm bảo rằng ứng dụng của bạn (bao gồm cả phiên bản trước đây) không chủ động sử dụng bất kỳ chức năng nào chưa được hỗ trợ trước khi thực thi chế độ chỉ dùng mẫu.

Quản lý chế độ cài đặt chỉ dùng mẫu

Bạn quản lý chế độ cài đặt cho chế độ chỉ mẫu trong bảng điều khiển Firebase.

Các quyền và vai trò bắt buộc trong IAM

Để quản lý chế độ cài đặt chỉ dùng mẫu, bạn cần có quyền firebasevertexai.configs.update. Quyền này được cấp theo mặc định cho các vai trò IAM sau: Chủ sở hữu, Người chỉnh sửa, Quản trị viên Firebase và Quản trị viên Firebase AI Logic.

Thực thi chế độ chỉ dùng mẫu

Sau đây là cách thực thi chế độ chỉ dùng mẫu cho dự án Firebase của bạn:

  1. Nếu bạn chưa xem, hãy xem lại các điểm quan trọng cần lưu ý đối với chế độ chỉ dùng mẫu ở phần trước của hướng dẫn này.

  2. Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Dịch vụ AI > Logic AI > Cài đặt.

  3. Trong phần Chế độ mẫu, hãy trượt nút bật/tắt cho Thực thi chế độ chỉ mẫu sang Đã thực thi.

  4. Xem lại hộp thoại xác nhận, sau đó nhấp vào Xác nhận.

Ngừng thực thi chế độ chỉ mẫu

Nếu bạn ngừng thực thi chế độ chỉ dùng mẫu, hãy lưu ý những điều sau:

  • Các yêu cầu thông qua Firebase AI Logic không sử dụng mẫu câu lệnh của máy chủ sẽ được cho phép.
  • Đây là chế độ cài đặt trên toàn dự án cho Firebase AI Logic.

Sau đây là cách ngừng thực thi chế độ chỉ dùng mẫu cho dự án Firebase của bạn:

  1. Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Dịch vụ AI > Logic AI > Cài đặt.

  2. Trong phần Chế độ mẫu, hãy tắt chế độ Chỉ thực thi chế độ mẫu.

  3. Xem lại hộp thoại xác nhận, sau đó nhấp vào Xác nhận.