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:
python3 --version
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: 
    curl -LsSf https://astral.sh/uv/install.sh | sh
    Se seu sistema não possuir curl, você pode usar wget: 
    wget -qO- https://astral.sh/uv/install.sh | sh
  • No Windows: Use irm para baixar o script e iex para executá-lo: 
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    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: 
    uv tool install crewai
    Se aparecer um aviso relacionado ao PATH, execute este comando para atualizar seu shell:
    uv tool update-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: 
    uv tool list
  • Você deverá ver algo assim: 
    crewai v0.102.0
- crewai
  • Caso precise atualizar o crewai, execute: 
    uv tool install crewai --upgrade
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: 
    crewai create crew <your_project_name>
  • Isso criará um novo projeto com a seguinte estrutura: 
    my_project/
├── .gitignore
├── .env
├── agents/
│   └── researcher.jsonc
├── crew.jsonc
├── knowledge/
├── pyproject.toml
├── README.md
├── skills/
└── tools/
  • Se você precisar do scaffold antigo em Python/YAML com crew.py, config/agents.yaml e config/tasks.yaml, execute: 
    crewai create crew <your_project_name> --classic
2

Personalize Seu Projeto

  • Seu projeto conterá estes arquivos essenciais:
    ArquivoFinalidade
    crew.jsoncConfigure a crew, a ordem das tarefas, o processo e os inputs padrão
    agents/*.jsoncDefina o papel, objetivo, backstory, LLM, ferramentas e comportamento de cada agente
    .envArmazene chaves de API e variáveis de ambiente
    tools/Arquivos Python opcionais para ferramentas custom:<name>
    knowledge/Arquivos opcionais de conhecimento para agentes
    skills/Arquivos opcionais de skills aplicadas à crew
  • 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: 
    crewai install
  • Se precisar instalar pacotes adicionais, utilize: 
    uv add <package-name>
  • Para rodar seu crew, execute o seguinte comando na raiz do seu projeto: 
    crewai run

​
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.