Các thông số và điều kiện của Cấu hình từ xa

Bạn có thể định cấu hình mẫu cho cả trường hợp sử dụng máy khách và máy chủ. Các mẫu ứng dụng được phân phát cho mọi phiên bản ứng dụng triển khai SDK Firebase cho Remote Config, bao gồm cả ứng dụng Android, Apple, Web, Unity, Flutter và C++. Các tham số và giá trị Remote Config từ các mẫu dành riêng cho máy chủ được phân phát cho các triển khai Remote Config (bao gồm cả Cloud Run và Cloud Functions) sử dụng các môi trường máy chủ sau:

• Firebase Admin Node.js SDK phiên bản 12.1.0 trở lên
• Firebase Admin Python SDK phiên bản 6.7.0 trở lên

Khi sử dụng bảng điều khiển Firebase hoặc Remote Config API phần phụ trợ, bạn sẽ xác định một hoặc nhiều thông số (cặp khoá-giá trị) và cung cấp các giá trị mặc định trong ứng dụng cho những thông số đó. Bạn có thể ghi đè các giá trị mặc định trong ứng dụng bằng cách xác định các giá trị tham số. Khoá tham số và giá trị tham số là các chuỗi, nhưng giá trị tham số có thể được truyền dưới dạng các kiểu dữ liệu khác khi bạn sử dụng các giá trị này trong ứng dụng của mình.

Khi sử dụng bảng điều khiển Firebase, Admin SDK hoặc Remote Config REST API, bạn có thể tạo các giá trị mặc định mới cho các thông số, cũng như các giá trị có điều kiện được dùng để nhắm đến các nhóm phiên bản ứng dụng. Mỗi lần bạn cập nhật cấu hình trong bảng điều khiển Firebase, Firebase sẽ tạo và xuất bản một phiên bản mới của mẫu Remote Config. Phiên bản trước đó sẽ được lưu trữ, cho phép bạn truy xuất hoặc khôi phục khi cần. Bạn có thể sử dụng các thao tác này trong bảng điều khiển Firebase, Firebase Admin SDK và REST API, đồng thời các thao tác này được mô tả chi tiết hơn trong phần Quản lý các phiên bản mẫu Remote Config.

Hướng dẫn này giải thích các tham số, điều kiện, quy tắc, giá trị có điều kiện và cách các giá trị tham số khác nhau được ưu tiên trên phần phụ trợ Remote Config và trong ứng dụng của bạn. Hướng dẫn này cũng cung cấp thông tin chi tiết về các loại quy tắc được dùng để tạo điều kiện.

Điều kiện, quy tắc và giá trị có điều kiện

Một điều kiện được dùng để nhắm đến một nhóm các phiên bản ứng dụng. Điều kiện bao gồm một hoặc nhiều quy tắc mà tất cả đều phải đánh giá thành true để điều kiện đánh giá thành true cho một phiên bản ứng dụng nhất định. Nếu giá trị của một quy tắc là không xác định (ví dụ: khi không có giá trị nào), thì quy tắc đó sẽ đánh giá thành false.

Ví dụ: bạn có thể tạo một tham số xác định tên mô hình và chuỗi phiên bản của mô hình ngôn ngữ lớn (LLM), đồng thời phân phát các phản hồi từ nhiều mô hình dựa trên các quy tắc tín hiệu tuỳ chỉnh. Trong trường hợp này, bạn có thể sử dụng phiên bản mô hình ổn định làm giá trị mặc định để phân phát hầu hết các yêu cầu và sử dụng tín hiệu tuỳ chỉnh để sử dụng mô hình thử nghiệm nhằm phản hồi các yêu cầu của ứng dụng thử nghiệm.

Một tham số có thể có nhiều giá trị có điều kiện sử dụng các điều kiện khác nhau và các tham số có thể dùng chung điều kiện trong một dự án. Trong thẻ Thông số của bảng điều khiển Firebase, bạn có thể xem tỷ lệ tìm nạp cho các giá trị có điều kiện của từng thông số. Chỉ số này cho biết tỷ lệ phần trăm yêu cầu nhận được từng giá trị trong 24 giờ qua.

Mức độ ưu tiên giá trị tham số

Khi sử dụng Remote Config trong các ứng dụng máy chủ bằng Firebase Admin SDK, bạn sẽ tìm nạp và tải toàn bộ mẫu để trích xuất các giá trị tham số thích hợp theo yêu cầu cho từng yêu cầu của ứng dụng khách. Một thông số có thể có một số giá trị có điều kiện được liên kết với thông số đó.

Các quy tắc sau đây xác định giá trị nào được chỉ định trong quá trình đánh giá mẫu tại một thời điểm cụ thể:

1. Trước tiên, các giá trị có điều kiện sẽ được áp dụng cho mọi điều kiện đánh giá thành true đối với một yêu cầu nhất định của máy khách. Nếu nhiều điều kiện được đánh giá là true, thì điều kiện đầu tiên (trên cùng) xuất hiện trong giao diện người dùng bảng điều khiển Firebase sẽ được ưu tiên và các giá trị có điều kiện liên kết với điều kiện đó sẽ được cung cấp khi mẫu được đánh giá. Bạn có thể thay đổi mức độ ưu tiên của các điều kiện bằng cách kéo và thả các điều kiện trong thẻ Điều kiện.

2. Nếu không có giá trị có điều kiện nào có điều kiện đánh giá thành true, giá trị mặc định của Remote Config sẽ được cung cấp trong quá trình đánh giá mẫu. Nếu một thông số không có trong mẫu hoặc nếu giá trị mặc định được đặt thành Sử dụng giá trị mặc định trong ứng dụng, thì sẽ không có giá trị nào được cung cấp cho thông số đó khi mẫu được đánh giá.

Để biết thêm thông tin về cách tải và đánh giá các mẫu Remote Config trong ứng dụng máy chủ, hãy xem bài viết Sử dụng Remote Config trong môi trường máy chủ.

Kiểu dữ liệu giá trị thông số

Remote Config cho phép bạn chọn một kiểu dữ liệu cho từng tham số và xác thực tất cả các giá trị Remote Config theo kiểu đó trước khi cập nhật mẫu. Loại dữ liệu được lưu trữ và trả về theo yêu cầu getRemoteConfig.

Các loại dữ liệu được hỗ trợ là:

• String
• Boolean
• Number
• JSON

Trong giao diện người dùng bảng điều khiển Firebase, bạn có thể chọn loại dữ liệu trong trình đơn thả xuống bên cạnh khoá tham số. Trong REST API, bạn có thể đặt các loại bằng cách sử dụng trường value_type trong đối tượng tham số.

Nhóm tham số

Remote Config cho phép bạn nhóm các tham số lại với nhau để có giao diện người dùng ngăn nắp hơn và nâng cao khả năng sử dụng.

Ví dụ: giả sử bạn cần bật hoặc tắt 3 loại uỷ quyền khác nhau trong khi triển khai một tính năng đăng nhập mới. Với Remote Config, bạn có thể tạo 3 tham số để bật các loại bạn muốn, rồi sắp xếp chúng trong một nhóm có tên là "Đăng nhập mới" mà không cần thêm tiền tố hoặc sắp xếp đặc biệt.

Bạn có thể tạo các nhóm tham số bằng bảng điều khiển Firebase hoặc REST API Remote Config. Mỗi nhóm tham số bạn tạo đều có một tên riêng biệt trong mẫu Remote Config. Khi tạo nhóm tham số, hãy lưu ý:

• Bạn chỉ có thể thêm các thông số vào một nhóm tại một thời điểm và khoá thông số vẫn phải là duy nhất trên tất cả các thông số.
• Tên nhóm tham số chỉ được có tối đa 256 ký tự.
• Nếu bạn sử dụng cả REST API và bảng điều khiển Firebase, hãy đảm bảo rằng mọi logic REST API đều được cập nhật để xử lý các nhóm tham số khi phát hành.

Tạo hoặc sửa đổi nhóm tham số bằng bảng điều khiển Firebase

Bạn có thể nhóm các tham số trong thẻ Parameters (Tham số) của bảng điều khiển Firebase. Cách tạo hoặc sửa đổi một nhóm:

1. Chọn Quản lý nhóm.
2. Chọn hộp đánh dấu cho các tham số bạn muốn thêm rồi chọn Di chuyển đến nhóm.
3. Chọn một nhóm hiện có hoặc tạo một nhóm mới bằng cách nhập tên và nội dung mô tả, rồi chọn Tạo nhóm mới. Sau khi bạn lưu một nhóm, bạn có thể xuất bản nhóm đó bằng nút Xuất bản thay đổi.

Các loại quy tắc điều kiện

Mẫu Remote Config cho các ứng dụng máy chủ hỗ trợ các loại điều kiện sau:

• Người dùng trong tỷ lệ phần trăm ngẫu nhiên
• Điều kiện tín hiệu tuỳ chỉnh

Người dùng theo tỷ lệ phần trăm ngẫu nhiên

Sử dụng trường này để áp dụng thay đổi cho một mẫu ngẫu nhiên của các phiên bản ứng dụng (với kích thước mẫu nhỏ đến mức 0,0001%), bằng cách sử dụng tiện ích thanh trượt để phân đoạn người dùng (các phiên bản ứng dụng) được xáo trộn ngẫu nhiên thành các nhóm.

Mỗi phiên bản ứng dụng được liên kết liên tục với một số nguyên hoặc số thập phân ngẫu nhiên, theo một giá trị ban đầu được xác định trong dự án đó.

Một quy tắc sẽ sử dụng khoá mặc định (hiển thị là Chỉnh sửa giá trị ban đầu trong bảng điều khiển Firebase) trừ phi bạn sửa đổi giá trị ban đầu. Bạn có thể trả một quy tắc về trạng thái sử dụng khoá mặc định bằng cách xoá trường Seed.

Để giải quyết nhất quán các phiên bản ứng dụng giống nhau trong phạm vi phần trăm nhất định, hãy sử dụng cùng một giá trị ban đầu trên các điều kiện. Hoặc chọn một nhóm phiên bản ứng dụng mới được chỉ định ngẫu nhiên cho một phạm vi tỷ lệ phần trăm nhất định bằng cách chỉ định một giá trị ban đầu mới.

Ví dụ: để tạo 2 điều kiện có liên quan, mỗi điều kiện áp dụng cho 5% người dùng không trùng lặp của một ứng dụng, bạn có thể định cấu hình một điều kiện để so khớp tỷ lệ phần trăm từ 0% đến 5% và định cấu hình một điều kiện khác để so khớp phạm vi từ 5% đến 10%. Để cho phép một số người dùng xuất hiện ngẫu nhiên trong cả hai nhóm, hãy sử dụng các giá trị ban đầu khác nhau cho các quy tắc trong mỗi điều kiện.

Để tìm hiểu cách thêm các điều kiện về tỷ lệ phần trăm ngẫu nhiên vào ứng dụng của bạn, hãy xem phần Định cấu hình ứng dụng máy chủ.

Điều kiện tín hiệu tuỳ chỉnh

Với Firebase Admin Node.js SDK 12.5.0 trở lên, bạn có thể sử dụng các giá trị có điều kiện Tín hiệu tuỳ chỉnh để so khớp các điều kiện tuỳ ý mà bạn xác định trong ứng dụng của mình. Nhờ đó, bạn có thể điều chỉnh phản hồi của máy chủ cho từng yêu cầu của ứng dụng khách.

Ví dụ: nếu đang làm việc trên một ứng dụng máy chủ sử dụng AI tạo sinh để giúp tạo ra các phản hồi bằng nhiều mô hình được điều chỉnh cho các nền tảng cụ thể, bạn có thể làm như sau:

1. Thêm các tham số prompt và model_name vào mẫu máy chủ Remote Config.
2. Thêm các điều kiện tín hiệu tuỳ chỉnh có giá trị platform cho từng nền tảng mà bạn muốn nhắm đến.
3. Thêm giá trị mặc định vào mẫu Remote Config dành riêng cho máy chủ và giá trị có điều kiện cho từng điều kiện nền tảng mà bạn đã xác định.
4. Cập nhật mã ứng dụng để đặt và sử dụng tín hiệu tuỳ chỉnh platform.

Giờ đây, ứng dụng của bạn có thể trích xuất câu lệnh và mô hình phù hợp trong quá trình đánh giá mẫu và sử dụng chúng để trả về các câu trả lời tuỳ chỉnh cho từng khách hàng.

Bạn có thể sử dụng các loại quy tắc sau đây để tạo điều kiện tín hiệu tuỳ chỉnh trong bảng điều khiển Firebase.

Danh mục nhà điều hành	(Các) toán tử	Giá trị	Lưu ý
Văn bản	khớp chính xác, chứa, không chứa, chứa biểu thức chính quy	Các chuỗi so sánh cho quy tắc này có phân biệt chữ hoa chữ thường. Khi sử dụng toán tử khớp chính xác, chứa, không chứa hoặc chứa biểu thức chính quy, bạn có thể chọn nhiều giá trị. Khi sử dụng toán tử chứa biểu thức chính quy, bạn có thể tạo biểu thức chính quy ở định dạng RE2. Biểu thức chính quy của bạn có thể khớp với toàn bộ hoặc một phần của chuỗi phiên bản mục tiêu. Bạn cũng có thể sử dụng các neo ^ và $ để khớp với phần đầu, phần cuối hoặc toàn bộ chuỗi mục tiêu.
Số	<, <=, =, !=, >, >=	Chữ số có không quá 10 chữ số ở mỗi bên của dấu thập phân.
Phiên bản	<, <=, =, !=, >, >=	Chữ số đại diện cho(các) số phiên bản cần khớp (ví dụ: 2.1.0).

Để tìm hiểu cách thêm tín hiệu tuỳ chỉnh vào ứng dụng, hãy xem phần Định cấu hình ứng dụng máy chủ.

Tham số và điều kiện tìm kiếm

Bạn có thể tìm kiếm khoá tham số, giá trị tham số và điều kiện của dự án trong bảng điều khiển Firebase bằng cách sử dụng hộp tìm kiếm ở đầu thẻ Remote Config Tham số.

Giới hạn về thông số và điều kiện

Trong một dự án Firebase, bạn có thể có tối đa 3.000 thông số và tối đa 2.000 điều kiện. Khoá tham số có thể dài tối đa 256 ký tự, phải bắt đầu bằng dấu gạch dưới hoặc ký tự chữ cái tiếng Anh (A-Z, a-z) và cũng có thể chứa các chữ số. Tổng độ dài của chuỗi giá trị tham số trong một dự án không được vượt quá 1.000.000 ký tự.

Xem các thay đổi đối với thông số và điều kiện

Bạn có thể xem các thay đổi mới nhất đối với mẫu Remote Config của mình trên bảng điều khiển Firebase. Đối với từng thông số và điều kiện riêng lẻ, bạn có thể:

• Xem tên của người dùng đã sửa đổi thông số hoặc điều kiện gần đây nhất.

• Nếu thay đổi xảy ra trong cùng một ngày, hãy xem số phút hoặc số giờ đã trôi qua kể từ khi thay đổi được xuất bản cho mẫu Remote Config đang hoạt động.

• Nếu thay đổi xảy ra từ một ngày trở lên trước đó, hãy xem ngày thay đổi được xuất bản cho mẫu Remote Config đang hoạt động.

Nhật ký thay đổi đối với các tham số

Trên trang Remote Config Tham số, cột Đã xuất bản lần gần đây nhất cho biết người dùng gần đây nhất đã sửa đổi từng tham số và ngày xuất bản gần đây nhất cho thay đổi đó:

• Để xem siêu dữ liệu thay đổi cho các thông số được nhóm, hãy mở rộng nhóm thông số.

• Để sắp xếp theo thứ tự tăng dần hoặc giảm dần theo ngày xuất bản, hãy nhấp vào nhãn cột Ngày xuất bản gần nhất.

Nhật ký thay đổi cho các điều kiện

Trên trang Remote Config Điều kiện, bạn có thể xem người dùng gần đây nhất đã sửa đổi điều kiện và ngày họ sửa đổi điều kiện đó bên cạnh mục Ngày sửa đổi gần nhất trong mỗi điều kiện.

Các bước tiếp theo

Để định cấu hình dự án Firebase và ứng dụng máy chủ để sử dụng Remote Config, hãy xem phần Sử dụng Remote Config trong môi trường máy chủ.