Navigation

Mobile Docs

Human Agent

Add a human as an agent in your workflow

Integrates a human operator as a first-class agent in AI workflow orchestration. The human receives tasks via notification channels and provides responses that feed into the workflow.

Agentshuman_agent

Usage

01Add the block to your workflow and connect it to the upstream step.
02Configure any required credentials or tokens in the inputs.
03Fill in required inputs and optional parameters for the run.
04Run a test execution, inspect outputs, and iterate before deploying.
05Deploy the human_agent block with monitoring enabled in production.

Inputs (UI)

Human Agent Profile

short-input

Placeholder: Agent profile ID (optional)

Layout: full

Agent Name

short-input

Placeholder: e.g. Quality Reviewer

Layout: half

Role

short-input

Placeholder: e.g. Senior Editor

Layout: half

Task Description

long-input

Placeholder: Describe what the human agent should do...

Layout: full

Assign To (Email)

short-input

Placeholder: human@company.com

Layout: half

Notification Channels

checkbox-list

Layout: full

Options: In-App, Email, Slack, Discord

Expected Response Format

code

Placeholder: { "decision": "string", "reasoning": "string" }

Layout: full

Timeout (minutes)

short-input

Placeholder: 60

Layout: half

On Timeout

dropdown

Layout: half

Options: Wait indefinitely, Skip (continue), Escalate, Fail

Priority

dropdown

Layout: half

Options: Low, Normal, High, Urgent

Context Data

code

Placeholder: { "key": "value" }

Layout: full

Inputs (API)

agentProfileId

string

Optional

agentName

string

Required

agentRole

string

Optional

taskDescription

string

Required

assignedToEmail

string

Optional

notificationChannels

json

Optional

expectedResponseFormat

json

Optional

timeoutMinutes

number

Optional

onTimeout

string

Optional

priority

string

Optional

contextData

json

Optional

Outputs

Primary response type:

{
  "status": "string",
  "response": "json",
  "responseNote": "string",
  "respondedBy": "string",
  "respondedAt": "string",
  "requestId": "string"
}

Tool Access

hitl_approval