도구 호출 뷰
실행의 각 도구 호출에:- 도구 이름 과 버전.
- 인자 — 모델이 고른 정확한 JSON.
- 응답 — 도구의 원본 응답.
- 소요 — 호출에서 응답까지 벽시계.
- 재시도 — 도구가 재시도했으면 시도.
- 비용 — 직접 달러 비용 (API 가격 있는 도구).
”Agent 는 왜 이걸 호출했지?” 질문
각 도구 호출 위에 트레이스가 rationale 표시: 호출을 동기부여한 모델 추론 출력의 조각. 항상 있진 않음 (일부 모델은 추론 방출 안 함), 있으면 “왜” 를 이해하는 가장 빠른 방법.흔한 실패 모드
잘못된 도구
Agent 가send_slack 을 골라야 할 때 send_email 을 고름. 도구 설명을 조이면 해결 — Agent 는 설명만으로 선택.
잘못된 인자
올바른 도구, 잘못된 인자. 흔한 원인: 파라미터 설명이 불명확. 트레이스가 모델이 정확히 무엇을 골랐는지 보여주므로 보통 명백.도구 에러
도구가 4xx 나 5xx 반환.Response 에서 에러 본문 확인. 처리:
- 도구 설정 수정 (잘못된 URL, 만료된 시크릿).
- 일시 에러에 재시도 추가.
- 도구 설명이 인자 모양에 대해 Agent 에게 경고하게 함.
도구 성공했지만 잘못된 데이터 반환
도구 호출은 통과했지만 반환된 데이터가 오해 소지. Agent 가 나쁜 데이터로 추론. 도구 구현 조사.도구 응답 검사
큰 응답 (수백 필드 JSON) 은 접기 가능. 기본 뷰는 최상위 키 표시; 확장하려면 클릭.Copy as curl 이 로컬 디버깅용 정확한 요청 재생성.
도구 호출 시퀀스
멀티 도구 실행은 쌓인 시퀀스로 표시. 흔한 패턴:- Search → Read → Answer — Agent 가 검색하고, 최상위 결과 읽고, 답변.
- Lookup → Verify → Act — Agent 가 엔티티 조회하고, 두 번째 소스로 검증하고, 행동.
- Retry 루프 — Agent 가 도구 호출 시도, 특정 에러 얻음, 조정된 인자로 재시도.
SUCCESS, RETRY, ABANDONED. Abandoned 는 Agent 가 그 경로를 포기했다는 뜻.
Rewrite 중 호출된 도구
검증이 rewrite 를 트리거했다면 (에이전트 답변 검증 참고), 두 번째 패스는 다른 도구 호출을 할 수 있음. 두 패스 모두Rewrite 마커로 구분되어 타임라인에 표시.