Skip to main content
Agent 답변이 틀렸다면 툴이 엉뚱한 걸 돌려줬거나, 엉뚱한 툴을 선택했거나, 맞는 툴을 잘못된 인자로 부른 것입니다. 스팬 트리의 툴 스팬(렌치 아이콘)이 셋을 다 보여줍니다.

툴 스팬 상세

툴 스팬을 클릭하면 섹션 네 개가 나옵니다.
  • 툴 호출된 툴의 정의입니다. 이름, 런타임, 설명, 그리고 인라인 SQL 툴라면 실행된 쿼리 본문까지 그대로 보입니다.
  • 입력 모델이 선택한 인자입니다. 키와 값이 짝으로 나옵니다.
  • 출력 툴이 돌려준 원본 응답입니다. 행 데이터는 표로 렌더링되어 훑기 좋습니다.
  • 메타데이터 호출 시점의 툴 컨텍스트(toolContext)입니다.
포맷 / JSON 토글로 원본 JSON도 확인할 수 있습니다.

디버깅 순서

  1. 입력을 봅니다. 인자가 틀렸다면 툴 파라미터 설명이 흐릿한 경우가 많습니다.
  2. 출력을 봅니다. 호출은 성공했는데 데이터가 이상하면 툴 구현을 살펴보세요.
  3. 툴 정의를 봅니다. 엉뚱한 툴을 선택했다면 툴 설명을 조이세요. Agent는 설명을 보고 선택합니다.

실패한 툴 호출

툴 호출이 실패한 실행은 목록에서 오류 상태가 되고, 실패가 런타임 오류 신호로 잡혀 신호 페이지에 쌓입니다. 신호 개요를 참고하세요.