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à các đ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ẽ không có trong bản phát hành ban đầu của mẫu câu lệnh trên máy chủ. 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

  • Khoá mẫu trước khi chuyển sang bản phát hành công khai. Đồng thời, tránh chỉnh sửa các mẫu được dùng trong quá trình sản xuất.

    • 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.

  • 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 ngăn chặn các cuộc tấn công chèn 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.

Các tính năng chưa được hỗ trợ

Nhiều tính năng chưa được hỗ trợ trong số này chỉ không có trong bản phát hành ban đầu, 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 chưa được hỗ trợ của Firebase AI Logic

Mẫu câu lệnh phía máy chủ hiện chưa hỗ trợ các chức năng sau của Firebase AI Logic. Một số tính năng trong số này sắp ra mắt!

  • Chat
  • Sử dụng các công cụ (bao gồm cả tính năng gọi hàm và tính năng căn cứ vào thông tin trên Google Tìm kiếm)
  • Chỉnh sửa hình ảnh lặp đi lặp lại (trò chuyện) bằng các mô hình Gemini (yêu cầu trò chuyện)
  • Chỉnh sửa hình ảnh bằng các mô hình Imagen
  • Truyền trực tuyến hai chiều (Gemini Live API)
  • Kết hợp trên thiết bị
  • Hạn chế đầu ra thành một danh sách các enum
  • Định cấu hình các chế độ cài đặt liên quan đến suy nghĩ
  • Định cấu hình chế độ cài đặt an toàn

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ử chung chưa được hỗ trợ của Dotprompt

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 dùng *.

  • Sử dụng @key hoặc thường 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í, bạn có thể chỉ định vị trí cho mẫu bằng cách sử dụng REST API.

  • 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 REST API. 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ừ URL Cloud Storage for Firebase (có thể được cung cấp dưới dạng các biến đầu vào).