Pular para o conteúdo principal
Human-in-the-Loop (HITL) é uma abordagem poderosa que combina a inteligência artificial com a experiência humana para aprimorar a tomada de decisões e melhorar os resultados das tarefas. Este guia mostra como implementar HITL dentro da CrewAI.

​
Configurando Workflows HITL

1

Configure sua Tarefa

Configure sua tarefa com a entrada humana habilitada:
Entrada Humana Crew
2

Forneça a URL do Webhook

Ao iniciar seu crew, inclua uma URL de webhook para entrada humana:
URL do Webhook Crew
3

Receba Notificação do Webhook

Assim que o crew concluir a tarefa que requer entrada humana, você receberá uma notificação de webhook contendo:
  • Execution ID
  • Task ID
  • Task output
4

Revise o Resultado da Tarefa

O sistema irá pausar no estado Pending Human Input. Revise cuidadosamente o resultado da tarefa.
5

Envie o Feedback Humano

Chame o endpoint de retomada do seu crew com as seguintes informações:
Endpoint de Retomada Crew
Crítico: URLs de Webhook Devem Ser Fornecidas Novamente: Você deve fornecer as mesmas URLs de webhook (taskWebhookUrl, stepWebhookUrl, crewWebhookUrl) na chamada de resume que você usou na chamada de kickoff. As configurações de webhook NÃO são automaticamente transferidas do kickoff - elas devem ser explicitamente incluídas na solicitação de resume para continuar recebendo notificações de conclusão de tarefa, etapas do agente e conclusão do crew.
Exemplo de chamada resume com webhooks:
curl -X POST {BASE_URL}/resume \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "execution_id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
    "task_id": "research_task",
    "human_feedback": "Ótimo trabalho! Por favor, adicione mais detalhes.",
    "is_approve": true,
    "taskWebhookUrl": "https://your-server.com/webhooks/task",
    "stepWebhookUrl": "https://your-server.com/webhooks/step",
    "crewWebhookUrl": "https://your-server.com/webhooks/crew"
  }'
Impacto do Feedback na Execução da Tarefa: É fundamental ter cuidado ao fornecer feedback, pois todo o conteúdo do feedback será incorporado como contexto adicional para execuções futuras da tarefa.
Isso significa:
  • Todas as informações do seu feedback passam a fazer parte do contexto da tarefa.
  • Detalhes irrelevantes podem influenciar negativamente.
  • Feedback conciso e relevante ajuda a manter o foco e a eficiência da tarefa.
  • Sempre revise seu feedback cuidadosamente antes de enviar para garantir que contenha apenas informações pertinentes que irão guiar positivamente a execução da tarefa.
6

Lidar com Feedback Negativo

Se você fornecer um feedback negativo:
  • O crew irá tentar novamente a tarefa com o contexto adicionado do seu feedback.
  • Você receberá outra notificação de webhook para nova revisão.
  • Repita os passos 4-6 até ficar satisfeito.
7

Continuação da Execução

Quando você enviar um feedback positivo, a execução prosseguirá para as próximas etapas.

​
Melhores Práticas

  • Seja Específico: Forneça feedback claro e acionável que trate diretamente da tarefa em questão
  • Mantenha-se Relevante: Inclua apenas informações que ajudem a melhorar a execução da tarefa
  • Seja Ágil: Responda rapidamente às solicitações HITL para evitar atrasos no fluxo
  • Reveja Cuidadosamente: Verifique seu feedback antes de enviar para garantir a precisão

​
Casos de Uso Comuns

Workflows HITL são particularmente valiosos para:
  • Garantia de qualidade e validação
  • Cenários de tomada de decisão complexa
  • Operações sensíveis ou de alto risco
  • Tarefas criativas que requerem julgamento humano
  • Revisões de conformidade e regulamentação
⌘I