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