이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.
TL;DR
Cursor 에이전트의 모든 작업 단계를 LangSmith로 추적하기 위해 플러그인 설치 및 환경 변수 설정 과정을 다룬다. TRACE_TO_LANGSMITH, LANGSMITH_CURSOR_API_KEY, LANGSMITH_CURSOR_PROJECT 세 가지 환경 변수를 설정하여 에이전트의 프롬프트, 응답, 도구 호출, 토큰 사용량 등을 LangSmith로 전송한다. 이를 통해 Cursor, Claude Code, Codex 등 다양한 에이전트의 작업 흐름을 동일한 구조로 시각화하고 비교 분석할 수 있다.
챕터별 상세
What this walkthrough covers
Cursor 에이전트의 작업 단계를 LangSmith로 추적하는 전체 과정을 다룬다. 설정 완료 후 모든 에이전트 턴이 LangSmith에서 상세 추적 데이터로 확인되는 것을 목표로 한다.
What you need before you start
시작에 필요한 준비물을 확인한다. Cursor, Node.js, 그리고 LangSmith API Key가 필요하다. Cursor의 훅은 Node.js 모듈을 사용하여 로컬 데이터베이스에서 데이터를 추출한다.
Installing the LangSmith plugin in Cursor
Cursor 설정 메뉴에서 플러그인을 설치한다. Plugins 섹션으로 이동하여 LangSmith 추적 플러그인의 리포지토리 URL을 입력하고 추가한다.
Confirming the install and restarting Cursor
설치를 확인하고 Cursor를 재시작한다. 플러그인이 정상적으로 추가되었는지 확인한 후, 변경 사항을 적용하기 위해 에디터를 다시 실행한다.
Setting your environment variables
쉘 설정 파일에 환경 변수를 추가한다. TRACE_TO_LANGSMITH, LANGSMITH_CURSOR_API_KEY, LANGSMITH_CURSOR_PROJECT 세 가지 변수를 설정하여 추적 활성화, 인증, 프로젝트 식별을 수행한다.
The three variables that power tracing
설정한 환경 변수의 역할을 상세히 확인한다. TRACE_TO_LANGSMITH는 추적을 켜고, API 키는 인증을 담당하며, 프로젝트 이름은 추적 데이터가 저장될 위치를 지정한다.
bash
export TRACE_TO_LANGSMITH="true"
export LANGSMITH_CURSOR_API_KEY="your-langsmith-api-key"
export LANGSMITH_CURSOR_PROJECT="cursor"추적 기능을 활성화하고 인증 및 프로젝트 정보를 설정하는 환경 변수 예시
Confirming the hook is live
추적 기능이 정상 작동하는지 확인한다. tail -f ~/.cursor/langsmith-hook.log 명령어를 실행하여 로그 파일에 추적 데이터가 실시간으로 기록되는지 확인한다.
bash
tail -f ~/.cursor/langsmith-hook.log설정된 추적 기능의 정상 작동 여부를 확인하기 위해 로그 파일을 실시간으로 모니터링하는 명령어
Running a Cursor agent task
실제 에이전트 작업을 수행하여 추적 데이터를 생성한다. Cursor 에이전트에게 GitHub 트렌딩 리포지토리를 요약하라는 작업을 요청한다.
Opening the trace in LangSmith
생성된 추적 데이터를 LangSmith에서 확인한다. Cursor 프로젝트 내에서 각 에이전트 턴이 개별 추적으로 기록된 것을 볼 수 있다.
How each trace is structured
추적 데이터의 구조를 분석한다. 모델 실행, 입력/출력, 토큰 사용량, 그리고 실행된 도구 호출이 계층적으로 구조화되어 있음을 확인한다.
How attachments show up in traces
파일이나 이미지 첨부 파일이 어떻게 표시되는지 확인한다. Cursor의 로컬 데이터베이스가 첨부 파일을 유지하며, 플러그인이 이를 복구하여 사용자 메시지에 렌더링한다.
Comparing Cursor, Claude Code, and Codex traces
다양한 에이전트의 추적 데이터를 비교한다. Cursor, Claude Code, Codex의 추적 데이터가 공통적인 구조를 공유하므로 LangSmith 내에서 통합적으로 분석 가능하다.
용어 해설
- 추적(Tracing)
- — 시스템 실행 과정에서 발생하는 입력, 출력, 중간 단계의 호출 정보를 기록하여 디버깅 및 성능 분석을 수행하는 기술이다. 에이전트의 작업 흐름을 시각화하고 병목 구간을 파악하는 데 필수적이다.
- 환경 변수(Environment Variables)
- — 프로세스가 실행되는 환경을 정의하는 동적 값으로, API 키나 설정 플래그 등을 프로그램에 전달하는 데 사용된다. 본문에서는 추적 활성화와 인증 정보를 설정하는 데 활용된다.
- 에이전트(Agent)
- — LLM을 기반으로 도구 사용, 계획 수립, 코드 실행 등을 자율적으로 수행하는 시스템이다. 사용자의 요청을 처리하기 위해 여러 단계의 추론과 도구 호출을 반복한다.
AI 분석 전체 내용 보기
AI 요약 · 북마크 · 개인 피드 설정 — 무료
출처 · 인용 안내
원문 발행 2026. 07. 22.수집 2026. 07. 22.출처 타입 YOUTUBE
인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.
