Trang này mô tả một số phương pháp hay nhất và lưu ý về mẫu lời nhắc trên máy chủ, bao gồm các tính năng chưa được hỗ trợ. Xin lưu ý rằng nhiều tính năng trong số này sẽ có khi mẫu lời nhắc trên máy chủ phát triển, vì vậy, hãy xem ghi chú phát hành để biết thông tin cập nhật!
Các phương pháp hay nhất
Nhiều phương pháp hay nhất trong số này cũng được trình bày chi tiết trong bài viết Quản lý mẫu.
Lập phiên bản cho mẫu
Tạo mã mẫu được thêm phiên bản sử dụng quy trình lập phiên bản ngữ nghĩa (semver).
Sử dụng Firebase Remote Config để bạn có thể dễ dàng thay đổi mẫu và các giá trị khác trong yêu cầu của mình.
Bảo vệ mẫu
Tránh chỉnh sửa các mẫu được sử dụng trong phiên bản phát hành công khai, trừ phi bạn đã kiểm thử kỹ lưỡng thay đổi đó.
Khoá mẫu trước khi chuyển sang phiên bản phát hành công khai.
Việc khoá mẫu sẽ giúp bảo vệ mẫu khỏi việc chỉnh sửa ngoài ý muốn, nhưng việc khoá không hoàn toàn ngăn chặn việc chỉnh sửa. Thành viên dự án có quyền thích hợp luôn có thể mở khoá mẫu để chỉnh sửa.
Bạn nên khoá các mẫu đang được mã sử dụng tích cực – đặc biệt là mã phát hành công khai.
Bảo vệ việc sử dụng Gemini API
Viết quy trình xác thực đầu vào mạnh mẽ cho các biến đầu vào, có thể giúp bạn thực hiện những việc sau:
- Có thể giúp bảo vệ khỏi việc tiêm câu lệnh (prompt injection).
- Có thể giúp đảm bảo yêu cầu thành công và phản hồi như mong đợi.
Buộc chế độ chỉ dùng mẫu cho dự án Firebase để tất cả Gemini API yêu cầu thông qua Firebase AI Logic phải sử dụng mẫu lời nhắc trên máy chủ.
Các tính năng mà mẫu lời nhắc trên máy chủ chưa hỗ trợ
Nhiều tính năng trong số này sẽ có khi mẫu lời nhắc trên máy chủ phát triển, vì vậy, hãy xem ghi chú phát hành để biết thông tin cập nhật!
Các chức năng của Firebase AI Logic mà mẫu chưa hỗ trợ
Các chức năng tiêu chuẩn sau đây của Firebase AI Logic chưa được hỗ trợ thông qua mẫu lời nhắc trên máy chủ:
- Truyền trực tuyến hai chiều (Gemini Live API)
- Suy luận kết hợp hoặc trên thiết bị
- Giới hạn đầu ra thành danh sách enum
Xin lưu ý rằng nếu bạn sử dụng tính năng giám sát bằng AI trong bảng điều khiển Firebase, thì mã mẫu vẫn chưa được điền sẵn trong bất kỳ bản ghi nào.
Các phần tử chung của Dotprompt mà mẫu chưa hỗ trợ
Mẫu lời nhắc trên máy chủ sẽ sớm hỗ trợ các phần tử chung sau đây của Dotprompt:
Sử dụng thông số kỹ thuật giản đồ JSON cho giản đồ đầu vào và đầu ra trong phần đầu của tệp.
- Xin lưu ý rằng thông số kỹ thuật này cũng không được hỗ trợ trong các yêu cầu mẫu không phải trên máy chủ. Chúng tôi hiện chỉ hỗ trợ thông số kỹ thuật giản đồ OpenAPI.
Khai báo định nghĩa trường ký tự đại diện bằng cách sử dụng
*.Sử dụng
@keyhoặc thường lặp lại các trường của một đối tượng đầu vào (trường hợp@keycó liên quan).Sử dụng
@root, cho phép bạn tham chiếu ngữ cảnh biến gốc bất kểthishiện tại.
Mẫu lời nhắc trên máy chủ sẽ không hỗ trợ các phần tử chung sau đây của Dotprompt:
- Sử dụng các phần, là đoạn mã mẫu có thể dùng lại và có thể được đưa vào các mẫu khác.
Các lưu ý khác
Theo mặc định, khi bạn sử dụng giao diện người dùng có hướng dẫn trong bảng điều khiển Firebase, chúng tôi sẽ cung cấp mẫu ở tất cả các khu vực hiện có cho Firebase AI Logic. Nếu bạn sử dụng Vertex AI Gemini API và trường hợp sử dụng của bạn yêu cầu các hạn chế dựa trên vị trí, thì bạn có thể chỉ định vị trí cho mẫu của mình bằng cách sử dụng API REST.
Nếu bạn muốn cung cấp mẫu lời nhắc trên máy chủ dưới dạng tệp (thay vì sử dụng giao diện người dùng có hướng dẫn của bảng điều khiển Firebase), thì bạn có thể sử dụng API REST. Xin lưu ý rằng mẫu lời nhắc trên máy chủ không hỗ trợ giản đồ được xác định trong mã ứng dụng và được truyền vào mẫu.
Mặc dù mẫu nằm trên máy chủ, nhưng mẫu này không thể tương tác trực tiếp với các tài nguyên phía máy chủ khác của dự án Firebase (chẳng hạn như cơ sở dữ liệu) ngoại trừ URL Cloud Storage for Firebase (có thể được cung cấp dưới dạng biến đầu vào ).