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à điểm cần cân nhắc đố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ó sẵn khi các mẫu câu lệnh 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 phần Quản lý mẫu.

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

Bảo vệ mẫu

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

  • Khoá mẫu trước khi chuyển sang bản phát hành công khai.

    • Việc khoá mẫu có tác dụng bảo vệ chống lại hành vi chỉnh sửa ngoài ý muốn, nhưng việc khoá không ngăn hoàn toàn hành vi chỉnh sửa. Thành viên dự án có quyền thích hợp luôn có thể mở khoá một mẫu để chỉnh sửa.

    • Bạn nên khoá những mẫu đang được mã sử dụng – đặc biệt là mã sản xuất.

Bảo vệ việc sử dụng Gemini API

  • Viết xác thực đầu vào mạnh mẽ cho các biến đầu vào của bạn. Điều này có thể giúp bạn:

    • Có thể giúp bảo vệ người dùng phòng tránh hành vi tấn công "tiêm câu lệnh".
    • 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ỉ mẫu cho dự án Firebase của bạn để tất cả cá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 mà mẫu câu lệnh phía máy chủ chưa hỗ trợ

Nhiều tính năng trong số này sẽ có sẵn khi các mẫu câu lệnh 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!

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 hiện 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ị
  • Hạn chế đầu ra thành một danh sách các 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ã nhận dạng mẫu chưa được điền sẵn trong bất kỳ bản ghi nào.

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

Mẫu câu lệnh trên máy chủ 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 của tài liệu.

    • Xin lưu ý rằng quy cách này cũng không được hỗ trợ trong các yêu cầu không phải là mẫu 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 cách sử dụng *.

  • Sử dụng @key hoặc lặp lại các trường của một đầu vào đối tượng (đây là trường hợp mà @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 trên 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 thành phần, là những đoạn 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 có sẵn cho Firebase AI Logic. Nếu 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 bằng cách sử dụng API REST.

  • Nếu muốn cung cấp một mẫu câu lệnh 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), bạn có thể sử dụng API REST. Xin lưu ý rằng các 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 này không thể tương tác trực tiếp với các tài nguyên khác phía máy chủ của dự án Firebase (chẳng hạn như cơ sở dữ liệu) ngoại trừ các URL Cloud Storage for Firebase (có thể được cung cấp dưới dạng các biến đầu vào).