Next-BlockChain

Using Multiple Tools: Claude에게 여러 도구를 한 번에 쥐어주기 (4단계 모듈식 확장 패턴)지난 글에서 다중턴 루프 패턴 을 완성했어요. 그런데 거기까지는 도구가 하나 뿐이었죠 (get_current_datetime). 실제 서비스는 보통 수십 개의 도구 를 동시에 운영합니다. Claude Code 만 봐도 read_file, write_file, bash, grep, glob 등 도구가 즐비해요.오늘은 여러 도구를 함께 등록하고, Claude 가 알아서 골라 쓰게 하는 패턴 을 정리합니다. 핵심 메시지는 단순해요. "한 번 인프라를 만들어두면, 새 도구 추가는 4줄짜리 작업이 된다."실전 시나리오로는 강의가 제시한 "의사 진료 예약 알림" 을 활용해서 Claude 가 여러 도구를 ..

AI 2026. 5. 17. 21:18

Implementing Multiple Turns: Claude Tool Use 의 진짜 핵심 — 무한 루프 패턴 완성지난 글까지 우리는 딱 1턴짜리 Tool Use 사이클을 구현했어요. 사용자 → Claude → 도구 호출 → 결과 → 최종 응답. 그런데 실전에서는 이게 한 번으로 끝나지 않습니다.예를 들어 "내일 오후 3시에 회의 잡고 알림도 같이 설정해줘" 라는 요청을 보세요. Claude 가:add_duration_to_datetime 으로 "내일 오후 3시" 계산결과를 받고 → set_reminder 로 알림 설정또 결과를 받고 → 최종 답변 생성3단계의 도구 호출이 연쇄적으로 일어나야 해요. 이게 바로 Multi-turn Tool Use 입니다.오늘은 Claude 가 만족할 때까지 계속 도구 ..

AI 2026. 5. 17. 19:49

Sending Tool Results: Claude에게 결과 돌려주는 마지막 한 걸음 (tool_result 블록 완전 정복)지난 글에서 멀티블록 응답 의 구조를 봤어요. Claude 가 tool_use 블록으로 "이 함수를 이 인자로 호출해줘" 라고 부탁한 상태였죠. 오늘은 그 부탁을 실제로 수행하고, 결과를 다시 Claude 에게 돌려주는 마지막 한 걸음을 구현합니다.이 단계가 끝나면 Tool Use 의 완전한 1턴 사이클 이 완성돼요. 사용자 → Claude → 도구 호출 → 결과 → 최종 답변 까지 한 줄로 연결됩니다.오늘은 `언팩킹 트릭,tool_result블록의 3가지 필드, 병렬 호출 시 id 매칭 규칙, 그리고 follow-up 호출에서도tools` 를 빠뜨리면 안 되는 이유** 까지 정리..

AI 2026. 5. 17. 10:54

#Handling Message Blocks: Tool Use 응답의 멀티블록 구조 다루기 (텍스트 + tool_use 블록)지난 글에서 Tool Schema 까지 만들었어요. 이제 그 스키마를 실제 API 호출에 끼워 넣고, Claude 가 돌려주는 응답 을 처리하는 단계로 넘어갑니다.여기서 주의할 점이 하나 있어요. Tool Use 가 켜진 응답은 더 이상 "단순 텍스트" 가 아닙니다. 텍스트 블록과 tool_use 블록이 여러 개 들어 있는 멀티블록(multi-block) 메시지 가 돌아와요. 이걸 잘못 다루면 대화 맥락이 깨지고, Claude 가 자기가 방금 뭘 부탁했는지 까먹습니다.오늘은 멀티블록 응답의 구조, 대화 히스토리에 그대로 보존하는 법, 그리고 헬퍼 함수가 왜 업데이트되어야 하는지를 ..

AI 2026. 5. 15. 18:13

Tool Schemas: Claude에게 "이런 도구가 있어" 라고 알려주는 JSON 스키마 설계법지난 글에서 첫 Tool Function (get_current_datetime) 을 만들었어요. 그런데 Python 함수만 짜놓는다고 Claude 가 자동으로 호출하는 건 아닙니다. Claude 는 우리 코드를 읽지 못해요. 함수 시그니처도, docstring 도, 타입 힌트도 안 보입니다.그래서 필요한 게 바로 Tool Schema(도구 스키마) 입니다. "이런 함수가 있고, 이런 인자를 받고, 이럴 때 써" 를 Claude 가 읽을 수 있는 JSON 형식으로 풀어 쓴 설명서예요.오늘은 Tool Schema 의 3가지 필수 구성, 3~4문장짜리 효과적인 description 쓰는 법, 그리고 강의에서 알..

AI 2026. 5. 13. 01:33