LangSmith Studio로 로컬 개발하기

LangSmith Studio로 로컬 개발하기

mda dev와 LangSmith Studio로 Managed Deep Agent를 로컬에서 실행하고 테스트할 수 있어요.

mda dev는 Managed Deep Agents 프로젝트를 컴파일하고 로컬 Agent Server에서 실행합니다. 배포 전에 에이전트와 상호작용하고 동작을 검사할 수 있도록 LangSmith Studio를 엽니다.

Managed Deep Agents는 공개 베타 상태이며 LangSmith Cloud의 미국 지역에서만 사용할 수 있어요.

출처: 문서

본문

로컬 Studio 시작하기 (Start local Studio)

프로젝트 의존성을 설치하고 .env에 모델 공급자 자격증명을 추가하세요.

프로젝트 루트에서 다음을 실행합니다:

npx mda dev

pnpm exec mda dev

bunx mda dev

CLI는 로컬 서버와 Studio URL을 출력하고 브라우저에서 Studio를 엽니다. Studio에서 메시지를 보내 모델 응답, 도구 호출, 상태, 인터럽트를 검사하세요.

프로젝트 파일을 변경한 후에는 mda dev를 중지하고 다시 실행해 프로젝트를 다시 컴파일하세요.

mda dev가 하는 일 (What mda dev does)

mda dev는:

  1. 프로젝트를 검증하고 .mda/build로 컴파일합니다.
  2. 프로젝트 .env를 로컬 빌드에 복사하고 필요할 때 로컬 전용 아이덴티티 구성을 추가합니다.
  3. 지시사항, 스킬, 메모리를 위한 로컬 Context Hub 모의를 생성합니다.
  4. 언어별 LangGraph 개발 서버를 시작합니다.
  5. Studio에서 에이전트를 엽니다.

로컬 개발은 호스팅 배포를 만들거나 업데이트하지 않습니다.

로컬 서버 구성하기 (Configure the local server)

플래그 (Flag) 용도 (Use)
--port PORT 로컬 서버 포트를 설정.
--hostname HOSTNAME 서버가 수신할 호스트네임을 설정.
--no-browser Studio를 자동으로 열지 않고 서버를 시작.
--no-reload LangGraph 개발 서버의 핫 리로드를 비활성화.

모든 명령 세부정보는 mda dev CLI 참조를 참고하세요.

로컬 동작 이해하기 (Understand local behavior)

mda dev는 테스트를 쉽게 하기 위해 로컬 기본값을 사용합니다:

  • 에이전트가 아이덴티티를 사용하면 Studio가 자동으로 로컬 테스트 사용자를 제공합니다.
  • 구성된 샌드박스를 사용할 수 없으면 에이전트가 대신 임시 로컬 폴더를 사용합니다. CLI가 폴더 경로를 출력합니다.

이 기본값은 배포된 에이전트와 다릅니다. 프로덕션에서 에이전트를 사용하기 전에 개발 배포에서 아이덴티티와 샌드박스 동작을 테스트하세요.

더 알아보기 (Learn more)