에이전트 도구 추적은 모델의 추론 단계와 외부 도구 실행을 각각 스팬으로 기록하고 부모·자식으로 연결합니다. 어느 도구가 느리거나 실패했는지 요청 전체 흐름에서 볼 수 있습니다.
데모는 모델에서 검색 도구로 내려갔다가 결과를 받아 응답으로 돌아오는 경로를 순서대로 강조합니다. 도구 인수와 응답에는 민감 정보가 있을 수 있으므로 기록 범위를 제한해야 합니다.
언제 쓰나
에이전트가 여러 도구를 쓰는 동안 지연·오류·흐름을 조사할 때 사용합니다.
에이전트 도구 추적
Agent tool tracing
모델 판단과 도구 호출·응답을 하나의 추적 트리로 잇습니다.
···
<div class="demo"><div class="title">AGENT TRACE TREE</div><div class="scene"><div class="tree"><div class="model">model · plan</div><div class="tool">└ search tool <b>320 ms</b></div><div class="result"> └ result · 3 hits</div><div class="answer">model · answer</div></div></div></div>.demo{width:min(94vw,690px);height:min(88vh,320px);box-sizing:border-box;padding:clamp(9px,2.5vmin,18px);border:1px solid var(--line);border-radius:14px;background:var(--surface);color:var(--fg);font:600 clamp(12px,2.4vmin,16px)/1.25 var(--font-sans,"Pretendard Variable",Pretendard,-apple-system,BlinkMacSystemFont,sans-serif);display:flex;flex-direction:column;gap:clamp(7px,2vmin,14px);overflow:hidden}.title{color:var(--accent);font:700 clamp(12px,2.4vmin,16px)/1.2 var(--font-sans,"Pretendard Variable",Pretendard,-apple-system,BlinkMacSystemFont,sans-serif);letter-spacing:.04em}.scene{flex:1;min-height:0;position:relative;display:flex;align-items:center;justify-content:center;overflow:hidden}.tree{width:90%;display:grid;gap:5px;font:600 clamp(12px,2.4vmin,15px)/1.2 ui-monospace,monospace}.tree div{padding:5px 7px;border-left:3px solid var(--line);background:var(--bg);white-space:nowrap;overflow:hidden;animation:walk 3s infinite}.tree div:nth-child(2){animation-delay:.5s}.tree div:nth-child(3){animation-delay:1s}.tree div:nth-child(4){animation-delay:1.5s}.tree b{color:var(--accent-3)}@keyframes walk{0%,20%,85%,100%{border-color:var(--line);background:var(--bg)}35%,65%{border-color:var(--accent);background:color-mix(in srgb,var(--accent) 17%,var(--surface))}}