tool( )

Pattern

HIL Needs Approval

Demonstrate tool approval with async generators. Includes real-time feedback, approval workflows, and interactive management.

IntermediateOct 2025View the full pattern on desktop
HIL Needs Approval preview

Problems solved

  • Pause Experimental_Agent tool calls until the user approves
  • Handle approval denial gracefully in agent instructions
  • Visualize pending and completed tool execution states
  • Stream approval UI updates during the agent loop

Use cases

  • Sensitive tool actions that need sign-off
  • Admin agents gating writes and deletes
  • Customer-support agents requiring human approval
  • Educational demos of needsApproval agent flows

AI SDK APIs

new Agenttool(stepCountIsExperimental_Agenttools:gatewayUIToolInvocationInferAgentUIMessageToolLoopAgentaddToolApprovalResponseuseChatvalidateUIMessages

Tags

aiagentstool-approvalasync-generatorapproval-patternsai-sdk-v5streamingreal-time-feedbacktool-executionworkflow-management

Requirements

Node.js
24+
Memory
512MB
Other
  • Google AI API key

Environment variables

External services

google-aiupstash

Ready to use?

View the full interactive pattern with live preview and copy the source code.

View the pattern on desktop

Related patterns

HIL Tool Approval BasicChat assistant with human approval workflows for safe tool execution.Oct 2025
Multi-Step Tool PatternExecute multi-step workflows with typed tools. Includes streaming, tool chaining, and decision-making for automated tasks.Oct 2025
Orchestrator-Worker PatternCoordinate multiple worker agents for project management. Handles task distribution, progress tracking, and result synthesis.Oct 2025
Evaluator-Optimizer PatternImprove output quality with dual agents. Evaluator analyzes quality while optimizer refines results through iterative feedback.Oct 2025