User Control Flow

UserControlFlowTools enable agents to pause execution and request input from users during conversations.

Example

The following agent can request user input during conversations:

from agno.agent import Agent
from agno.tools.user_control_flow import UserControlFlowTools

agent = Agent(
    instructions=[
        "You are an interactive assistant that can ask users for input when needed",
        "Use user input requests to gather specific information or clarify requirements",
        "Always explain why you need the user input and how it will be used",
        "Provide clear prompts and instructions for user responses",
    ],
    tools=[UserControlFlowTools()],
)

agent.print_response("Help me create a personalized workout plan", stream=True)

Toolkit Params

Parameter	Type	Default	Description
instructions	Optional[str]	None	Custom instructions for user interaction behavior.
add_instructions	bool	True	Whether to add instructions to the agent.
enable_get_user_input	bool	True	Enable user input request functionality.

Toolkit Functions

Function	Description
get_user_input	Pause agent execution and request input from the user.

Developer Resources

• View Tools Source
• Agno Interactive Agents
• User Input Patterns