Pular para o conteúdo principal
Use um diretório de trabalho quando seu Crew ou Flow estiver dentro de um repositório maior. O CrewAI AMP valida, faz o build e executa a automação a partir dessa subpasta em vez da raiz do repositório.

​
Quando Usar

Implantações em monorepo são úteis quando um repositório contém múltiplas automações, pacotes compartilhados ou outro código de aplicação:
Para implantar support_agent, defina o diretório de trabalho como:
O AMP ainda baixa ou recebe o repositório inteiro, mas trata a pasta selecionada como a raiz do projeto da automação.

​
O Que o Diretório de Trabalho Controla

Quando um diretório de trabalho é definido, o AMP usa essa pasta para:
  • Validação do projeto, incluindo pyproject.toml, arquivos de crew JSON e qualquer ponto de entrada clássico de Crew ou Flow
  • Instalação de dependências com uv
  • O diretório de trabalho do processo em execução
  • A variável de ambiente CREW_ROOT_DIR
Deixar o campo vazio mantém o comportamento existente e usa a raiz do repositório.

​
Fontes Suportadas

Você pode definir um diretório de trabalho ao criar uma implantação a partir de:
  • Um repositório GitHub conectado
  • Um repositório Git configurado no AMP
  • Um upload de ZIP
Configure diretórios de trabalho na interface web do AMP. O fluxo crewai deploy create da CLI não solicita esse campo.
Você também pode adicionar ou alterar o diretório de trabalho de uma implantação existente pela página Settings da implantação. A alteração passa a valer no próximo deploy.
Diretórios de trabalho e auto-deploy não podem ser usados juntos. Se uma implantação tiver um diretório de trabalho, o auto-deploy fica desabilitado para ela. Desative o auto-deploy antes de definir um diretório de trabalho.

​
Configurar uma Nova Implantação

1

Abra Deploy from Code

No CrewAI AMP, crie uma nova implantação e escolha sua fonte: GitHub, Git Repository ou upload de ZIP.
2

Selecione o repositório, branch ou arquivo ZIP

Escolha o repositório e a branch que contêm seu monorepo, ou envie um ZIP cuja raiz contenha os arquivos do monorepo.
3

Abra as configurações avançadas

Expanda a seção Advanced no formulário de deploy.
4

Informe o diretório de trabalho

Informe o caminho da raiz do repositório até o projeto Crew ou Flow:
Não inclua uma barra inicial.
5

Implante

Adicione as variáveis de ambiente necessárias e inicie a implantação.

​
Configurar uma Implantação Existente

1

Abra as configurações da implantação

Acesse sua automação no AMP e abra Settings.
2

Desative o auto-deploy, se necessário

Se o auto-deploy estiver habilitado, desative-o primeiro. O campo de diretório de trabalho fica indisponível enquanto o auto-deploy está ativo.
3

Defina o diretório de trabalho

Em Basic settings, informe o caminho da subpasta, como:
4

Reimplante

Salve a configuração e reimplante a automação. O novo diretório de trabalho será usado no próximo deploy.

​
Regras de Caminho

O diretório de trabalho deve ser um caminho relativo dentro da raiz do repositório ou do ZIP. O AMP remove espaços em branco no início e no fim, reduz barras repetidas e remove barras finais. Um valor em branco usa a raiz do repositório.

​
Arquivos Lock e Workspaces UV

A pasta selecionada deve conter o pyproject.toml e os arquivos exigidos pelo tipo de projeto:
  • Crew JSON-first: crew.jsonc ou crew.json, além de agents/
  • Crew clássico ou Flow: src/ com o ponto de entrada Python esperado
Um arquivo uv.lock ou poetry.lock pode ficar na pasta selecionada ou na raiz do repositório. Isso oferece suporte aos dois layouts comuns de arquivo lock:
Se sua automação importar pacotes compartilhados de outro lugar do monorepo, declare esses pacotes no pyproject.toml usando configuração de workspace, caminho ou source do UV. O AMP executa a automação a partir da pasta selecionada, então o código compartilhado deve ser instalado como dependência em vez de depender da raiz do repositório no Python path.

​
Solução de Problemas

​
Diretório de Trabalho Não Encontrado

Verifique se o caminho é relativo à raiz do repositório ou do ZIP. Para uploads de ZIP, o conteúdo do ZIP deve incluir exatamente o caminho informado como diretório de trabalho.

​
pyproject.toml Ausente

O diretório de trabalho deve apontar para a pasta do projeto Crew ou Flow, não apenas para uma pasta pai que contém vários projetos.

​
uv.lock ou poetry.lock Ausente

Faça commit de um arquivo lock na pasta do projeto selecionada ou na raiz do repositório. Para workspaces UV, manter uv.lock na raiz do workspace é suportado.

​
Auto-Deploy Indisponível

O auto-deploy fica desabilitado enquanto um diretório de trabalho está definido. Use reimplantações manuais ou acione reimplantações a partir de CI/CD com a API do AMP.

Deploy para AMP

Continue com o guia de implantação depois de escolher o diretório de trabalho do monorepo.