Skip to main content
Tool Calling, 상태 관리, API 서빙을 포함한 AI Agent 개발 환경입니다.

문서 기준

  • 기준일: 2026-02-23
  • Python: 3.12
  • 운영체제: macOS, Ubuntu, Windows
  • 동기화 명령: uv sync

호환성 메모

이 환경은 PyTorch를 포함하지 않습니다. LLM 추론은 OpenAI API 등 외부 서비스를 통해 수행하며, 로컬 모델이 필요하면 vllm-serving 환경과 조합합니다.

Agent 개발에서 패키지 역할

pyproject.toml

설치

1

프로젝트 생성

2

의존성 락 및 동기화

3

Jupyter 커널 등록

설치 확인

기본 사용 예시

LangGraph를 이용한 Tool Calling Agent 기본 구조입니다.

MCP 서버 연동 참고

Agent에서 외부 MCP 서버를 호출할 때는 httpx를 사용합니다.
LangSmith 추적을 활성화하려면 환경변수 LANGCHAIN_TRACING_V2=trueLANGCHAIN_API_KEY를 설정합니다. 트레이스는 smith.langchain.com에서 확인할 수 있습니다.

트러블슈팅

설치 점검 목록

  • 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
  • 설치 후 버전 확인 명령어(--version)를 실행해 정상 설치를 검증했습니다.
  • PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
  • 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

관련 문서

Setup 홈

운영체제별 설치 흐름을 다시 확인합니다.

다음: llm-finetune

다음 설치 단계를 이어서 진행합니다.