Skill: dym-harness-sdk-interventions — chốt chặn tool call
When to use
- Cần agent hỏi người trước khi chạy tool nguy hiểm, hoặc tự phân loại rủi ro, hoặc tuân policy Cedar.
- Khác hook chặn thường: handler trả về QUYẾT ĐỊNH có kiểu (Proceed · Deny · Guide · Interrupt · Transform), registry gộp theo ưu tiên Deny > Interrupt > Transform > Guide > Proceed; Deny cắt ngắn chuỗi, Guide cộng dồn phản hồi, có audit log chung (design
team/designs/0007-intervention-primitive.md).
Steps
- Grammar chuỗi là TẤT ĐỊNH, không đoán nội dung (
harness-py/src/strands_harness/interventions.py):giá trị thành "off"/Nonekhông có handler "ask"HumanInTheLoop(ask=...)— hỏi người mỗi call"smart"HumanInTheLoop(classifier=True)— LLM phân loại rủi ro, chỉ hỏi call bị cờchuỗi kết thúc .cedarCedarAuthorization(policies=<file>)— cầnpip install 'strands-agents[cedar]'chuỗi khác chính sách chữ → prompt của bộ phân loại rủi ro instance InterventionHandlerđi thẳng, không đổi - Ghép nhiều lớp khác loại:
create_harness(interventions=["policies/tools.cedar", "smart"]) - Kiểm hành vi lỗi (đo 2026-09-28, rc 0):
create_harness(session=False, memory=False, interventions=["ask", "ask"]) # ValueError: Two interventions share the handler name 'strands:human-in-the-loop' ... create_harness(session=False, memory=False, interventions=123) # ValueError: Invalid interventions value 123; expected a preset name, ...
Rules
- Hai handler CÙNG loại → raise (SDK chỉ giữ một handler mỗi
name); ghép KHÁC loại (Cedar + một preset người duyệt) thì được. - Policy Cedar viết inline KHÔNG được tự nhận diện (trông như văn xuôi) → truyền
CedarAuthorization(policies=...)trực tiếp. - Subagent con kế thừa interventions của cha; lời gọi tool bên trong
programmatic_tool_callervẫn đi qua interventions — không lách được bằng cách gọi gián tiếp. - Xếp handler rẻ trước (Cedar → dịch vụ → LLM) vì Deny cắt ngắn chuỗi.
"ask"vớiask=Nonedùng stdio — chạy headless/CI sẽ kẹt chờ input; truyền callback hoặc dùng interrupt/resume.