> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 도구 호출

> Agent 가 도구들에게 하라고 요청한 모든 것과 돌아온 것.

도구 호출은 종종 실행의 진실이 사는 곳입니다. Agent 답변이 틀렸으면 도구가 잘못된 것을 반환했거나, Agent 가 잘못된 도구를 골랐거나, 올바른 도구를 잘못된 인자로 골랐거나. 트레이스가 셋 다 가시화합니다.

## 도구 호출 뷰

실행의 각 도구 호출에:

* **도구 이름** 과 버전.
* **인자** — 모델이 고른 정확한 JSON.
* **응답** — 도구의 원본 응답.
* **소요** — 호출에서 응답까지 벽시계.
* **재시도** — 도구가 재시도했으면 시도.
* **비용** — 직접 달러 비용 (API 가격 있는 도구).

인자는 신택스 하이라이팅과 도구 스키마에 대한 diff 주석과 함께 표시 — 필수인데 누락된 인자는 빨강, 인식 안 되는 인자는 노랑.

## "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 를 트리거했다면 ([에이전트 답변 검증](/ko/build/causal-graph/verification) 참고), 두 번째 패스는 다른 도구 호출을 할 수 있음. 두 패스 모두 `Rewrite` 마커로 구분되어 타임라인에 표시.

## 데이터셋에 도구 호출 기록

도구 호출 우클릭 → **Add to dataset**. 도구 호출 입력과 출력을 레이블된 예로 복사. 실제 프로덕션 동작에서 테스트 픽스처 구축에 유용.