> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Human In The Loop

> Browse agent examples for confirmation, user input, external execution, and approval-backed HITL.

| Example | Description |
| - | - |
| [Agentic User Input](https://agno-v2.mintlify.site/examples/agents/human-in-the-loop/agentic-user-input.md) | Let the agent request missing fields at runtime with UserControlFlowTools, then continue the run. |
| [Confirmation Advanced](https://agno-v2.mintlify.site/examples/agents/human-in-the-loop/confirmation-advanced.md) | Confirm or reject tool calls across a custom HackerNews tool and WikipediaTools in one run. |
| [Confirmation Required](https://agno-v2.mintlify.site/examples/agents/human-in-the-loop/confirmation-required.md) | Gate a custom HackerNews tool behind requires\_confirmation and resume the paused run with agent.continue\_run(). |
| [Confirmation Required MCP Toolkit](https://agno-v2.mintlify.site/examples/agents/human-in-the-loop/confirmation-required-mcp-toolkit.md) | Require confirmation for an MCP server tool and resume an async streamed run after approval. |
| [Confirmation Toolkit](https://agno-v2.mintlify.site/examples/agents/human-in-the-loop/confirmation-toolkit.md) | Gate a toolkit's web\_search tool behind user confirmation with requires\_confirmation\_tools. |
| [External Tool Execution](https://agno-v2.mintlify.site/examples/agents/human-in-the-loop/external-tool-execution.md) | Pause the run for a shell tool marked external\_execution, execute it yourself, and continue with the result. |
| [User Input Required](https://agno-v2.mintlify.site/examples/agents/human-in-the-loop/user-input-required.md) | Mark a tool with requires\_user\_input so the run pauses to collect the to\_address field. |
| [Approval Async](https://agno-v2.mintlify.site/examples/agents/approvals/approval-async.md) | Async approval-backed HITL: @approval with async agent run. |
| [Approval Basic](https://agno-v2.mintlify.site/examples/agents/approvals/approval-basic.md) | Approval-backed HITL: @approval + `@tool(requires_confirmation=True)` with persistent DB record. |
| [Approval External Execution](https://agno-v2.mintlify.site/examples/agents/approvals/approval-external-execution.md) | Approval + external execution HITL: @approval + `@tool(external_execution=True)`. |
| [Approval List And Resolve](https://agno-v2.mintlify.site/examples/agents/approvals/approval-list-and-resolve.md) | Full approval lifecycle: pause, list, filter, resolve, delete. |
| [Approval Team](https://agno-v2.mintlify.site/examples/agents/approvals/approval-team.md) | Team-level approval: member agent tool with @approval. |
| [Approval User Input](https://agno-v2.mintlify.site/examples/agents/approvals/approval-user-input.md) | Approval + user input HITL: @approval + `@tool(requires_user_input=True)`. |
| [Audit Approval Async](https://agno-v2.mintlify.site/examples/agents/approvals/audit-approval-async.md) | Async audit approval: `@approval(type="audit")` + `@tool(requires_confirmation=True)` with async. |
| [Audit Approval Confirmation](https://agno-v2.mintlify.site/examples/agents/approvals/audit-approval-confirmation.md) | Audit approval with confirmation: `@approval(type="audit")` + `@tool(requires_confirmation=True)`. |
| [Audit Approval External](https://agno-v2.mintlify.site/examples/agents/approvals/audit-approval-external.md) | Audit approval with external execution: `@approval(type="audit")` + `@tool(external_execution=True)`. |
| [Audit Approval Overview](https://agno-v2.mintlify.site/examples/agents/approvals/audit-approval-overview.md) | Compare pre-execution @approval records with audit-type approvals logged after the tool runs in SQLite. |
| [Audit Approval User Input](https://agno-v2.mintlify.site/examples/agents/approvals/audit-approval-user-input.md) | Audit approval with user input: `@approval(type="audit")` + `@tool(requires_user_input=True)`. |
| [Confirmation with Session State](https://agno-v2.mintlify.site/examples/agents/human-in-the-loop/confirmation-with-session-state.md) | HITL confirmation where the tool modifies session\_state before pausing. |
| [Mixed External and Regular Tools](https://agno-v2.mintlify.site/examples/agents/human-in-the-loop/mixed-external-and-regular-tools.md) | Combine a regular tool with an external\_execution tool; the agent auto-runs one and pauses for the other. |
| [User Feedback (Structured Questions)](https://agno-v2.mintlify.site/examples/agents/human-in-the-loop/user-feedback.md) | Pause a trip-planning agent with UserFeedbackTools and collect answers to multiple-choice questions. |
| [Approval Post Hook](https://agno-v2.mintlify.site/examples/agents/approvals/approval-post-hook.md) | Demonstrates the post-hook reading the resolved approval record from run\_output.metadata\["approval"] after a paused run resumes via DB resolution. |
| [Deterministic approval flow for a side-effecting tool](https://agno-v2.mintlify.site/examples/agents/human-in-the-loop/side-effecting-tool-approval.md) | This example uses a local mock model, so it runs without provider credentials. |
| [Place persistent approval tools on a team leader or member](https://agno-v2.mintlify.site/examples/agent-os/human-in-the-loop/team-approval.md) | AgentOS propagates approval pauses differently depending on where the tool lives. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.