Managed Deep Agent 배포하기

Managed Deep Agent 배포하기

mda CLI로 Managed Deep Agent를 테스트하고 배포할 수 있어요.

Managed Deep Agent를 배포하면 코드 우선 프로젝트를 관리형 LangGraph 앱으로 컴파일하고, 배포 소유 컨텍스트를 Context Hub에 동기화하고, 컴파일된 소스를 업로드하고, LangSmith 호스팅 배포 빌드를 트리거합니다. 결과는 Agent Server 배포이며, Agent Server API와 MCP 엔드포인트를 포함합니다.

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

이 페이지는 비밀 라우팅과 배포 옵션을 다룹니다. 배포 전에 에이전트를 테스트하려면 LangSmith Studio로 로컬 개발을 참고하세요. 명령 플래그, 배포 단계 목록, 문제 해결은 CLI 참조를 참고하세요.

출처: 문서

본문

사전 요구사항 (Prerequisites)

배포하기 전에 다음이 있는지 확인하세요:

  • Managed Deep Agents 공개 베타 접근이 있는 워크스페이스.
  • 해당 워크스페이스의 LangSmith API 키가 .env 또는 셸 환경에 있어야 합니다.
  • managed-deepagents에서 설치된 mda CLI.
  • TypeScript 프로젝트의 경우 npm install로 설치된 프로젝트 의존성.
  • .env, 셸 환경 또는 LangSmith 워크스페이스 비밀에 OPENAI_API_KEY 같은 모델 공급자 자격증명.

CLI는 기본적으로 미국 LangSmith Cloud를 대상으로 합니다.

LangSmith에 배포하기 (Deploy to LangSmith)

로컬 프로젝트를 배포합니다:

npx mda deploy

pnpm exec mda deploy

bunx mda deploy

mda deploy는 로컬 프로젝트 입력을 서로 다른 관리 표면으로 라우팅합니다:

instructions.md + skills/**  -> Context Hub deploy-owned context
.env                         -> deploy auth + non-reserved hosted secrets, not archived
project source files         -> .mda/build source archive -> hosted deployment
schedules/**                 -> LangSmith cron jobs after the deployment is live

디렉터리 이름이 원하는 이름이 아닌 경우 배포 이름을 명시적으로 설정합니다:

npx mda deploy --name research-assistant

pnpm exec mda deploy --name research-assistant

bunx mda deploy --name research-assistant

프로덕션 배포를 만들 때 --deployment-type prod를 사용합니다:

npx mda deploy --deployment-type prod

pnpm exec mda deploy --deployment-type prod

bunx mda deploy --deployment-type prod

완료를 폴링하지 않고 빌드를 트리거하려면 --no-wait를 사용합니다:

npx mda deploy --no-wait

pnpm exec mda deploy --no-wait

bunx mda deploy --no-wait

--no-wait가 설정되면 CLI가 배포가 DEPLOYED에 도달하기 전에 종료되므로 해당 배포 호출에 대해 스케줄 조정이 건너뜁니다.

성공 시 CLI는 LangSmith 배포 대시보드 URL을 출력합니다. 전체 배포 단계 목록은 CLI 참조를 참고하세요.

비밀 및 환경 파일 (Secrets and environment files)

mda deploy는 셸 환경 변수보다 프로젝트 .env 값을 먼저 읽습니다. 배포를 인증하는 LangSmith API 키와 호스팅 배포에 필요한 런타임 비밀에 .env를 사용하세요:

LANGSMITH_API_KEY=<LANGSMITH_API_KEY>
OPENAI_API_KEY=<OPENAI_API_KEY>
GITHUB_MCP_TOKEN=<GITHUB_MCP_TOKEN>
DATABASE_URL=<DATABASE_URL>

LANGSMITH_API_KEY, LANGGRAPH_HOST_API_KEY, LANGCHAIN_API_KEY 및 기타 플랫폼 변수는 예약되어 있습니다. 배포를 인증할 수 있지만 사용자 관리 배포 비밀로 업로드되지는 않습니다.

모델 공급자 키, MCP 토큰, 커스텀 도구 자격증명 같은 예약되지 않은 .env 항목은 mda deploy가 배포를 만들거나 업데이트할 때 호스팅 배포 비밀로 전달됩니다. 구성된 모델에 공급자 키가 필요한 경우, 해당 키가 .env, 셸 환경 또는 LangSmith 워크스페이스 비밀에 없으면 배포가 업로드 전에 실패합니다. 공급자 키가 셸 환경에만 있을 때 mda deploy는 해당 배포의 비밀로 전달합니다.

예약된 플랫폼 변수, 빈 값, .env, .env.* 파일은 컴파일된 빌드 아카이브에 복사되지 않습니다.

인증 키 순서와 예약 변수는 CLI 참조를 참고하세요.

배포 문제 해결 (Troubleshoot a deploy)

배포 문제 해결은 CLI 참조를 참고하세요.

배포가 BUILD_FAILED 또는 DEPLOY_FAILED에 도달하면 LangSmith에서 출력된 배포 URL을 열고 개정 로그를 검사하세요.

다음 단계 (Next steps)

  • Agent Server — 배포를 호스팅하는 런타임을 살펴보세요.
  • MCP 엔드포인트 — 배포된 에이전트를 MCP 클라이언트에 도구로 노출하세요.
  • 아이덴티티 — 호출자를 인증하고 비공개 스레드를 제공하세요.
  • 스케줄 — 관리형 cron 스케줄로 에이전트를 실행하세요.
  • 커스텀 도구 — 에이전트 정의에 LangChain 도구를 추가하세요.
  • CLI 참조 — 모든 mda 명령과 플래그를 찾아보세요.

더 알아보기 (Learn more)