Human in the Loop

O bloco Human in the Loop pausa a execução do workflow e aguarda intervenção humana antes de continuar. Use-o para adicionar portões de aprovação, coletar feedback ou reunir input adicional em pontos críticos de decisão.

Quando a execução chega a este bloco, o workflow pausa indefinidamente até que um humano forneça input através do portal de aprovação, API ou webhook.

Opções de Configuração

Paused Output

Define quais dados são exibidos para o aprovador. Este é o contexto mostrado no portal de aprovação para ajudá-los a tomar uma decisão informada.

Use o construtor visual ou editor JSON para estruturar os dados. Referencie variáveis do workflow usando a sintaxe <blockName.output>.

{
  "customerName": "<agent1.content.name>",
  "proposedAction": "<router1.selectedPath>",
  "confidenceScore": "<evaluator1.score>",
  "generatedEmail": "<agent2.content>"
}

Notificação

Configura como os aprovadores são alertados quando a aprovação é necessária. Os canais suportados incluem:

• Slack - Mensagens para canais ou DMs
• Gmail - Email com link de aprovação
• Microsoft Teams - Notificações no canal da equipe
• SMS - Alertas por texto via Twilio
• Webhooks - Sistemas de notificação personalizados

Inclua a URL de aprovação (<blockId.url>) nas suas mensagens de notificação para que os aprovadores possam acessar o portal.

Resume Input

Define os campos que os aprovadores preenchem ao responder. Esses dados ficam disponíveis para blocos posteriores após o workflow retomar.

{
  "approved": {
    "type": "boolean",
    "description": "Approve or reject this request"
  },
  "comments": {
    "type": "string",
    "description": "Optional feedback or explanation"
  }
}

Acesse os dados de retomada em blocos posteriores usando <blockId.resumeInput.fieldName>.

Métodos de Aprovação

POST /api/workflows/{workflowId}/executions/{executionId}/resume/{blockId}

{
  "approved": true,
  "comments": "Tudo certo para prosseguir"
}

Casos de Uso Comuns

Aprovação de Conteúdo - Revisa conteúdo gerado por IA antes de publicar

Agent → Human in the Loop → API (Publicar)

Aprovações Multi-Etapa - Encadeia múltiplas etapas de aprovação para decisões de alto risco

Agent → Human in the Loop (Gerente) → Human in the Loop (Diretor) → Executar

Validação de Dados - Verifica dados extraídos antes do processamento

Agent (Extrair) → Human in the Loop (Validar) → Function (Processar)

Controle de Qualidade - Revisa outputs de IA antes de enviar aos clientes

Agent (Gerar) → Human in the Loop (QA) → Gmail (Enviar)

Outputs do Bloco

url - URL única para o portal de aprovação resumeInput.* - Todos os campos definidos em Resume Input ficam disponíveis após o workflow retomar

Acesse usando <blockId.resumeInput.fieldName>.

Exemplo

Saída Pausada:

{
  "title": "<agent1.content.title>",
  "body": "<agent1.content.body>",
  "qualityScore": "<evaluator1.score>"
}

Entrada de Retomada:

{
  "approved": { "type": "boolean" },
  "feedback": { "type": "string" }
}

Uso Posterior:

// Bloco de Condição
<approval1.resumeInput.approved> === true

O exemplo abaixo mostra um portal de aprovação como visto por um aprovador após o workflow ser pausado. Os aprovadores podem revisar os dados e fornecer inputs como parte da retomada do workflow. O portal de aprovação pode ser acessado diretamente via URL única, <blockId.url>.

Blocos Relacionados

• Condition - Ramifica com base em decisões de aprovação
• Variables - Armazena histórico de aprovações e metadados
• Response - Retorna resultados do workflow para chamadores da API