📝 에이전트 도구 설계

from strands import Agent, tool

# ① 도구 정의 — docstring이 LLM에게 전달되는 도구 설명
@tool
def search_restaurants(location: str, cuisine: str = None) -> str:
    """지역과 요리 종류로 식당을 검색합니다.

    사용자가 식당 추천을 요청할 때 호출하세요.
    location: 검색할 지역명 (예: "강남역")
    cuisine: 요리 종류 (예: "이탈리안"). 생략하면 전체 검색
    """
    return f"{location} 근처 식당 3곳 발견"

# ② Agent에 도구 전달 → ReAct 루프에서 자율 호출
agent = Agent(
    model="us.anthropic.claude-sonnet-4-6",
    tools=[search_restaurants],
)

# ③ 실행 — 모델이 스스로 도구 호출을 결정하고 결과를 종합
result = agent("강남역 이탈리안 추천해줘")

• @tool 데코레이터 — 평범한 Python 함수가 그대로 도구가 됨. docstring·타입 힌트가 name·description·inputSchema로 자동 변환
• tools=[...] 등록 — 모델이 선택할 수 있는 행동 목록. 리스트에 담는 순간 ReAct 루프의 선택지
• 실행 — 호출 여부·인자를 모델이 스스로 결정하고, Observation을 종합해 최종 답변

from strands.hooks import BeforeToolCallEvent, HookProvider, HookRegistry

# ① Hook 정의 — 도구 실행 직전(BeforeToolCallEvent)에 개입
class ApprovalGate(HookProvider):
    """고위험 도구 호출 전 사용자 승인을 요청하는 Hook"""

    def register_hooks(self, registry: HookRegistry):
        registry.add_callback(BeforeToolCallEvent, self.check)

    def check(self, event: BeforeToolCallEvent):
        # ② 쓰기/삭제 도구만 승인 요청 — 읽기 도구는 통과
        dangerous = ["cancel_reservation", "delete_account"]
        if event.tool_use["name"] in dangerous:
            event.interrupt(
                "approval_needed",
                reason=f"'{event.tool_use['name']}' 실행을 승인하시겠습니까?"
            )

# ③ 에이전트에 Hook 적용
agent = Agent(
    model="us.anthropic.claude-sonnet-4-6",
    tools=[cancel_reservation, search_restaurants],
    hooks=[ApprovalGate()]
)

• BeforeToolCallEvent — 도구가 실제로 실행되기 직전의 개입 지점. 여기서 멈추면 도구는 실행되지 않음
• 선별 승인 — 고위험 도구만 event.interrupt()로 일시 중지. 승인 → 재개, 거부 → 중단
• hooks=[...] — Agent에 붙이는 순간 모든 도구 호출이 이 게이트를 거침. 도구 코드는 무변경