AI 에이전트 실행 흐름과 비용을 한눈에 보는 도구
agentcanvas는 Pydantic AI로 만든 AI 에이전트의 실행 기록을 읽어, 전체 흐름을 하나의 인터랙티브 HTML 그림으로 보여준다. Logfire에 이미 저장된 실행 추적을 가져와 사용자의 질문, 에이전트의 판단 과정, 모델 호출, 도구 사용, 하위 에이전트 호출, 최종 답변까지 단계별로 연결한다. 각 모델 호출마다 입력 토큰, 출력 토큰, 추론 토큰, 비용을 보여주고, 전체 실행 비용도 합산한다.
도구를 눌러 보면 입력값, 출력값, 걸린 시간, 모델이 사용할 수 있었던 도구 목록 같은 세부 정보도 확인할 수 있다. 결과물은 서버 없이 열 수 있는 단일 HTML 파일이라 회의나 고객 설명 자료로 공유하기 쉽다. 설치 후 LOGFIRE_READ_TOKEN을 설정하면 최신 실행 기록, 특정 추적 아이디, 또는 원하는 파일명으로 보고서를 만들 수 있다.
예제에는 다섯 가지 도구, 하위 에이전트, 여러 번 오가는 대화를 포함한 샘플 에이전트가 들어 있다.
핵심 포인트
- Pydantic AI 에이전트의 Logfire 실행 기록을 인터랙티브 HTML 그림으로 바꾼다.
- 모델 호출, 도구 사용, 하위 에이전트, 여러 차례 대화를 단계별로 보여준다.
- 각 단계와 전체 실행의 토큰 사용량과 비용을 확인할 수 있다.
- 결과 파일은 단일 HTML이라 서버 없이 열고 공유할 수 있다.
- 비용 절감 관점에서는 어떤 단계가 비싼지 찾는 관찰 도구로 유용하다.
용어 한 줄 설명
- canvas
- 브라우저에서 그림이나 게임 화면을 그릴 때 쓰는 HTML 기능입니다.
- Pydantic AI
- 파이썬에서 AI 에이전트를 만들 때 쓰는 개발 도구다.
- AI 에이전트
- 사람 대신 정보를 찾거나 작업을 처리하도록 만든 AI 프로그램입니다.
- Logfire
- 프로그램 실행 과정을 기록하고 나중에 분석하게 해 주는 서비스다.
- 하위 에이전트
- 메인 AI 시스템 아래에서 특정 작업만 처리하도록 만들어진 작은 AI 도우미입니다.
- 에이전트 프레임워크
- AI가 여러 도구를 순서대로 사용해 복잡한 작업을 자동으로 처리하도록 도와주는 개발 도구 모음
- 프레임워크
- 개발할 때 반복되는 구조와 기능을 미리 갖춘 도구 묶음입니다.
- 토큰 사용량
- AI에게 보내고 받은 글의 양을 세는 단위 사용량입니다.