메인 콘텐츠로 건너뛰기
Crew 또는 Flow가 더 큰 저장소 안에 있을 때 작업 디렉터리를 사용하세요. CrewAI AMP는 저장소 루트 대신 해당 하위 폴더에서 자동화를 검증, 빌드, 실행합니다.

​
사용 시점

모노레포 배포는 하나의 저장소에 여러 자동화, 공유 패키지 또는 다른 애플리케이션 코드가 함께 있을 때 유용합니다: 
company-ai/
|-- uv.lock
|-- packages/
|   `-- shared_tools/
`-- crews/
    |-- support_agent/
    |   |-- pyproject.toml
    |   `-- src/
    |       `-- support_agent/
    |           |-- main.py
    |           `-- crew.py
    `-- research_flow/
        |-- pyproject.toml
        `-- src/
            `-- research_flow/
                `-- main.py
support_agent를 배포하려면 작업 디렉터리를 다음과 같이 설정합니다: 
crews/support_agent
AMP는 여전히 전체 저장소를 가져오거나 업로드하지만, 선택한 폴더를 자동화 프로젝트 루트로 처리합니다.

​
작업 디렉터리가 제어하는 항목

작업 디렉터리가 설정되면 AMP는 해당 폴더를 다음 용도로 사용합니다:
  • pyproject.toml, src/, Crew 또는 Flow 진입점을 포함한 프로젝트 검증
  • uv를 사용한 종속성 설치
  • 실행 중인 프로세스의 작업 디렉터리
  • CREW_ROOT_DIR 환경 변수
필드를 비워 두면 기존 동작이 유지되며 저장소 루트를 사용합니다.

​
지원되는 소스

다음 소스에서 배포를 만들 때 작업 디렉터리를 설정할 수 있습니다:
  • 연결된 GitHub 저장소
  • AMP에 구성된 Git 저장소
  • ZIP 업로드
작업 디렉터리는 AMP 웹 인터페이스에서 구성하세요. crewai deploy create CLI 흐름은 이 필드를 묻지 않습니다.
기존 배포의 Settings 페이지에서도 작업 디렉터리를 추가하거나 변경할 수 있습니다. 변경 사항은 다음 배포부터 적용됩니다.
작업 디렉터리와 auto-deploy는 함께 사용할 수 없습니다. 배포에 작업 디렉터리가 설정되어 있으면 해당 배포의 auto-deploy가 비활성화됩니다. 작업 디렉터리를 설정하기 전에 auto-deploy를 끄세요.

​
새 배포 구성

1

Deploy from Code 열기

CrewAI AMP에서 새 배포를 만들고 소스를 선택합니다: GitHub, Git Repository 또는 ZIP 업로드.
2

저장소, 브랜치 또는 ZIP 파일 선택

모노레포가 들어 있는 저장소와 브랜치를 선택하거나, 루트에 모노레포 내용이 포함된 ZIP 파일을 업로드합니다.
3

고급 설정 열기

배포 양식에서 Advanced 섹션을 펼칩니다.
4

작업 디렉터리 입력

저장소 루트에서 Crew 또는 Flow 프로젝트까지의 경로를 입력합니다:
crews/support_agent
앞에 슬래시를 붙이지 마세요.
5

배포

필요한 환경 변수를 추가한 다음 배포를 시작합니다.

​
기존 배포 구성

1

배포 설정 열기

AMP에서 자동화로 이동한 뒤 Settings를 엽니다.
2

필요한 경우 auto-deploy 끄기

auto-deploy가 활성화되어 있으면 먼저 끄세요. auto-deploy가 켜져 있는 동안에는 작업 디렉터리 필드를 사용할 수 없습니다.
3

작업 디렉터리 설정

Basic settings에서 다음과 같은 하위 폴더 경로를 입력합니다:
crews/support_agent
4

다시 배포

설정을 저장하고 자동화를 다시 배포합니다. 새 작업 디렉터리는 다음 배포부터 사용됩니다.

​
경로 규칙

작업 디렉터리는 저장소 또는 ZIP 루트 안의 상대 경로여야 합니다.
규칙예시
상대 경로를 사용합니다crews/support_agent
/로 시작하지 않습니다/crews/support_agent는 유효하지 않습니다
. 또는 .. 경로 세그먼트를 사용하지 않습니다crews/../support_agent는 유효하지 않습니다
문자, 숫자, 하이픈, 밑줄, 점, 슬래시만 사용합니다crews/support agent는 유효하지 않습니다
경로는 255자 이하로 유지합니다더 긴 경로는 거부됩니다
AMP는 앞뒤 공백을 제거하고, 반복된 슬래시를 하나로 줄이며, 끝의 슬래시를 제거합니다. 빈 값은 저장소 루트를 사용합니다.

​
Lock 파일과 UV 워크스페이스

선택한 폴더에는 자동화의 pyproject.toml과 src/ 디렉터리가 있어야 합니다. uv.lock 또는 poetry.lock 파일은 선택한 폴더나 저장소 루트에 둘 수 있습니다. 이 방식은 일반적인 두 가지 모노레포 레이아웃을 모두 지원합니다: 
company-ai/
`-- crews/
    `-- support_agent/
        |-- pyproject.toml
        |-- uv.lock
        `-- src/
            `-- support_agent/
                `-- main.py
자동화가 모노레포의 다른 위치에 있는 공유 패키지를 가져온다면, UV workspace, path 또는 source 설정을 사용해 해당 패키지를 pyproject.toml에 선언하세요. AMP는 선택한 폴더에서 자동화를 실행하므로, 저장소 루트가 Python path에 있다고 가정하기보다 공유 코드를 종속성으로 설치해야 합니다.

​
문제 해결

​
작업 디렉터리를 찾을 수 없음

경로가 저장소 또는 ZIP 루트를 기준으로 한 상대 경로인지 확인하세요. ZIP 업로드의 경우 ZIP 내용에 입력한 작업 디렉터리 경로가 정확히 포함되어야 합니다.

​
pyproject.toml 누락

작업 디렉터리는 여러 프로젝트를 담은 상위 폴더가 아니라 Crew 또는 Flow 프로젝트 폴더를 가리켜야 합니다.

​
uv.lock 또는 poetry.lock 누락

선택한 프로젝트 폴더 또는 저장소 루트에 lock 파일을 커밋하세요. UV 워크스페이스의 경우 uv.lock을 워크스페이스 루트에 두는 방식이 지원됩니다.

​
Auto-Deploy를 사용할 수 없음

작업 디렉터리가 설정되어 있으면 auto-deploy가 비활성화됩니다. 수동 재배포를 사용하거나 AMP API로 CI/CD에서 재배포를 트리거하세요.

AMP에 배포하기

모노레포 작업 디렉터리를 선택한 뒤 배포 가이드를 계속 진행하세요.