mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-01-08 23:58:34 +00:00
1a1bb0ca3d
* docs(cli): document device-code login and config reset guidance; renumber sections * docs(cli): fix duplicate numbering (renumber Login/API Keys/Configuration sections) * docs: Fix webhook documentation to include meta dict in all webhook payloads - Add note explaining that meta objects from kickoff requests are included in all webhook payloads - Update webhook examples to show proper payload structure including meta field - Fix webhook examples to match actual API implementation - Apply changes to English, Korean, and Portuguese documentation Resolves the documentation gap where meta dict passing to webhooks was not documented despite being implemented in the API. * WIP: CrewAI docs theme, changelog, GEO, localization * docs(cli): fix merge markers; ensure mode: "wide"; convert ASCII tables to Markdown (en/pt-BR/ko) * docs: add group icons across locales; split Automation/Integrations; update tools overviews and links
79 lines
3.5 KiB
Plaintext
79 lines
3.5 KiB
Plaintext
---
|
|
title: "Workflows Human-in-the-Loop (HITL)"
|
|
description: "Aprenda como implementar workflows Human-in-the-Loop na CrewAI para aprimorar a tomada de decisões"
|
|
icon: "user-check"
|
|
mode: "wide"
|
|
---
|
|
|
|
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
|
|
|
|
<Steps>
|
|
<Step title="Configure sua Tarefa">
|
|
Configure sua tarefa com a entrada humana habilitada:
|
|
<Frame>
|
|
<img src="/images/enterprise/crew-human-input.png" alt="Entrada Humana Crew" />
|
|
</Frame>
|
|
</Step>
|
|
|
|
<Step title="Forneça a URL do Webhook">
|
|
Ao iniciar seu crew, inclua uma URL de webhook para entrada humana:
|
|
<Frame>
|
|
<img src="/images/enterprise/crew-webhook-url.png" alt="URL do Webhook Crew" />
|
|
</Frame>
|
|
</Step>
|
|
|
|
<Step title="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
|
|
</Step>
|
|
|
|
<Step title="Revise o Resultado da Tarefa">
|
|
O sistema irá pausar no estado `Pending Human Input`. Revise cuidadosamente o resultado 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="Endpoint de Retomada Crew" />
|
|
</Frame>
|
|
<Warning>
|
|
**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.
|
|
</Warning>
|
|
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.
|
|
</Step>
|
|
<Step title="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.
|
|
</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-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 |