A partir da versão 0.140.0, a plataforma CrewAI Enterprise iniciou um processo de migração de seu provedor de login. Como resultado, o fluxo de autenticação via CLI foi atualizado. Usuários que utlizam o Google para fazer login, ou que criaram conta após 3 de julho de 2025 não poderão fazer login com versões anteriores da biblioteca
crewai
.Visão Geral
O CLI do CrewAI fornece um conjunto de comandos para interagir com o CrewAI, permitindo que você crie, treine, execute e gerencie crews & flows.Instalação
Para usar o CLI do CrewAI, certifique-se de que o CrewAI está instalado:Terminal
Uso Básico
A estrutura básica de um comando CLI do CrewAI é:Terminal
Comandos Disponíveis
1. Create
Crie um novo crew ou flow.Terminal
TYPE
: Escolha entre “crew” ou “flow”NAME
: Nome do crew ou flow
Terminal
2. Version
Mostre a versão instalada do CrewAI.Terminal
--tools
: (Opcional) Mostra a versão instalada das ferramentas do CrewAI
Terminal
3. Train
Treine o crew por um número específico de iterações.Terminal
-n, --n_iterations INTEGER
: Número de iterações para treinar o crew (padrão: 5)-f, --filename TEXT
: Caminho para um arquivo customizado para treinamento (padrão: “trained_agents_data.pkl”)
Terminal
4. Replay
Reexecute a execução do crew a partir de uma tarefa específica.Terminal
-t, --task_id TEXT
: Reexecuta o crew a partir deste task ID, incluindo todas as tarefas subsequentes
Terminal
5. Log-tasks-outputs
Recupere as saídas mais recentes das tarefas crew.kickoff() do seu crew.Terminal
6. Reset-memories
Redefine as memórias do crew (longa, curta, de entidades, latest_crew_kickoff_outputs).Terminal
-l, --long
: Redefine a memória de LONGO PRAZO-s, --short
: Redefine a memória de CURTO PRAZO-e, --entities
: Redefine a memória de ENTIDADES-k, --kickoff-outputs
: Redefine as OUTPUTS DA TAREFA KICKOFF MAIS RECENTE-kn, --knowledge
: Redefine o armazenamento de CONHECIMENTO-akn, --agent-knowledge
: Redefine o armazenamento de CONHECIMENTO DOS AGENTES-a, --all
: Redefine TODAS as memórias
Terminal
7. Test
Teste o crew e avalie os resultados.Terminal
-n, --n_iterations INTEGER
: Número de iterações para testar o crew (padrão: 3)-m, --model TEXT
: Modelo LLM para executar os testes no Crew (padrão: “gpt-4o-mini”)
Terminal
8. Run
Execute o crew ou flow.Terminal
A partir da versão 0.103.0, o comando
crewai run
pode ser usado para executar tanto crews padrão quanto flows. Para flows, ele detecta automaticamente o tipo a partir do pyproject.toml e executa o comando apropriado. Este é agora o modo recomendado de executar tanto crews quanto flows.Certifique-se de executar estes comandos a partir do diretório onde seu projeto CrewAI está configurado.
Alguns comandos podem exigir configuração ou ajustes adicionais dentro da estrutura do seu projeto.
9. Chat
A partir da versão0.98.0
, ao rodar o comando crewai chat
, você inicia uma sessão interativa com seu crew. O assistente de IA irá guiá-lo solicitando as entradas necessárias para executar o crew. Uma vez que todas as entradas são fornecidas, o crew executará suas tarefas.
Depois de receber os resultados, você pode continuar interagindo com o assistente para instruções ou perguntas adicionais.
Terminal
Garanta que você execute estes comandos a partir do diretório raiz do seu projeto CrewAI.
IMPORTANTE: Defina a propriedade
chat_llm
no seu arquivo crew.py
para habilitar este comando.10. Deploy
Implemente o crew ou flow no CrewAI Enterprise.-
Autenticação: Você precisa estar autenticado para implementar no CrewAI Enterprise.
Você pode fazer login ou criar uma conta com:
Terminal
-
Criar um deployment: Depois de autenticado, você pode criar um deployment para seu crew ou flow a partir da raiz do seu projeto local.
Terminal
- Lê a configuração do seu projeto local.
- Solicita a confirmação das variáveis de ambiente (como
OPENAI_API_KEY
,SERPER_API_KEY
) encontradas localmente. Elas serão armazenadas de forma segura junto ao deployment na plataforma Enterprise. Verifique se suas chaves sensíveis estão corretamente configuradas localmente (por exemplo, em um arquivo.env
) antes de executar este comando.
11. Gerenciamento de Organização
Gerencie suas organizações no CrewAI Enterprise.Terminal
Comandos:
list
: Liste todas as organizações das quais você faz parte
Terminal
current
: Exibe sua organização ativa atualmente
Terminal
switch
: Mude para uma organização específica
Terminal
Você deve estar autenticado no CrewAI Enterprise para usar estes comandos de gerenciamento de organização.
-
Criar um deployment (continuação):
- Vincula o deployment ao respectivo repositório remoto do GitHub (normalmente detectado automaticamente).
-
Implantar o Crew: Depois de autenticado, você pode implantar seu crew ou flow no CrewAI Enterprise.
Terminal
- Inicia o processo de deployment na plataforma CrewAI Enterprise.
- Após a iniciação bem-sucedida, será exibida a mensagem Deployment created successfully! juntamente com o Nome do Deployment e um Deployment ID (UUID) único.
-
Status do Deployment: Você pode verificar o status do seu deployment com:
Isso retorna o status mais recente do último deployment iniciado (por exemplo,Terminal
Building Images for Crew
,Deploy Enqueued
,Online
). -
Logs do Deployment: Você pode checar os logs do seu deployment com:
Isso faz o streaming dos logs do deployment para seu terminal.Terminal
-
Listar deployments: Você pode listar todos os seus deployments com:
Isto lista todos os seus deployments.Terminal
-
Deletar um deployment: Você pode deletar um deployment com:
Isto exclui o deployment da plataforma CrewAI Enterprise.Terminal
-
Comando de Ajuda: Você pode obter ajuda sobre o CLI com:
Isto exibe a mensagem de ajuda para o CLI CrewAI Deploy.Terminal
11. Chaves de API
Ao executar o comandocrewai create crew
, o CLI primeiro mostrará os 5 provedores de LLM mais comuns e pedirá para você selecionar um.
Após selecionar um provedor de LLM, será solicitado que você informe as chaves de API.
Provedores iniciais de chave de API
Inicialmente, o CLI solicitará as chaves de API para os seguintes serviços:- OpenAI
- Groq
- Anthropic
- Google Gemini
- SambaNova
Outras opções
Se você selecionar a opção 6, será possível escolher de uma lista de provedores suportados pelo LiteLLM. Ao escolher um provedor, o CLI solicitará que você informe o nome da chave e a chave de API. Veja o seguinte link para o nome de chave de cada provedor:12. Gerenciamento de Configuração
Gerencie as configurações do CLI para CrewAI.Terminal
Comandos:
list
: Exibir todos os parâmetros de configuração do CLI
Terminal
set
: Definir um parâmetro de configuração do CLI
Terminal
reset
: Redefinir todos os parâmetros de configuração do CLI para valores padrão
Terminal
Parâmetros de Configuração Disponíveis
enterprise_base_url
: URL base da instância CrewAI Enterpriseoauth2_provider
: Provedor OAuth2 usado para autenticação (ex: workos, okta, auth0)oauth2_audience
: Valor de audiência OAuth2, tipicamente usado para identificar a API ou recurso de destinooauth2_client_id
: ID do cliente OAuth2 emitido pelo provedor, usado durante solicitações de autenticaçãooauth2_domain
: Domínio do provedor OAuth2 (ex: sua-org.auth0.com) usado para emissão de tokens
Exemplos
Exibir configuração atual:Terminal
Parâmetro | Valor | Descrição |
---|---|---|
enterprise_base_url | https://app.crewai.com | URL base da instância CrewAI Enterprise |
org_name | Not set | Nome da organização atualmente ativa |
org_uuid | Not set | UUID da organização atualmente ativa |
oauth2_provider | workos | Provedor OAuth2 (ex.: workos, okta, auth0) |
oauth2_audience | client_01YYY | Audience usada para identificar a API/recurso de destino |
oauth2_client_id | client_01XXX | Client ID OAuth2 emitido pelo provedor (usado na autenticação) |
oauth2_domain | login.crewai.com | Domínio do provedor OAuth2 (ex.: your-org.auth0.com) |
Terminal
Terminal
Terminal
Terminal
As configurações são armazenadas em
~/.config/crewai/settings.json
. Algumas configurações como nome da organização e UUID são somente leitura e gerenciadas através de comandos de autenticação e organização. Configurações relacionadas ao repositório de ferramentas são ocultas e não podem ser definidas diretamente pelo usuário.