Hooks

자율에 필요한 경계

모델이 스스로 도구와 반복을 결정하는 에이전트 — 통제 없는 자율이 만드는 사고들

제어의 4계층

자율은 남기고 경계만 세우는 4계층 — 가볍게는 Hooks, 최후에는 Sandbox

계층별 비교

적용 시점·수준·구현 방식이 모두 다른 4개 레이어

요청이 지나는 관문 순서

Hook 검사 → Plugin 정책 → Intervention 판정 → Sandbox 격리 — 네 계층이 번갈아 개입하는 경로

1. 1
   Hook: BeforeModelCallEvent

   모델 호출 전 검사 — 프롬프트 검증, 비용 체크

2. 2
   Plugin: 정책 확인

   deny/steer 규칙 평가 — 위반 시 차단하거나 방향 수정

3. 3
   Hook: BeforeToolCallEvent

   도구 호출 전 인자 검증·로깅

4. 4
   Intervention: 판정

   Cedar 정책이 permit/forbid 판정, HumanInTheLoop이 민감 도구 승인 요구 — 별개 클래스

5. 5
   Sandbox: 격리 실행

   허용된 도구를 컨테이너 내부에서 실행

Hooks

가장 가벼운 제어 계층 — 이벤트마다 콜백을 걸어 관찰하고 개입

8가지 Hook Event

에이전틱 루프 전 구간을 관찰할 수 있는 강타입 이벤트 포인트

Hook 등록

HookProvider 프로토콜로 기존 에이전트 코드 변경 없이 콜백 부착

from strands import Agent
from strands.hooks import BeforeToolCallEvent, HookProvider, HookRegistry

class BlockDangerousTools(HookProvider):
    """위험 도구 호출을 사전 차단"""
    BLOCKED = {"delete_file", "drop_table", "rm_rf"}

    def register_hooks(self, registry: HookRegistry, **kwargs) -> None:
        registry.add_callback(BeforeToolCallEvent, self.check_tool)

    def check_tool(self, event: BeforeToolCallEvent) -> None:
        tool_name = event.tool_use["name"]
        if tool_name in self.BLOCKED:
            event.cancel_tool = f"Blocked: {tool_name} is not allowed"

agent = Agent(
    model="us.anthropic.claude-sonnet-4-6",
    hooks=[BlockDangerousTools()],
)

Hooks 개입 패턴

관찰에서 개입으로 — 취소·예외·마스킹을 조합한 4가지 대표 시나리오