Khi bị Guardrails chặn
Khi một thao tác của agent bị chặn, trang này giúp bạn hiểu chuyện gì đã xảy ra, xem lý do và gửi phản hồi nếu thấy chặn nhầm. Trang chỉ nói nguyên tắc, không liệt kê luật cụ thể.
Guardrails làm gì?
Guardrails là lớp an toàn do tổ chức đặt, chạy ngay trên máy bạn. Nó nằm giữa Claude Code và những việc agent muốn làm, để bí mật không lọt tới model và dữ liệu không bị đưa ra ngoài. Cách làm việc hằng ngày của bạn không đổi, và Guardrails cũng không thay firewall hay các biện pháp khác của tổ chức.
Luật nằm trong các gói policy trên Tara, được duyệt, ký số và thu hồi được như mọi tài nguyên. Policy áp theo tầng: nền tảng đặt mức sàn, còn tổ chức và dự án có thể siết thêm cho phạm vi của mình. Xem Guardrails theo tầng.
Ba kết quả có thể gặp
| Kết quả | Bạn thấy gì | Ý nghĩa |
|---|---|---|
| Chặn | Thao tác bị từ chối, kèm tên luật và lý do | Thao tác vi phạm một luật nên agent không chạy |
| Hỏi lại | Claude Code hiện hộp xác nhận | Thao tác có rủi ro, bạn quyết định cho phép hay không |
| Che | Một phần nội dung bị thay bằng dấu che | Guardrails phát hiện thông tin nhạy cảm như khóa bí mật hay số định danh, và che trước khi tới model hoặc khi ghi nhật ký |
Bị chặn chưa chắc là bạn làm sai. Có khi luật chặn nhầm, có khi agent chọn một cách làm không cần thiết.
Bị chặn thì làm gì?
Đọc thông báo. Nó nêu mã luật (
id) và lý do.Thử tìm cách an toàn khác cho cùng mục đích và nhờ agent làm theo hướng đó, chẳng hạn dùng dữ liệu mẫu thay vì dữ liệu thật.
Xem tình trạng Guardrails trên máy:
bashph guardrails statusLệnh cho biết hook server có đang chạy không, policy nào đang áp và cấu hình quản lý.
Nếu bạn tin luật chặn nhầm, gửi phản hồi. Đội phụ trách sẽ xem và sửa luật bằng một version mới của gói policy:
bashph guardrails feedback <id luật> --note "Why I think this is a false positive"Ghi chú được che bí mật trước khi gửi, nhưng bạn vẫn nên mô tả ngữ cảnh và đừng dán dữ liệu thật.
Xem lý do chi tiết trên máy bạn
Muốn biết một luật đã chặn bao nhiêu lần và trong ngữ cảnh nào, bạn dùng nhật ký audit trên máy:
ph guardrails audit --days 7 # số lần theo luật
ph guardrails audit --rule <id luật> --samples 5 # kèm vài mẫu ngữ cảnh đã cheNhật ký này nằm trên máy bạn và đã được che bí mật. Qua Ryoma, tổ chức chỉ nhận số đếm theo luật và dự án, không kèm nội dung. Kho audit chi tiết cho đội bảo mật chỉ hoạt động khi tổ chức bật riêng. Xem Dữ liệu thu thập.
Đừng tìm cách tắt hay vượt Guardrails
Nếu cần ngoại lệ, bạn xin qua trưởng nhóm để policy của tổ chức hoặc dự án được cập nhật đúng quy trình. Khi hook server không chạy hoặc chưa có policy hợp lệ, Guardrails chặn để an toàn (fail-closed): lúc đó bạn chạy ph guardrails status rồi báo đội vận hành, xem Xử lý sự cố.