Làm quen với QLGX › mở lại các bước làm quen trên trang Tổng quan
Trợ lý hỏi đáp (quản trị)#
Trong trang nàyMàn hình này dùng để làm gìAi được mởVào màn hình này bằng cách nàoCác phần trên màn hìnhBảng trường và nútCác việc thường làmQuy tắc ẩn và giới hạnHỏi đáp và xử lý sự cốMàn hình liên quan
Màn hình này dùng để làm gì#
Theo dõi và điều chỉnh nút Hỏi trợ lý (xem Hỏi trợ lý) cho cả hệ thống:
- Dán khoá API của Anthropic để bật trợ lý AI (không cần sửa gì trên máy chủ).
- Hôm nay và 30 ngày qua đã có bao nhiêu câu hỏi, tốn bao nhiêu tiền, bao nhiêu câu được 👍 hay bị 👎, bao nhiêu lượt lỗi.
- Đặt hạn mức mặc định (số câu mỗi tài khoản, mỗi giáo xứ, cả hệ thống mỗi ngày) và trần chi phí mỗi ngày.
- Tắt trợ lý hoặc đặt hạn mức riêng cho từng giáo xứ.
- Đọc các câu bị 👎, bị lỗi để viết thêm hướng dẫn cho đúng chỗ người dùng còn vướng.
Câu hỏi hiện trên màn hình đã được che tên người, số điện thoại, email, số giấy tờ trước khi lưu. Màn hình không hiện câu trả lời và không hiện tài khoản nào đã hỏi.
Ai được mở#
Chỉ tài khoản Quản trị hệ thống. Người khác không thấy mục này trên menu và máy chủ từ chối nếu họ mở bằng cách khác. Quản trị giáo xứ chỉ bật, tắt trợ lý cho giáo xứ mình ở hộp Tùy chọn.
Vào màn hình này bằng cách nào#
- Menu Hệ thống trên thanh trên cùng › Trợ lý hỏi đáp.
- Đường dẫn:
/tro-ly-hoi-dap.
Các phần trên màn hình#
- Tiêu đề, dòng "Số liệu lúc …" (ngày tính theo giờ Việt Nam) và nút Tải lại.
- Thanh báo đỏ (chỉ khi có vấn đề): trợ lý AI đang tắt vì chưa có khoá API, hoặc chi phí hôm nay đã chạm trần.
- Thẻ Khoá API: khoá đang dùng (chỉ hiện 4 ký tự cuối), ô Dán khoá, ô Mô hình, nút Lưu (ghi Kiểm tra khoá và lưu khi có dán khoá mới), nút Xoá khoá.
- Bốn ô số: Hôm nay, 30 ngày, Đánh giá 30 ngày, Lỗi 30 ngày.
- Thẻ Hạn mức mặc định: bốn ô số và nút Lưu hạn mức.
- Thẻ Các giáo xứ: bảng mọi giáo xứ, dùng nhiều nhất trong 30 ngày lên đầu, mỗi dòng có nút Sửa.
- Thẻ Câu hỏi hay gặp 30 ngày: các câu được hỏi từ hai lần trở lên, nhiều nhất lên đầu (tối đa 30 câu).
- Thẻ Chủ đề hay hỏi 30 ngày: các trang hướng dẫn mà câu hỏi rơi vào nhiều nhất (tối đa 15 trang).
- Thẻ Câu cần xem để viết thêm hướng dẫn: tối đa 100 câu gần nhất trong 30 ngày.
- Thẻ Gợi ý tự động 30 ngày: số lần mỗi gợi ý tự động đã hiện, được bấm, bị từ chối, gộp mọi giáo xứ.
Trên điện thoại, nút Sửa nằm ngay dưới tên giáo xứ, và mỗi câu cần xem, mỗi gợi ý tự động hiện thành một khối thay vì một hàng bảng.
Bảng trường và nút#
Khoá API#
| Trường | Dùng để làm gì | Giá trị & ràng buộc | Ghi chú & tình huống dùng |
|---|---|---|---|
| Dòng trạng thái | Khoá đang dùng lấy từ đâu | "Đang dùng khoá …AbCd (lưu lúc …)": khoá dán ở đây. "Đang dùng khoá cài trên máy chủ (biến môi trường)": khoá do người kỹ thuật cài. "Chưa có khoá: trợ lý AI đang tắt." | Khoá dán ở đây được dùng thay khoá cài trên máy chủ |
| Dán khoá (Khoá mới khi đã có khoá) | Dán khoá API của Anthropic | Bắt đầu bằng sk-ant-, không có khoảng trắng. Ô che chữ như ô mật khẩu, bấm hình con mắt để xem lại | Lấy khoá ở console.anthropic.com › API Keys › Create Key, chép cả khoá |
| Lưu (Kiểm tra khoá và lưu khi ô khoá có chữ) | Lưu khoá mới và / hoặc mô hình | Ô khoá để trống thì giữ khoá đang dùng, chỉ lưu mô hình (không đòi dán lại khoá); chưa đổi gì thì nút mờ. Có dán khoá mới thì máy chủ thử khoá trước (không tốn tiền). Khoá sai thì báo "Khoá không đúng hoặc đã bị thu hồi…" và không lưu | Lưu xong trợ lý bật ngay, không cần khởi động lại máy chủ. Người dùng đang mở phần mềm tải lại trang (F5) là thấy |
| Mô hình | Chọn mô hình AI trả lời | Theo cấu hình máy chủ (mặc định Claude Haiku 5.5), Claude Haiku 5.5 (nhanh, rẻ nhất, khoảng 0,0014 USD một câu), Claude Sonnet 5.5 (cân bằng, khoảng 0,03 USD), Claude Opus 5.5 (giỏi nhất, chậm hơn, khoảng 0,05 USD). Dòng dưới ô ghi mô hình đang dùng và chi phí ước tính | Đổi xong bấm Lưu (để trống ô khoá); có hiệu lực từ câu hỏi kế tiếp, không cần phát hành bản mới. Haiku đủ tốt cho phần lớn câu hỏi; thỉnh thoảng còn xưng hô "bạn" |
| Xoá khoá | Bỏ khoá đã dán | Hỏi lại một lần trước khi xoá | Xoá xong trợ lý dùng khoá cài trên máy chủ nếu có, không có thì trợ lý AI tắt |
Khoá được mã hoá trước khi lưu và không bao giờ hiện lại trên màn hình, kể cả với Quản trị hệ thống: muốn đổi thì dán khoá mới. Máy chủ ghi lại ai đã đổi khoá, lúc nào (kèm 4 ký tự cuối). Nếu người kỹ thuật đổi khoá bí mật của máy chủ, khoá đã lưu không giải mã được nữa: màn hình báo đỏ và xin dán lại.
Ô số#
| Trường | Dùng để làm gì | Giá trị & ràng buộc | Ghi chú & tình huống dùng |
|---|---|---|---|
| Hôm nay | Số câu và chi phí từ 0 giờ hôm nay | "n câu"; dòng dưới "Chi phí $… / trần $…" | Không tính lượt bị lỗi mà mô hình chưa trả lời gì |
| 30 ngày | Số câu và chi phí 30 ngày qua (kể cả hôm nay) | Dòng dưới ghi thêm số giáo xứ có dùng | Chi phí là ước tính theo bảng giá máy chủ đặt (theo giá công bố của mô hình đang dùng; mặc định Claude Haiku 5.5: 0,10 USD mỗi triệu token vào, 0,50 USD mỗi triệu token ra, 0,01 USD mỗi triệu token đọc lại phần đã lưu tạm, 0,125 USD mỗi triệu token ghi phần lưu tạm, khoảng 0,0014 USD một câu hỏi), không phải hoá đơn |
| Đánh giá 30 ngày | Tỉ lệ 👍 trên các câu đã được người hỏi đánh giá | "…% 👍"; "Chưa có" khi chưa ai đánh giá. Dòng dưới: số 👍 · số 👎. Viền cam khi 👎 nhiều hơn 👍 | Phần lớn người hỏi không bấm đánh giá: con số chỉ để tham khảo |
| Lỗi 30 ngày | Số lượt trợ lý trục trặc (mô hình không trả lời được, hết giờ chờ) | Viền cam khi có lỗi | Lỗi kéo dài thì xem Nhật ký lỗi |
Hạn mức mặc định#
Áp cho mọi giáo xứ chưa đặt hạn mức riêng. Ô để trống thì theo cấu hình của máy chủ (số đó hiện mờ trong ô).
| Trường | Dùng để làm gì | Giá trị & ràng buộc | Ghi chú & tình huống dùng |
|---|---|---|---|
| Mỗi tài khoản / ngày | Số câu tối đa một tài khoản hỏi trong một ngày | Số nguyên 0 tới 100.000; trống = theo máy chủ (thường 30) | Đặt 0 là không ai hỏi được |
| Mỗi giáo xứ / ngày | Số câu tối đa cả giáo xứ hỏi trong một ngày | Số nguyên 0 tới 100.000; trống = theo máy chủ (thường 300) | — |
| Toàn hệ thống / ngày | Số câu tối đa mọi giáo xứ cộng lại | Số nguyên 0 tới 100.000; trống = theo máy chủ (thường 3.000) | — |
| Trần chi phí / ngày | Số tiền (USD) tối đa mỗi ngày cho cả hệ thống | Số không âm, có thể có phần lẻ (dấu phẩy hoặc dấu chấm); trống = theo máy chủ (thường 100) | Chạm trần thì trợ lý tạm nghỉ ở mọi giáo xứ tới 0 giờ hôm sau: nút Hỏi trợ lý ẩn khi người dùng mở lại phần mềm, câu đang hỏi được báo "Hôm nay trợ lý đã dùng hết ngân sách trong ngày của hệ thống nên tạm nghỉ tới ngày mai. …". Nâng trần là mở lại ngay |
| Lưu hạn mức | Ghi bốn ô trên | Ô gõ chữ hoặc số âm thì báo "Chỉ nhập số không âm (hoặc để trống để theo mặc định)." | Áp dụng ngay cho câu hỏi kế tiếp |
Các giáo xứ#
| Trường | Dùng để làm gì | Giá trị & ràng buộc | Ghi chú & tình huống dùng |
|---|---|---|---|
| Giáo xứ | Tên giáo xứ, giáo hạt bên dưới | Giáo xứ thử nghiệm có nhãn riêng | — |
| Hôm nay, 30 ngày | Số câu của giáo xứ | — | Bảng xếp giáo xứ dùng nhiều nhất trong 30 ngày lên đầu |
| Chi phí 30 ngày | Chi phí ước tính của giáo xứ | USD | — |
| Trạng thái | Trợ lý có chạy ở giáo xứ này không | Đang bật, Hệ thống đã tắt (Quản trị hệ thống tắt ở hộp Sửa), Giáo xứ tự tắt (Quản trị giáo xứ tắt ở Tùy chọn) | Hai công tắc tách riêng: giáo xứ không tự bật lại được khi hệ thống đã tắt, và hệ thống cho phép lại thì giáo xứ vẫn giữ lựa chọn của mình |
| Hạn mức riêng | Hạn mức đặt riêng cho giáo xứ | "n câu/ngày · n câu/tài khoản" hoặc "Theo mặc định" | — |
| Sửa | Mở hộp Trợ lý ở <tên giáo xứ> | Hộp có ô Cho phép giáo xứ này dùng trợ lý, Số câu / ngày, Mỗi tài khoản / ngày (trống = theo mặc định), nút Hủy và Lưu; Esc hoặc X để đóng | Dòng đầu hộp nói rõ nếu giáo xứ đang tự tắt |
Câu hỏi hay gặp 30 ngày#
| Trường | Dùng để làm gì | Giá trị & ràng buộc | Ghi chú & tình huống dùng |
|---|---|---|---|
| Câu hỏi | Câu được hỏi lặp lại, đã che như ở thẻ Câu cần xem | Các câu chỉ khác nhau dấu tiếng Việt, chữ hoa hay dấu câu được gộp làm một ("Thêm gia đình mới?" và "them gia dinh moi" là một câu) | Câu gõ khác chữ mà cùng ý thì vẫn là hai dòng; xem thêm thẻ Chủ đề hay hỏi |
| Số lần | Số lần câu này được hỏi trong 30 ngày | Từ 2 trở lên | Không tính các lượt gợi ý tự động |
| Giáo xứ | Số giáo xứ khác nhau đã hỏi câu này | — | Nhiều giáo xứ cùng hỏi là câu nên đưa vào Câu hỏi thường gặp hoặc trang chủ |
| 👍 / 👎 | Số lần người hỏi khen / chê câu trả lời | — | 👎 nhiều: hướng dẫn cho việc này còn thiếu hoặc khó hiểu |
Chủ đề hay hỏi 30 ngày#
| Trường | Dùng để làm gì | Giá trị & ràng buộc | Ghi chú & tình huống dùng |
|---|---|---|---|
| Trang hướng dẫn | Trang hướng dẫn khớp nhất với câu hỏi (cùng cách trợ lý tìm trang để trả lời) | Bấm để mở trang ở thẻ mới | Không gọi mô hình AI, không tốn tiền |
| Số câu | Số câu hỏi rơi vào trang này trong 30 ngày | Tính trên tối đa 2.000 lượt hỏi gần nhất | — |
| 👎 | Số câu bị chê trong chủ đề này | — | Chủ đề nhiều câu mà nhiều 👎 là chỗ nên viết thêm trước |
| Câu mẫu | Tối đa 3 câu hỏi khác nhau thuộc chủ đề này | Đã che | Để biết người dùng diễn đạt việc đó bằng lời thế nào, thêm vào từ khoá của trang |
Câu cần xem để viết thêm hướng dẫn#
| Trường | Dùng để làm gì | Giá trị & ràng buộc | Ghi chú & tình huống dùng |
|---|---|---|---|
| Lúc | Giờ và ngày hỏi | — | Mới nhất ở trên |
| Loại | Vì sao câu này cần xem | Bị 👎 (người hỏi chê, có thể kèm ghi chú), Lỗi, Từ chối (mô hình không trả lời câu này), Bị cắt ngang (câu trả lời quá dài, bị cắt) | — |
| Câu hỏi | Câu người dùng gõ, đã che | Tên người thành [tên], số điện thoại thành [số điện thoại], email thành [email], số CCCD/CMND thành [số giấy tờ]; dòng "Ghi chú: …" nếu người chê có ghi | Che tên chỉ bắt được tên viết hoa từng chữ (tên thánh kèm tên, hoặc họ tên từ ba chữ); tên gõ chữ thường thì không che được |
| Giáo xứ · màn hình | Giáo xứ hỏi và trang hướng dẫn của màn hình đang mở lúc hỏi | — | Biết người dùng vướng ở màn hình nào |
Gợi ý tự động 30 ngày#
| Trường | Dùng để làm gì | Giá trị & ràng buộc | Ghi chú & tình huống dùng |
|---|---|---|---|
| Gợi ý | Câu người dùng thấy trên thẻ, kèm mã gợi ý (chữ nhỏ) | Gợi ý chung hiện là "Hộp mở ra rồi đóng không lưu hai lần" hoặc "Cùng một báo lỗi hiện hai lần" | Nhiều lần hiện nhất ở trên |
| Hiện | Số lần thẻ đã hiện trong 30 ngày | — | Máy người dùng gửi số đếm của các ngày đã qua mỗi lần mở phần mềm, nên số hôm nay chưa có |
| Bấm | Tỉ lệ người dùng bấm nút trên thẻ | Phần trăm trên số lần hiện | Cao là gợi ý có ích |
| Từ chối | Tỉ lệ bấm Không, cảm ơn | Phần trăm trên số lần hiện | Thẻ tự ẩn sau 20 giây không tính là từ chối |
| Trạng thái | Gợi ý còn dùng hay đã tự ngưng | Đang dùng hoặc Đã tự ngưng | Tự ngưng khi đã hiện từ 50 lần trở lên và bị từ chối quá 80 %. Máy người dùng thôi hiện gợi ý đó trong vòng 10 phút |
Số đếm không có tên người hay tài khoản, chỉ có giáo xứ, ngày và mã gợi ý; giữ 90 ngày.
Các việc thường làm#
Bật trợ lý AI lần đầu#
- Vào console.anthropic.com, đăng nhập tài khoản Anthropic của giáo phận / nhóm phát triển, mở API Keys, bấm Create Key, chép khoá.
- Mở Hệ thống › Trợ lý hỏi đáp, dán khoá vào ô Dán khoá ở thẻ Khoá API, bấm Kiểm tra khoá và lưu.
- Dòng trạng thái đổi thành "Đang dùng khoá …(4 ký tự cuối)". Thanh báo đỏ "Trợ lý AI đang tắt" biến mất.
- Đặt Trần chi phí / ngày ở thẻ Hạn mức mặc định cho vừa ngân sách.
Viết thêm hướng dẫn từ các câu bị chê#
- Mở Hệ thống › Trợ lý hỏi đáp, kéo xuống thẻ Câu cần xem để viết thêm hướng dẫn.
- Gom các câu hỏi cùng ý (nhiều giáo xứ hỏi giống nhau là việc nên làm trước). Thẻ Câu hỏi hay gặp 30 ngày và Chủ đề hay hỏi 30 ngày đã gom sẵn: câu nhiều giáo xứ hỏi nên vào trang Câu hỏi thường gặp và phần hỏi đáp ở trang chủ quanlygiaoxu.net.
- Thêm câu trả lời vào trang Câu hỏi thường gặp hoặc viết hướng dẫn từng bước cho việc đó, rồi đưa bản hướng dẫn mới lên (trợ lý chỉ biết những gì có trong hướng dẫn).
Một giáo xứ hỏi quá nhiều#
- Ở thẻ Các giáo xứ, bấm Sửa ở dòng giáo xứ đó.
- Gõ số nhỏ hơn vào Số câu / ngày hoặc Mỗi tài khoản / ngày, bấm Lưu. Muốn ngừng hẳn thì bỏ tích Cho phép giáo xứ này dùng trợ lý.
Trợ lý đang tạm nghỉ vì chạm trần chi phí#
Thanh báo đỏ "Chi phí hôm nay đã chạm trần …" hiện ở đầu màn hình. Chờ tới 0 giờ hôm sau trợ lý tự mở lại, hoặc gõ số lớn hơn vào Trần chi phí / ngày rồi bấm Lưu hạn mức để mở lại ngay.
Quy tắc ẩn và giới hạn#
- Thứ tự lấy hạn mức: hạn mức riêng của giáo xứ (nếu có) → hạn mức mặc định trên màn hình này → cấu hình của máy chủ.
- Một ngày tính từ 0 giờ theo giờ Việt Nam. Hết lượt thì hôm sau hỏi tiếp.
- Lượt lỗi mà mô hình chưa trả lời gì không bị trừ vào hạn mức của người hỏi.
- Câu báo cho người hỏi khi hết lượt: "Hôm nay tài khoản này đã hỏi n câu, mức tối đa mỗi ngày. …", "Hôm nay giáo xứ đã dùng hết số câu hỏi trợ lý trong ngày. …", "Hôm nay trợ lý đã nhận đủ số câu hỏi tối đa của cả hệ thống. …".
- Giáo xứ bị tắt: nút Hỏi trợ lý ẩn khi người dùng mở lại phần mềm; nếu đang mở hộp trợ lý thì câu hỏi kế tiếp báo "Trợ lý hỏi đáp đang tắt ở giáo xứ này. …" (giáo xứ tự tắt) hoặc "Trợ lý hỏi đáp chưa mở cho giáo xứ này. …" (hệ thống tắt).
- Lưu 90 ngày: mỗi lượt hỏi (câu hỏi đã che, giờ hỏi, màn hình, số token, chi phí, đánh giá) giữ 90 ngày rồi tự xoá. Câu trả lời không được lưu.
- Số liệu không gồm câu nào gửi đi lúc máy chủ chưa bật trợ lý.
- Gợi ý tự động hỏi máy chủ (khi một báo lỗi lặp lại mà chưa có câu soạn sẵn) được ghi như một lượt hỏi, câu hỏi bắt đầu bằng "[gợi ý]", và tính vào hạn mức. Mỗi tài khoản tối đa 3 lần mỗi ngày; cùng một báo lỗi ở cùng màn hình chỉ hỏi mô hình một lần trong 7 ngày (các lần sau dùng lại câu đã có, không tốn lượt).
Hỏi đáp và xử lý sự cố#
| Người dùng hỏi / gặp | Vì sao | Cách xử lý |
|---|---|---|
| Thanh báo "Máy chủ chưa bật trợ lý" | Máy chủ thiếu khoá dịch vụ mô hình hoặc thiếu tệp hướng dẫn cho trợ lý | Người vận hành máy chủ cài khoá và đưa lại bản hướng dẫn; người dùng không thấy nút trợ lý trong lúc này |
| Giáo xứ báo không thấy nút Hỏi trợ lý | Giáo xứ tự tắt, hệ thống đã tắt, hoặc chi phí hôm nay chạm trần | Xem cột Trạng thái của giáo xứ; giáo xứ tự tắt thì Quản trị giáo xứ bật lại ở Tùy chọn |
| Giáo xứ báo hỏi vài câu đã hết lượt | Hạn mức riêng của giáo xứ hoặc của tài khoản quá thấp | Bấm Sửa ở dòng giáo xứ, nâng hạn mức hoặc để trống để theo mặc định |
| Chi phí khác hoá đơn của nhà cung cấp | Chi phí trên màn hình là ước tính theo bảng giá máy chủ đặt | Đối chiếu hoá đơn; bảng giá đổi thì người vận hành máy chủ sửa cấu hình |
| Không thấy mục Trợ lý hỏi đáp | Bạn không phải Quản trị hệ thống | Quản trị giáo xứ dùng hộp Tùy chọn để bật, tắt cho giáo xứ mình |
Màn hình liên quan#
- Bảng điều khiển
- Tùy chọn (Quản trị giáo xứ bật, tắt trợ lý)
- Nhật ký lỗi
- Hỏi trợ lý