> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humaniq.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Empower your AI agents with human oversight - transform automated workflows into trusted business operations with just one line of code

<img className="block dark:hidden" src="https://mintcdn.com/humaniq/WUR_EHZpbWS2x5si/images/hero-light.svg?fit=max&auto=format&n=WUR_EHZpbWS2x5si&q=85&s=591a780b098ac66e9c15853ac17ceea0" alt="Hero Light" width="700" height="320" data-path="images/hero-light.svg" />

<img className="hidden dark:block" src="https://mintcdn.com/humaniq/WUR_EHZpbWS2x5si/images/hero-dark.svg?fit=max&auto=format&n=WUR_EHZpbWS2x5si&q=85&s=47254cc87b8875555efdaf1726a2fb32" alt="Hero Dark" width="700" height="320" data-path="images/hero-dark.svg" />

# Human Approvals for AI Agents

Transform your AI agents from limited question-answering tools into powerful business automation engines - with just one line of code. Add secure human oversight to critical operations while maintaining full control over your automation workflows.

<CardGroup cols={2}>
  <Card title="TypeScript Quickstart" icon="code" href="/quickstart-typescript">
    Add human approval workflows to your TypeScript/JavaScript agents
  </Card>

  <Card title="Python Quickstart" icon="python" href="/quickstart-python">
    Integrate human approvals into your Python-based agents
  </Card>
</CardGroup>

## Why Human Approvals?

<CardGroup cols={2}>
  <Card title="Build Trust" icon="shield-check">
    Give stakeholders confidence in AI automation with transparent human oversight
  </Card>

  <Card title="Ensure Compliance" icon="clipboard-check">
    Meet regulatory requirements with built-in audit trails and approvals
  </Card>

  <Card title="Reduce Risk" icon="shield-halved">
    Add safety checks to critical operations without sacrificing automation
  </Card>

  <Card title="Scale Safely" icon="arrow-up-right-dots">
    Deploy AI agents for high-stakes tasks with appropriate controls
  </Card>
</CardGroup>

## How It Works

Approvals act as intelligent checkpoints in your AI agent's workflow:

1. **Pause**: AI agent reaches a critical decision point
2. **Present**: System displays context and data to approvers
3. **Verify**: Human reviews and approves/rejects the action
4. **Continue** or **Halt**: Based on human decision

<AccordionGroup>
  <Accordion title="Common Use Cases" icon="lightbulb">
    * Processing financial transactions
    * Sending mass communications
    * Modifying system configurations
    * Accessing sensitive data
    * Executing bulk operations
  </Accordion>

  <Accordion title="Key Features" icon="stars">
    * Synchronous and asynchronous approval flows
    * Conditional auto-approval rules
    * Multi-approver workflows
    * Rich context display
    * Complete audit trails
  </Accordion>
</AccordionGroup>

## Simple Integration

```typescript theme={null}
import { needsHumanApproval } from '@your-org/approvals'

// Add approval requirement to any operation
const sendEmail = needsHumanApproval({
  type: 'sync',
  title: 'Email Campaign',
  ask: (args) => `Approve sending email to ${args.recipientCount} customers?`
})

// Use it in your agent
await sendEmail({
  recipientCount: 1000,
  subject: 'Important Update',
  template: 'newsletter'
})
```

## Why We Built This

Organizations face several challenges when deploying AI agents for critical operations:

<CardGroup cols={2}>
  <Card title="Trust Gap" icon="bridge">
    **Challenge**: Organizations hesitate to give AI agents unrestricted access

    **Solution**: Add transparent human oversight
  </Card>

  <Card title="Compliance Needs" icon="check-double">
    **Challenge**: Many industries require human verification

    **Solution**: Built-in approval workflows and audit trails
  </Card>

  <Card title="Development Overhead" icon="code">
    **Challenge**: Building approval systems is time-consuming

    **Solution**: One-line integration with complete features
  </Card>

  <Card title="Scaling Concerns" icon="chart-line">
    **Challenge**: Managing oversight at scale is complex

    **Solution**: Automated routing and efficient workflows
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Browse Recipes" icon="book" href="/recipes">
    Explore pre-built approval workflows for common scenarios
  </Card>
</CardGroup>