Pular para o conteúdo principal

​
Assista: Construindo Agents e Flows CrewAI com Coding Agent Skills

Instale nossas coding agent skills (Claude Code, Codex, …) para colocar seus agentes de código para funcionar rapidamente com o CrewAI. Você pode instalar com npx skills add crewaiinc/skills

​
Tutorial em Vídeo

Assista a este tutorial em vídeo para uma demonstração passo a passo do processo de instalação:

​
Tutorial em Texto

Requisitos de Versão do PythonCrewAI requer Python >=3.10 e <3.14. Veja como verificar sua versão:
Se você precisar atualizar o Python, acesse python.org/downloads
CrewAI utiliza o uv como ferramenta de gerenciamento de dependências e pacotes. Ele simplifica a configuração e execução do projeto, oferecendo uma experiência fluida. Se você ainda não instalou o uv, siga o passo 1 para instalá-lo rapidamente em seu sistema, caso contrário, avance para o passo 2.
1

Instale o uv

  • No macOS/Linux: Use curl para baixar o script e executá-lo com sh:
    Se seu sistema não possuir curl, você pode usar wget:
  • No Windows: Use irm para baixar o script e iex para executá-lo:
    Caso enfrente algum problema, consulte o guia de instalação do UV para mais informações.
2

Instale o CrewAI 🚀

  • Execute o seguinte comando para instalar o CLI do crewai:
    Se aparecer um aviso relacionado ao PATH, execute este comando para atualizar seu shell:
    Se você encontrar o erro de build ao instalar chroma-hnswlib==0.7.6 (fatal error C1083: Cannot open include file: 'float.h') no Windows, instale o (Visual Studio Build Tools)[https://visualstudio.microsoft.com/downloads/] com o Desenvolvimento de Desktop com C++.
  • Para verificar se o crewai está instalado, execute:
  • Você deverá ver algo assim:
  • Caso precise atualizar o crewai, execute:
Instalação realizada com sucesso! Você está pronto para criar seu primeiro crew! 🎉

​
Criando um Projeto CrewAI

crewai create crew agora cria um projeto de crew JSON-first. Os agentes ficam em agents/*.jsonc, as tarefas e configurações da crew ficam em crew.jsonc, e crewai run carrega essa definição JSON diretamente.
1

Gerar Scaffolding do Projeto

  • Execute o comando CLI do crewai:
  • Isso criará um novo projeto com a seguinte estrutura:
  • Se você precisar do scaffold antigo em Python/YAML com crew.py, config/agents.yaml e config/tasks.yaml, execute:
2

Personalize Seu Projeto

  • Seu projeto conterá estes arquivos essenciais:
  • Comece editando crew.jsonc e os arquivos em agents/ para definir o comportamento da crew.
  • Use valores {placeholder} nos textos de agentes e tarefas e defina padrões em crew.jsonc dentro de inputs. Ao executar crewai run, a CLI pergunta por valores que estiverem faltando.
  • Mantenha informações sensíveis como chaves de API no arquivo .env.
3

Execute seu Crew

  • Antes de rodar seu crew, execute:
  • Se precisar instalar pacotes adicionais, utilize:
  • Para rodar seu crew, execute o seguinte comando na raiz do seu projeto:

​
Opções de Instalação Enterprise

Para equipes e organizações, o CrewAI oferece opções de implantação corporativa que eliminam a complexidade da configuração:

​
CrewAI AMP (SaaS)

  • Zero instalação necessária - basta se cadastrar gratuitamente em app.crewai.com
  • Atualizações e manutenção automáticas
  • Infraestrutura e escalabilidade gerenciadas
  • Construa crews sem código

​
CrewAI Factory (Auto-Hospedado)

  • Implantação containerizada para sua infraestrutura
  • Compatível com qualquer hyperscaler, incluindo ambientes on-premises
  • Integração com seus sistemas de segurança existentes

Explore as Opções Enterprise

Saiba mais sobre as soluções enterprise do CrewAI e agende uma demonstração

​
Próximos Passos

Início rápido: Flow + agente

Siga o guia rápido para gerar um Flow, executar um crew com um agente e produzir um relatório.

Junte-se à Comunidade

Conecte-se com outros desenvolvedores, obtenha ajuda e compartilhe suas experiências com o CrewAI.