이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.
TL;DR
Cursor 에이전트의 모든 작업 단계를 LangSmith로 추적하기 위해 플러그인 설치 및 환경 변수 설정 과정을 다룬다. TRACE_TO_LANGSMITH, LANGSMITH_CURSOR_API_KEY, LANGSMITH_CURSOR_PROJECT 세 가지 환경 변수를 설정하여 에이전트의 프롬프트, 응답, 도구 호출, 토큰 사용량 등을 LangSmith로 전송한다. 이를 통해 Cursor, Claude Code, Codex 등 다양한 에이전트의 작업 흐름을 동일한 구조로 시각화하고 비교 분석할 수 있다.
챕터별 상세
00:00
What this walkthrough covers
Cursor 에이전트의 작업 단계를 LangSmith로 추적하는 전체 과정을 다룬다. 설정 완료 후 모든 에이전트 턴이 LangSmith에서 상세 추적 데이터로 확인되는 것을 목표로 한다.
00:13
What you need before you start
시작에 필요한 준비물을 확인한다. Cursor, Node.js, 그리고 LangSmith API Key가 필요하다. Cursor의 훅은 Node.js 모듈을 사용하여 로컬 데이터베이스에서 데이터를 추출한다.
00:25
Installing the LangSmith plugin in Cursor
Cursor 설정 메뉴에서 플러그인을 설치한다. Plugins 섹션으로 이동하여 LangSmith 추적 플러그인의 리포지토리 URL을 입력하고 추가한다.
00:45
Confirming the install and restarting Cursor
설치를 확인하고 Cursor를 재시작한다. 플러그인이 정상적으로 추가되었는지 확인한 후, 변경 사항을 적용하기 위해 에디터를 다시 실행한다.
00:56
Setting your environment variables
쉘 설정 파일에 환경 변수를 추가한다. TRACE_TO_LANGSMITH, LANGSMITH_CURSOR_API_KEY, LANGSMITH_CURSOR_PROJECT 세 가지 변수를 설정하여 추적 활성화, 인증, 프로젝트 식별을 수행한다.
01:04
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"추적 기능을 활성화하고 인증 및 프로젝트 정보를 설정하는 환경 변수 예시
01:24
Confirming the hook is live
추적 기능이 정상 작동하는지 확인한다. tail -f ~/.cursor/langsmith-hook.log 명령어를 실행하여 로그 파일에 추적 데이터가 실시간으로 기록되는지 확인한다.
bash
tail -f ~/.cursor/langsmith-hook.log설정된 추적 기능의 정상 작동 여부를 확인하기 위해 로그 파일을 실시간으로 모니터링하는 명령어
01:31
Running a Cursor agent task
실제 에이전트 작업을 수행하여 추적 데이터를 생성한다. Cursor 에이전트에게 GitHub 트렌딩 리포지토리를 요약하라는 작업을 요청한다.
01:53
Opening the trace in LangSmith
생성된 추적 데이터를 LangSmith에서 확인한다. Cursor 프로젝트 내에서 각 에이전트 턴이 개별 추적으로 기록된 것을 볼 수 있다.
01:59
How each trace is structured
추적 데이터의 구조를 분석한다. 모델 실행, 입력/출력, 토큰 사용량, 그리고 실행된 도구 호출이 계층적으로 구조화되어 있음을 확인한다.
02:21
How attachments show up in traces
파일이나 이미지 첨부 파일이 어떻게 표시되는지 확인한다. Cursor의 로컬 데이터베이스가 첨부 파일을 유지하며, 플러그인이 이를 복구하여 사용자 메시지에 렌더링한다.
02:44
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)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.
