O CrewAI Enterprise permite que você automatize seu fluxo de trabalho usando webhooks. Este artigo irá guiá-lo no processo de configuração e uso de webhooks para iniciar a execução do crew, com foco na integração com o ActivePieces, uma plataforma de automação de fluxos de trabalho semelhante ao Zapier e Make.com.

​
Configurando Webhooks

1

Acessando a Interface de Kickoff

  • Navegue até o painel do CrewAI Enterprise
  • Procure pela seção /kickoff, que é usada para iniciar a execução do crew
    Interface Kickoff
2

Configurando o Conteúdo JSON

Na seção de Conteúdo JSON, você deverá fornecer as seguintes informações:
  • inputs: Um objeto JSON contendo:
    • company: O nome da empresa (ex.: “tesla”)
    • product_name: O nome do produto (ex.: “crewai”)
    • form_response: O tipo de resposta (ex.: “financial”)
    • icp_description: Uma breve descrição do Perfil de Cliente Ideal
    • product_description: Uma breve descrição do produto
    • taskWebhookUrl, stepWebhookUrl, crewWebhookUrl: URLs para diversos endpoints de webhook (ActivePieces, Zapier, Make.com ou outra plataforma compatível)
3

Integração com ActivePieces

Neste exemplo usaremos o ActivePieces. Você pode utilizar outras plataformas, como Zapier e Make.com.Para integrar com o ActivePieces:
  1. Crie um novo flow no ActivePieces
  2. Adicione um gatilho (ex.: agendamento Every Day)
    Gatilho ActivePieces
  3. Adicione uma etapa de ação HTTP
    • Configure a ação como Send HTTP request
    • Use o método POST
    • Defina a URL para o endpoint de kickoff do CrewAI Enterprise
    • Adicione os headers necessários (ex.: Bearer Token)
      Headers ActivePieces
    • No corpo, inclua o conteúdo JSON conforme configurado na etapa 2
      Body ActivePieces
    • O crew será iniciado no horário pré-definido.
4

Configurando o Webhook

  1. Crie um novo flow no ActivePieces e nomeie-o
    Flow ActivePieces
  2. Adicione uma etapa de webhook como gatilho:
    • Selecione Catch Webhook como tipo de gatilho
    • Isso irá gerar uma URL única que receberá requisições HTTP e disparará seu flow
      Webhook ActivePieces
    • Configure o e-mail para usar o corpo de texto do webhook do crew
      Email ActivePieces

​
Exemplos de Output do Webhook

Nota: Qualquer objeto meta fornecido na sua requisição de kickoff será incluído em todos os payloads de webhook, permitindo rastrear requisições e manter contexto durante todo o ciclo de vida da execução do crew.
stepWebhookUrl - Callback executado a cada pensamento interno do agente
{
    "action": "**Preliminary Research Report on the Financial Industry for crewai Enterprise Solution**\n1. Industry Overview and Trends\nThe financial industry in ....\nConclusion:\nThe financial industry presents a fertile ground for implementing AI solutions like crewai, particularly in areas such as digital customer engagement, risk management, and regulatory compliance. Further engagement with the lead is recommended to better tailor the crewai solution to their specific needs and scale.",
    "task_id": "97eba64f-958c-40a0-b61c-625fe635a3c0"
}