Como Configurar Chaves de API de Diferentes IAs no CrewAI

O CrewAI não inclui um modelo de linguagem próprio — é necessário conectar uma API externa (OpenAI, Anthropic, Groq ou Ollama) para que os agentes possam executar tarefas.

Por Que o CrewAI Precisa de API Keys Externas

O CrewAI é um framework de orquestração de agentes de IA — ele gerencia a colaboração entre múltiplos agentes, define tarefas, controla o fluxo de execução e integra ferramentas externas. O que o CrewAI não faz é hospedar ou executar modelos de linguagem: para isso, cada agente precisa de uma conexão com um provedor de LLM externo via API.

Essa arquitetura oferece uma vantagem importante: a liberdade de escolher o modelo mais adequado para cada agente dentro do mesmo projeto. Um agente de pesquisa pode usar o GPT-4o para raciocínio complexo, enquanto um agente de formatação usa o Groq Llama para respostas rápidas e baratas — tudo configurado via variáveis de ambiente no mesmo arquivo .env.

Como Configurar a OpenAI API Key

A OpenAI é o provedor padrão do CrewAI — quando nenhum LLM é especificado explicitamente em um agente, o framework usa automaticamente a chave OPENAI_API_KEY do ambiente. Para obtê-la, acesse platform.openai.com/api-keys, clique em Create new secret key e copie o valor gerado (começa com sk-).

No diretório raiz do projeto CrewAI, crie o arquivo .env e adicione a linha abaixo. Nunca use aspas ao redor do valor da chave no arquivo .env:

OPENAI_API_KEY=sk-proj-sua_chave_aqui

No código Python, carregue o arquivo com python-dotenv antes de instanciar qualquer agente. A biblioteca lê o .env e injeta todas as variáveis no ambiente do processo:

from dotenv import load_dotenv
load_dotenv()  # Executa antes de qualquer import do crewai

Como Configurar o Claude (Anthropic) no CrewAI
A Anthropic fornece acesso ao Claude via API própria.

A API key pode ser obtida em console.anthropic.com e começa com sk-ant-.

Adicione ao arquivo .env:

ANTHROPIC_API_KEY=sk-ant-sua_chave_aqui

Para definir um agente que usa o Claude como LLM, o CrewAI utiliza o formato LiteLLM para especificar o provedor e o modelo. O prefixo anthropic/ indica ao LiteLLM que deve usar a API da Anthropic com o modelo informado:

from crewai import Agent

pesquisador = Agent(
    role="Pesquisador Senior",
    goal="Analisar dados e gerar insights",
    backstory="Especialista em análise de mercado",
    llm="anthropic/claude-3-5-sonnet-20241022",
    verbose=True
)

Como Configurar o Groq (Modelos Llama Rápidos e Gratuitos)
O Groq oferece acesso gratuito e extremamente rápido a modelos Llama, Mixtral e Gemma via API. Para obter a chave, acesse console.groq.com e crie uma API key gratuita.

Adicione ao .env:
GROQ_API_KEY=gsk_sua_chave_aqui
No agente, especifique o modelo via LiteLLM com o prefixo groq/. O modelo llama3-70b-8192 é o mais equilibrado entre capacidade e velocidade na plataforma Groq:

agente_rapido = Agent(
    role="Escritor de Conteúdo",
    goal="Redigir textos rápidos e precisos",
    backstory="Especialista em copywriting",
    llm="groq/llama3-70b-8192"
)

Como Configurar o Ollama (LLM Local Sem Custo)

O Ollama permite rodar modelos de linguagem localmente no computador, eliminando custos de API e garantindo privacidade total dos dados. Após instalar o Ollama e baixar um modelo (ollama pull llama3), configure o agente com o formato ollama/:

agente_local = Agent(
    role="Analista de Dados",
    goal="Processar dados localmente com privacidade",
    backstory="Especialista em dados sensíveis",
    llm="ollama/llama3"
)
Diferentemente dos provedores cloud, o Ollama não requer API key — basta que o serviço esteja rodando localmente na porta padrão http://localhost:11434. O CrewAI detecta automaticamente a URL do Ollama e não exige nenhuma variável de ambiente adicional para a configuração básica.

Como Usar python-dotenv para Gerenciamento Seguro

A biblioteca python-dotenv é a forma padrão e mais segura de gerenciar variáveis de ambiente em projetos Python. Instale com pip install python-dotenv e carregue no início do script principal antes de qualquer inicialização de agentes.

Para projetos com múltiplos ambientes (desenvolvimento, staging, produção), o dotenv suporta arquivos diferentes: .env.development, .env.production. Use load_dotenv(".env.development") para carregar explicitamente o arquivo correspondente ao ambiente de execução.

Dicas de Segurança para API Keys em Produção

Em ambientes de produção, nunca armazene API keys em arquivos .env commitados — use serviços de gestão de secrets como AWS Secrets Manager, Google Secret Manager, HashiCorp Vault ou as variáveis de ambiente do servidor de deploy (Heroku Config Vars, Railway Variables, etc.).

Aplique o princípio de menor privilégio: crie API keys separadas para cada projeto e ambiente, com permissões mínimas necessárias. Em caso de vazamento de uma key, a revogação isolada não compromete outros projetos em produção.

Para aprender a instalar e iniciar o CrewAI do zero, confira o tutorial completo sobre como instalar o CrewAI CLI e iniciar um projeto. Depois de configurar os modelos, o próximo passo é entender como ativar a memória dos agentes no CrewAI para melhorar a continuidade nas conversas.

FAQ — Perguntas Frequentes

É obrigatório ter uma API key da OpenAI para usar o CrewAI?

Não. O CrewAI usa a OpenAI como padrão quando nenhum LLM é especificado, mas é totalmente possível usar apenas Groq, Anthropic ou Ollama sem nunca configurar uma chave da OpenAI.

Basta definir o parâmetro llm em cada agente com o provedor desejado.

Como verificar se a API key está sendo carregada corretamente?

Após chamar load_dotenv(), use import os; print(os.getenv("OPENAI_API_KEY")) para verificar o valor carregado. Se retornar None, o arquivo .env não está no diretório correto ou a variável está com nome errado.

O Groq é realmente gratuito para uso com o CrewAI?

O Groq oferece um tier gratuito generoso para uso da API, com limites de rate por minuto e por dia. Para projetos de aprendizado e prototipagem, o plano gratuito do Groq com o modelo Llama 3 é mais que suficiente e elimina completamente os custos de LLM.

É possível usar modelos diferentes para agentes diferentes no mesmo Crew?

Sim, cada agente pode ter um LLM diferente definido no parâmetro llm. Um crew pode ter o agente pesquisador usando Claude, o escritor usando GPT-4o e o revisor usando Groq — tudo no mesmo arquivo Python, desde que as respectivas API keys estejam configuradas no .env.

Conclusão

Configurar API keys de múltiplos provedores no CrewAI é um processo direto quando seguido com o arquivo .env correto, a biblioteca python-dotenv e o formato LiteLLM para especificar o provedor em cada agente. A flexibilidade de combinar diferentes LLMs por agente é uma das maiores vantagens do framework.

Para projetos reais, a combinação mais econômica é iniciar com Groq para testes rápidos e migrar para GPT-4o ou Claude Sonnet apenas nos agentes que exigem raciocínio mais sofisticado — reduzindo o custo operacional sem comprometer a qualidade do resultado final.