클로드 디버깅 사례: 누락된 매개변수로 인해 에이전트가 조용히 실패했으며, 프레이밍이 모델보다 더 중요했습니다.

무슨 일이 있었나

한 개발자가 Claude를 사용하여 캘린더 에이전트를 구축했습니다. 이 에이전트는 참석자와 함께 캘린더 이벤트를 생성해야 했지만, 테스트 시나리오에서 누군가를 회의에 초대하려고 할 때, 이벤트는 생성하고 성공을 보고했지만, 실패를 언급하지 않고 초대를 조용히 무시했습니다.

디버깅 과정

개발자가 Claude에게 도구를 재작성하지 않는 방식으로 에이전트를 수정해 달라고 요청했을 때, Claude는 약 40분 동안 네 가지 다른 프롬프트 수정을 시도했습니다. 각 시도는 같은 이유로 실패했습니다: write_calendar 도구가 참석자 매개변수를 받아들이지 않았기 때문입니다.

Claude는 매개변수가 존재하지 않는다고 명시적으로 언급하지 않았습니다. 그저 다른 프롬프트 수정을 계속 시도했을 뿐입니다.

돌파구

개발자가 접근 방식을 바꾸어 네 가지 디버깅 추적 기록과 소스 코드를 모두 하나의 컨텍스트 창에 덤프했을 때, Claude는 약 10초 만에 즉시 문제를 진단했습니다. 모델은 다음과 같이 확인했습니다: "write_calendar 도구는 참석자 매개변수를 받아들이지 않습니다. 제약은 명령 수준이 아닌 코드 수준에 있습니다."

핵심 통찰

40분 동안 우회책을 찾느라 시간을 보낸 동일한 Claude 모델이 올바른 틀을 제공받자 몇 초 만에 근본 원인을 찾아냈습니다. 개발자는 다음과 같이 언급했습니다: "틀이 모델보다 더 중요했습니다. 같은 Claude, 같은 코드, 다른 질문이었습니다."

Claude가 write_calendar 도구를 직접 생성했기 때문에, 개발자는 누락된 매개변수를 확인하기 위해 함수 시그니처를 확인할 생각을 하지 못했습니다.