Visão Geral de Triggers

Os triggers da CrewAI AMP conectam suas automações a eventos em tempo real nas ferramentas que sua equipe já usa. Em vez de fazer polling ou depender de execuções manuais, os triggers escutam mudanças — novos e‑mails, atualizações de calendário, alterações no CRM — e iniciam imediatamente a crew ou flow que você definiu.

Playbooks de Integração

Os guias abaixo explicam, em detalhe, como habilitar e testar cada integração:

Trigger do Gmail

Dispare crews quando novos e‑mails chegarem ou threads forem atualizadas.

Trigger do Google Calendar

Reaja a eventos de calendário criados, atualizados ou cancelados.

Trigger do Google Drive

Monitore uploads, edições e exclusões de arquivos no Drive.

Trigger do Outlook

Automatize respostas a novos e‑mails ou eventos removidos no Outlook.

Trigger do OneDrive

Audite atividade e compartilhamentos de arquivos no OneDrive.

Trigger do Microsoft Teams

Inicie workflows quando novos chats forem criados no Teams.

Trigger do HubSpot

Execute automações a partir de workflows e eventos de ciclo de vida no HubSpot.

Trigger do Salesforce

Conecte processos do Salesforce às suas crews para automação de CRM.

Trigger do Slack

Dispare crews diretamente de comandos slash no Slack.

Trigger do Zapier

Integre a CrewAI com milhares de apps suportados pelo Zapier.

Capacidades dos Triggers

Com triggers você pode:

• Responder em tempo real – Executar workflows automaticamente quando condições forem atendidas
• Integrar com sistemas externos – Conectar Gmail, Outlook, OneDrive, JIRA, Slack, Stripe e muito mais
• Escalar automações – Lidar com alto volume de eventos sem intervenção manual
• Manter contexto – Acessar dados do trigger dentro das suas crews e flows

Gerenciando Triggers

Visualizando Triggers Disponíveis

1. Abra sua automação no painel da CrewAI
2. Clique na aba Triggers para listar todas as integrações disponíveis

Habilitando e Desabilitando

Cada trigger possui uma chave de ativação:

• Habilitado (azul) – Executa a automação quando o evento ocorrer
• Desabilitado (cinza) – Ignora eventos

As alterações são aplicadas imediatamente.

Monitorando Execuções

Use a lista de execuções para acompanhar histórico, status e payloads:

Construindo Automações Orientadas por Trigger

Checklist de Configuração

Antes de ativar em produção, confirme que você:

• Conectou a integração em Tools & Integrations e concluiu OAuth ou configuração de API
• Habilitou o trigger na automação correta
• Definiu variáveis de ambiente necessárias (tokens, IDs de tenant, segredos)
• Criou tarefas que analisam o payload no primeiro passo da crew/flow
• Decidiu se usará allow_crewai_trigger_context para injetar contexto automaticamente
• Configurou monitoramento (webhooks, históricos da CrewAI, alertas externos)

Testando Triggers Localmente com CLI

A CLI da CrewAI fornece comandos poderosos para ajudá-lo a desenvolver e testar automações orientadas por triggers sem fazer deploy para produção.

Listar Triggers Disponíveis

Visualize todos os triggers disponíveis para suas integrações conectadas:

crewai triggers list

Este comando exibe todos os triggers disponíveis baseados nas suas integrações conectadas, mostrando:

• Nome da integração e status de conexão
• Tipos de triggers disponíveis
• Nomes e descrições dos triggers

Simular Execução de Trigger

Teste sua crew com payloads realistas de triggers antes do deployment:

crewai triggers run <nome_do_trigger>

Por exemplo:

crewai triggers run microsoft_onedrive/file_changed

Este comando:

• Executa sua crew localmente
• Passa um payload de trigger completo e realista
• Simula exatamente como sua crew será chamada em produção

Warning

Notas Importantes de Desenvolvimento:

• Use crewai triggers run <trigger> para simular execução de trigger durante o desenvolvimento
• Usar crewai run NÃO simulará chamadas de trigger e não passará o payload do trigger
• Após o deployment, sua crew será executada com o payload real do trigger
• Se sua crew espera parâmetros que não estão no payload do trigger, a execução pode falhar

Triggers com Crews

Suas definições de crew funcionam naturalmente com triggers; basta ter uma tarefa que processe o payload recebido:

@CrewBase
class MinhaCrewAutomatizada:
    @agent
    def pesquisador(self) -> Agent:
        return Agent(
            config=self.agents_config['pesquisador'],
        )

    @task
    def analisar_payload_trigger(self) -> Task:
        return Task(
            config=self.tasks_config['analisar_payload_trigger'],
            agent=self.pesquisador(),
        )

    @task
    def analisar_conteudo_trigger(self) -> Task:
        return Task(
            config=self.tasks_config['analisar_dados_trigger'],
            agent=self.pesquisador(),
        )

Integração com Flows

Flows oferecem controle adicional sobre o uso do payload:

Acessando o Payload

Todos os métodos @start() podem receber crewai_trigger_payload:

from crewai.flow import Flow, start, listen

class MeuFlowAutomatizado(Flow):
    @start()
    def lidar_com_trigger(self, crewai_trigger_payload: dict = None):
        if crewai_trigger_payload:
            trigger_id = crewai_trigger_payload.get('id')
            dados_evento = crewai_trigger_payload.get('payload', {})
            self.state.trigger_id = trigger_id
            self.state.trigger_type = dados_evento
            return dados_evento
        return None

    @listen(lidar_com_trigger)
    def processar_dados(self, dados_trigger):
        # ... processa o trigger

Acionando Crews a partir de Flows

@start()
def delegar_para_crew(self, crewai_trigger_payload: dict = None):
    crew = MinhaCrewEspecializada()
    resultado = crew.crew().kickoff(
        inputs={
            'parametro_personalizado': "valor_personalizado",
            'crewai_trigger_payload': crewai_trigger_payload
        },
    )
    return resultado

Solução de Problemas

Trigger não dispara:

• Verifique se o trigger está habilitado na aba Triggers do seu deployment
• Confira o status da conexão em Tools & Integrations
• Garanta que todas as variáveis de ambiente necessárias estão configuradas

Falhas de execução:

• Consulte os logs de execução para detalhes do erro
• Use crewai triggers run <nome_do_trigger> para testar localmente e ver a estrutura exata do payload
• Verifique se sua crew pode processar o parâmetro crewai_trigger_payload
• Garanta que sua crew não espera parâmetros que não estão incluídos no payload do trigger

Problemas de desenvolvimento:

• Sempre teste com crewai triggers run <trigger> antes de fazer deploy para ver o payload completo
• Lembre-se que crewai run NÃO simula chamadas de trigger—use crewai triggers run em vez disso
• Use crewai triggers list para verificar quais triggers estão disponíveis para suas integrações conectadas
• Após o deployment, sua crew receberá o payload real do trigger, então teste minuciosamente localmente primeiro

Os triggers transformam suas implantações CrewAI em sistemas orientados por eventos, integrando-se perfeitamente aos processos e ferramentas já usados pelo seu time.