Managed Deep Agents 프로젝트 구조

Managed Deep Agents 프로젝트 구조

Managed Deep Agents의 프로젝트 레이아웃을 이해할 수 있어요.

Managed Deep Agents 프로젝트는 하나의 필수 루트 에이전트 진입점을 가진 일반 TypeScript 패키지입니다. 다른 경로는 가져오는 일반 모듈이거나, MDA가 관리 기능을 활성화하기 위해 발견하는 파일과 디렉터리입니다.

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

출처: 문서

본문

프로젝트 레이아웃 (Project layout)

my-agent/
├── agent.ts | agent.tsx            # Core agent definition

├── instructions.md                 # Managed context
├── skills/
│   └── <name>/
│       └── SKILL.md

├── tools/                          # Application code
│   └── mcp.ts                      # MCP server declaration
├── middleware/

├── channels/                       # Managed configuration
│   └── <name>.ts
├── schedules/
│   └── <name>.ts
├── sandbox/
│   └── index.ts
├── identity.ts
├── memory.ts

├── package.json                    # Dependencies
├── .env                            # Local and deploy secrets

└── evals/                          # Harbor workspace
    ├── harbor-job.json
    └── <task>/                     # Harbor task
        ├── Task.md
        ├── instruction.md
        ├── environment/
        └── tests/

필수 파일은 프로젝트 루트의 agent.ts 또는 agent.tsx뿐이며, 여기에 이름이 agent인 에이전트 정의가 있습니다. defineDeepAgent로 만든 이름이 agent인 것을 내보내야 합니다. 프로젝트에서 하나의 에이전트 진입점만 사용하세요.

위 레이아웃은 일반적인 .ts 이름을 보여줍니다. TypeScript 관리 선언은 지원되는 .tsx, .mts, .cts 변형도 허용합니다.

MDA가 프로젝트 파일을 처리하는 방식 (How MDA treats project files)

  • 관리 컨텍스트 (Managed context): instructions.md는 시스템 프롬프트를 정의합니다. skills/ 아래의 각 디렉터리는 SKILL.md 및 지원 파일 같은 작업별 지시사항을 포함합니다. MDA는 instructions.md와 skills/를 모두 Context Hub에 동기화합니다. 선택적 영구 메모리도 Context Hub에 의해 지원됩니다.

  • 애플리케이션 코드 (Application code): tools/ 및 middleware/ 아래의 파일은 일반 프로젝트 모듈입니다. 에이전트 진입점에서 가져옵니다.

  • 관리 구성 (Managed configuration): 특정 경로가 존재하면 기능을 활성화합니다. channels/ 및 schedules/의 경우 직접 자식만 관리 선언이며, 중첩된 모듈은 아닙니다.

    경로 (Path) 활성화 (Enables)
    identity.ts 호출자 인증
    memory.ts 영구 메모리
    channels/<name>.ts 메시징 채널
    tools/mcp.ts MCP 커넥터
    schedules/<name>.ts Cron 스케줄
    sandbox/index.ts 샌드박스 파일시스템 및 셸

    tools/는 한 가지 예외를 제외하고 일반 모듈을 보유합니다. tools/mcp.ts는 관리 선언이며 이름이 mcp인 것을 내보냅니다. tools/ 아래의 다른 모든 모듈은 가져오는 애플리케이션 코드입니다.

  • 의존성 및 비밀 (Dependencies and secrets): package.json에서 의존성을 선언합니다. MDA는 로컬에서 .env를 로드하고 예약되지 않은 값을 배포 비밀로 전달합니다. 예약된 플랫폼 변수와 .env 파일은 빌드 아카이브에 포함되지 않습니다. 자세한 내용은 Managed Deep Agent 배포를 참고하세요.

  • 평가 (Evals): Managed Deep Agents 평가는 Harbor 평가입니다. mda evals init -i를 실행하고 코딩 에이전트와 eval-engineering 스킬로 작업을 개발합니다. 생성된 런타임 파일은 .mda/evals/에 유지되며 배포된 에이전트 빌드에 포함되지 않습니다.

다음 단계 (Next steps)

  • 퀵스타트 — mda CLI로 첫 번째 Managed Deep Agent를 만들고 배포하세요.
  • 튜토리얼 — 퀵스타트 연구 어시스턴트에 영구 메모리와 일일 스케줄을 추가하세요.

더 알아보기 (Learn more)