Ferramentas & Integrações

Visão geral

Ferramentas & Integrações é o hub central para conectar aplicações de terceiros e gerenciar ferramentas internas que seus agentes podem usar em tempo de execução.

Explorar

Integrações

Aplicativos para Agentes (Integrações)

Conecte aplicações empresariais (por exemplo, Gmail, Google Drive, HubSpot, Slack) via OAuth para habilitar ações de agentes.

Conectar

Clique em Conectar no app desejado e conclua o OAuth.
Configurar

Ajuste escopos, gatilhos e ações disponíveis conforme necessário.
Usar em Agentes

Os serviços conectados ficam disponíveis como ferramentas para seus agentes.

Conectar sua conta

Acesse Integrações
Clique em Conectar no serviço desejado
Conclua o fluxo OAuth e conceda os escopos
Copie seu Token Enterprise em Configurações de Integração

Instalar ferramentas de integração

Para usar as integrações localmente, instale a versão mais recente do pacote crewai-tools.

uv add crewai-tools

Configuração de variável de ambiente

export CREWAI_PLATFORM_INTEGRATION_TOKEN="seu_enterprise_token"

Ou adicione ao seu arquivo .env:

CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token

Exemplo de uso

from crewai import Agent, Task, Crew

# Crie um agente com capacidades do Gmail
email_agent = Agent(
    role="Gerente de Email",
    goal="Gerenciar e organizar comunicações por email",
    backstory="Assistente de IA especializado em gestão de emails",
    apps=['gmail', 'gmail/send_email']  # Usando nome canônico 'gmail'
)

email_task = Task(
    description="Criar e enviar follow-up para [email protected] sobre a atualização do projeto",
    agent=email_agent,
    expected_output="Confirmação de envio do email com sucesso"
)

crew = Crew(agents=[email_agent], tasks=[email_task])
crew.kickoff()

Filtrando ferramentas

from crewai import Agent, Task, Crew

# Crie agente com ações específicas do Gmail apenas
gmail_agent = Agent(
    role="Gerente de Gmail",
    goal="Gerenciar comunicações e notificações no Gmail",
    backstory="Assistente de IA para coordenação de emails",
    apps=['gmail/fetch_emails']  # Usando nome canônico com ação específica
)

notification_task = Task(
    description="Encontrar o email de [email protected]",
    agent=gmail_agent,
    expected_output="Email encontrado de [email protected]"
)

crew = Crew(agents=[gmail_agent], tasks=[notification_task])

Em um crew implantado, você pode especificar quais ações ficam disponíveis em cada integração na página de configurações do serviço.

Implantações com escopo (organizações multiusuário)

Você pode escopar cada integração para um usuário específico (por exemplo, usar a conta Gmail de um usuário).

Use user_bearer_token para escopar a autenticação ao usuário solicitante. Se o usuário não estiver logado, o crew não usará integrações conectadas; caso contrário, usa o token padrão configurado na implantação.

Catálogo

Comunicação & Colaboração

Gmail — Gerenciamento de emails e rascunhos
Slack — Notificações e alertas do workspace
Microsoft — Integração com Office 365 e Teams

Gestão de Projetos

Jira — Rastreamento de issues e projetos
ClickUp — Gestão de tarefas e produtividade
Asana — Coordenação de tarefas de equipe
Notion — Páginas e bancos de dados
Linear — Gestão de bugs e projetos de software
GitHub — Repositórios e issues

CRM

Salesforce — Contas e oportunidades
HubSpot — Pipeline de vendas e contatos
Zendesk — Tickets de suporte

Negócios & Finanças

Stripe — Pagamentos e clientes
Shopify — E‑commerce e produtos

Produtividade & Armazenamento

Google Sheets — Sincronização de planilhas
Google Calendar — Eventos e agenda
Box — Armazenamento de arquivos

…e mais por vir!

Ferramentas Internas

Crie ferramentas localmente, publique no Repositório de Ferramentas da CrewAI AMP e use nos seus agentes.

Criar

Criar uma nova ferramenta localmente. bash crewai tool create your-tool
Publicar

Publicar a ferramenta no Repositório de Ferramentas. bash crewai tool publish
Instalar

Instalar a ferramenta do Repositório de Ferramentas. bash crewai tool install your-tool

Gerenciar:

Nome e descrição
Visibilidade (Privado / Público)
Variáveis de ambiente necessárias
Histórico de versões e downloads
Acesso por equipe e função