Các phương pháp hay nhất và điểm cần cân nhắc đối với mẫu


Trang này mô tả một số phương pháp hay nhất và những điều cần lưu ý đối với mẫu câu lệnh phía máy chủ, bao gồm cả 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 cung cấp khi các mẫu câu lệnh của máy chủ phát triển, vì vậy, hãy xem bản 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 phần Quản lý mẫu.

Lập phiên bản cho mẫu

Bảo vệ mẫu của bạn

  • Tránh chỉnh sửa các mẫu được dùng trong phiên bản chính thức, trừ phi bạn đã kiểm thử kỹ lưỡng thay đổi đó.

  • Khoá mẫu trước khi phát hành công khai.

    • Việc khoá mẫu giúp bảo vệ mẫu khỏi bị chỉnh sửa ngoài ý muốn, nhưng việc khoá không chặn hoàn toà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, đặ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 dữ liệu đầu vào hiệu quả cho các biến đầu vào, nhờ đó có thể giúp:

    • Có thể giúp bảo vệ trước các cuộc tấn công "tiêm câu lệnh" (prompt injection).
    • Có thể giúp đảm bảo các yêu cầu thành công và phản hồi đúng như mong đợi.

  • Thực thi chế độ chỉ dùng mẫu cho dự án Firebase của bạn để 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ủ.

Các tính năng chưa được mẫu câu lệnh phía máy chủ hỗ trợ

Nhiều tính năng trong số này sẽ được cung cấp khi các mẫu câu lệnh của 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!

Mẫu chưa hỗ trợ các chức năng của Firebase AI Logic

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 câu lệnh của 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 kết quả đầu ra trong một danh sách enum

Ngoài ra, 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 chưa được điền vào bất kỳ bản ghi nào.

Các phần tử phổ biến của Dotprompt chưa được mẫu hỗ trợ

Mẫu câu lệnh máy chủ có thể sẽ sớm hỗ trợ các phần tử phổ biến sau đây của Dotprompt:

  • Sử dụng quy cách giản đồ JSON cho giản đồ đầu vào và đầu ra trong phần đầu trang.

    • 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 của máy chủ. Chúng tôi hiện chỉ hỗ trợ quy cách giản đồ OpenAPI.

  • Khai báo định nghĩa trường ký tự đại diện bằng *.

  • Sử dụng @key hoặc lặp lại các trường của một dữ liệu đầu vào đối tượng (đây là trường hợp @key có 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ể this hiện tại.

Mẫu câu lệnh phía máy chủ có thể sẽ không hỗ trợ các phần tử phổ biến sau đây của Dotprompt:

  • Sử dụng các phần tử, là các đoạn mã mẫu có thể sử 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ả khu vực được hỗ trợ cho Firebase AI Logic. Nếu sử dụng Agent Platform Gemini API (formerly Vertex AI) và nếu trường hợp sử dụng của bạn yêu cầu các quy định 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 API REST.

  • Nếu muốn cung cấp mẫu câu lệnh 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), bạn có thể sử dụng API REST. Xin lưu ý rằng mẫu câu lệnh của 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 không thể trực tiếp tương tác với các tài nguyên phía máy chủ khác của dự án Firebase (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).