Pular para o conteúdo principal
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:

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
Lista de triggers disponíveis

Habilitando e Desabilitando

Cada trigger possui uma chave de ativação:
Alternância de trigger habilitado
  • 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:
Lista de execuções acionadas por triggers

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