Human-in-the-Loop Review

Require a person to approve a task's output before the next task consumes it

Require a person to sign off on a task’s output before the next task can read it.

Quick Start

1. Mark a task for review

   Set humanInput: true on the task, then call reviewTaskOutput after the task produces its output.

   import { Task, reviewTaskOutput } from 'praisonai';
   
   const task = new Task({
     description: 'Draft a customer refund reply',
     expected_output: 'A one-paragraph reply',
     humanInput: true,
     humanReviewPrompt: 'Is this legally safe to send?',
   });
   
   const output = '...draft reply...';
   
   const outcome = await reviewTaskOutput(task, output);
   if (!outcome.approved) {
     // Re-run with outcome.reason folded back into the prompt
   }

2. Plug in your own approver

   Pass an approvalManager to route the review through Slack, a webhook, or any UI instead of the built-in terminal prompt.

   import { Task, reviewTaskOutput } from 'praisonai';
   
   const task = new Task({
     description: 'Draft a customer refund reply',
     expected_output: 'A one-paragraph reply',
     humanInput: true,
   });
   
   const output = '...draft reply...';
   
   const outcome = await reviewTaskOutput(task, output, {
     approvalManager: {
       async requestApproval({ toolName, input, reason }) {
         return await askHumanAndReturnTrueOrFalse(reason, input);
       },
     },
     timeout: 300, // seconds — forwarded to the approval manager
   });

How It Works

reviewTaskOutput asks the approval manager to approve the complete output, then returns a verdict.

Approval vs. Human Review vs. Guardrails

Three features gate agent work at different points — pick by what you are protecting.

The approval manager gates a TOOL CALL and guardrails validate automatically; neither let an orchestrator require a person to approve an output before the next task consumes it.

Task Options

Two Task fields turn on review.

reviewTaskOutput Reference

`reviewTaskOutput(task, output, options?) → Promise

`

ReviewOutcome return shape:

A ReviewApprovalManager is any object with a requestApproval that resolves to a boolean:

import { Task, reviewTaskOutput, type ReviewApprovalManager } from 'praisonai';

const manager: ReviewApprovalManager = {
  async requestApproval({ toolName, input, reason, timeout }) {
    // toolName === `task_output:<task name>`
    return await askHuman(reason);
  },
};

const task = new Task({
  description: 'Draft a reply',
  expected_output: 'A one-paragraph reply',
  humanInput: true,
});

const outcome = await reviewTaskOutput(task, '...draft...', { approvalManager: manager });

Best Practices

Related