rajudandigam/agent-inspect

해결하는 문제

에이전트 코드는 복잡하며 단일 함수 호출에서 실패하는 경우는 드물다. 계획 수립, 도구 사용, 재시도 등이 포함된다. 평평한 로그는 실행 경로를 시각화하고 첫 번째 원인 실패를 식별하기 어렵게 만든다. AgentInspect는 에이전트 실행을 가독성 있는 실행 트리로 캡처하는 로컬 우선 접근 방식을 제공하여 개발자가 디버깅하고 CI에서 궤적을 검증하며, 호스팅된 서비스 없이도 수정된 증거를 공유할 수 있도록 한다.

작동 방식

에이전트 실행을 로컬 JSONL 파일로 캡처한다. 실행 트리 형태로 이러한 추적 정보를 CLI를 통해 시각화할 수 있으며, 중첩된 단계, 도구 호출, LLM 메타데이터를 포함한다. 개발자는 "추적 계약"(정적 규칙)을 정의하여 에이전트가 올바른 궤적을 따랐는지 확인할 수 있다(예: 특정 도구가 호출되었는지 확인). 이러한 추적 정보는 수정하여 포터블하고 해시 검증 가능한 증거 자산으로 패키징하여 공유할 수 있다.

대상 사용자

LangChain, LangGraph, AI SDK, OpenAI Agents JS와 같은 프레임워크를 사용하여 AI 에이전트를 개발하는 TypeScript 개발자들, 그리고 사용자 정의 에이전트 워크플로우를 사용하는 개발자들.

주요 기능

• 로컬 우선: 계정, 수집기, 기본 업로드가 필요 없음; 추적 정보는 개발자의 머신에 유지됨.
• 정적 궤적 검사: 특정 도구 호출 또는 완료 상태에 따라 CI 빌드를 실패시킬 수 있음.
• 증거 패키징: PR 또는 사고 보고서용 수정된 오프라인 자산 생성 가능.
• 광범위한 통합: 여러 TypeScript AI 프레임워크와 OpenInference/OTLP JSON과 같은 표준 형식을 지원.
• MCP 서버: Cursor와 같은 MCP 클라이언트가 로컬 증거에 접근할 수 있도록 선택적 지원 제공.