Back to catalog / Agent workflows
Pause an agent workflow to ask for missing user information
Emit a structured input request when a workflow lacks a decision or field, then continue after the user responds.
Goal
Have the agent ask explicitly for required information instead of guessing and proceeding.
Steps
- Define missing fields that require clarification and the allowed answer range. [request]
- Yield
RequestInput(...)from an async workflow node; do not use unvalidated free text as control state. [request] - Have the client present the request, validate the reply, and construct the resume input. [request]
- Confirm resume continues at the waiting node and completed nodes do not run again. [workflow]
How to verify
Missing information pauses the workflow and shows a question; valid replies resume and invalid ones remain rejected.
Troubleshooting
If work repeats after resume, inspect session events and workflow resume behavior; do not rerun every node in the client.
Permissions
Prerequisites
- Python 3.11+, google-adk compatible with the pinned revision, and an isolated test environment
- Configured model-provider credentials for live inference; never place them in code or logs
Permissions
- Use authorized test data only; isolate sessions and credentials per user; obtain human authorization before external side effects
Limitations
This procedure follows Google ADK at the pinned revision; other versions, models, or remote services may differ in APIs and event semantics. Recheck permissions, retention, and recovery before production.
Pinned upstream source
- Repository
- google/adk-python
- File path
- docs/guides/events/request_input/index.md
- Pinned commit
e9b74d36140f2594b24c481fb7a3825b2cb01e96- Source checked
- 2026-10-14 · Reviewed against the pinned upstream source
Repository metrics
These values describe the upstream repository, not popularity or likes for an individual skill or playbook.
- Stars
- Not collected
- Forks
- Not collected
- Observed at
- Not collected
No metrics snapshot is available yet.
License: Apache-2.0
Main topic
Turn ecommerce campaign materials into a reviewable weekly brief