mirror of
https://github.com/crewAIInc/crewAI.git
synced 2025-12-16 04:18:35 +00:00
102 lines
4.8 KiB
Plaintext
102 lines
4.8 KiB
Plaintext
---
|
|
title: "Workflows HITL"
|
|
description: "Aprenda como implementar workflows Human-In-The-Loop no CrewAI para decisões aprimoradas"
|
|
icon: "user-check"
|
|
mode: "wide"
|
|
---
|
|
|
|
Human-In-The-Loop (HITL) é uma abordagem poderosa que combina inteligência artificial com expertise humana para aprimorar a tomada de decisão e melhorar os resultados das tarefas. Este guia mostra como implementar HITL dentro do CrewAI.
|
|
|
|
## Configurando Workflows HITL
|
|
|
|
<Steps>
|
|
<Step title="Configure Sua Tarefa">
|
|
Configure sua tarefa com a entrada humana habilitada:
|
|
<Frame>
|
|
<img src="/images/enterprise/crew-human-input.png" alt="Crew Human Input" />
|
|
</Frame>
|
|
</Step>
|
|
|
|
<Step title="Forneça o URL do Webhook">
|
|
Ao iniciar seu crew, inclua um URL de webhook para entrada humana:
|
|
<Frame>
|
|
<img src="/images/enterprise/crew-webhook-url.png" alt="Crew Webhook URL" />
|
|
</Frame>
|
|
</Step>
|
|
|
|
<Step title="Receba a Notificação do Webhook">
|
|
Assim que o crew concluir a tarefa que requer entrada humana, você receberá uma notificação do webhook contendo:
|
|
- **ID de Execução**
|
|
- **ID da Tarefa**
|
|
- **Saída da Tarefa**
|
|
</Step>
|
|
|
|
<Step title="Revise a Saída da Tarefa">
|
|
O sistema irá pausar no estado `Pending Human Input`. Revise cuidadosamente a saída da tarefa.
|
|
</Step>
|
|
|
|
<Step title="Envie o Feedback Humano">
|
|
Chame o endpoint de retomada do seu crew com as seguintes informações:
|
|
<Frame>
|
|
<img src="/images/enterprise/crew-resume-endpoint.png" alt="Crew Resume Endpoint" />
|
|
</Frame>
|
|
|
|
<Warning>
|
|
**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.
|
|
</Warning>
|
|
|
|
Exemplo de chamada resume com webhooks:
|
|
```bash
|
|
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"
|
|
}'
|
|
```
|
|
|
|
<Warning>
|
|
**Impacto do Feedback na Execução da Tarefa**:
|
|
É crucial ter cuidado ao fornecer o feedback, pois todo o conteúdo do feedback será incorporado como contexto adicional para as próximas execuções da tarefa.
|
|
</Warning>
|
|
Isso significa:
|
|
- Todas as informações do seu feedback passam a fazer parte do contexto da tarefa.
|
|
- Detalhes irrelevantes podem prejudicar a execução.
|
|
- Feedbacks concisos e relevantes ajudam a manter o foco e a eficiência da tarefa.
|
|
- Sempre revise atentamente seu feedback antes de enviá-lo para garantir que ele contém apenas informações pertinentes que irão guiar positivamente a execução da tarefa.
|
|
</Step>
|
|
<Step title="Lide com Feedback Negativo">
|
|
Se você fornecer um feedback negativo:
|
|
- O crew irá tentar executar novamente a tarefa com o contexto adicional do seu feedback.
|
|
- Você receberá uma nova notificação de webhook para nova revisão.
|
|
- Repita os passos 4-6 até estar satisfeito.
|
|
</Step>
|
|
|
|
<Step title="Continuação da Execução">
|
|
Quando você enviar um feedback positivo, a execução prosseguirá para as próximas etapas.
|
|
</Step>
|
|
</Steps>
|
|
|
|
## Melhores Práticas
|
|
|
|
- **Seja Específico**: Forneça feedback claro e acionável que trate diretamente da tarefa em questão
|
|
- **Mantenha a Relevância**: Inclua apenas informações que possam ajudar a melhorar a execução da tarefa
|
|
- **Seja Ágil**: Responda rapidamente aos prompts HITL para evitar atrasos no workflow
|
|
- **Revise Cuidadosamente**: Verifique duas vezes o seu feedback antes de enviá-lo para garantir 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 exigem julgamento humano
|
|
- Revisões de conformidade e regulatórias
|