strands.experimental.steering.core.action
SteeringAction types for steering evaluation results.
Defines structured outcomes from steering handlers that determine how agent actions should be handled. SteeringActions enable modular prompting by providing just-in-time feedback rather than front-loading all instructions in monolithic prompts.
Flow: SteeringHandler.steer_*() → SteeringAction → Event handling ↓ ↓ ↓ Evaluate context Action type Execution modified
SteeringAction types: Proceed: Allow execution to continue without intervention Guide: Provide contextual guidance to redirect the agent Interrupt: Pause execution for human input
Extensibility: New action types can be added to the union. Always handle the default case in pattern matching to maintain backward compatibility.
Proceed
Section titled “Proceed”class Proceed(BaseModel)Defined in: src/strands/experimental/steering/core/action.py:27
Allow execution to continue without intervention.
The action proceeds as planned. The reason provides context for logging and debugging purposes.
class Guide(BaseModel)Defined in: src/strands/experimental/steering/core/action.py:38
Provide contextual guidance to redirect the agent.
The agent receives the reason as contextual feedback to help guide its behavior. The specific handling depends on the steering context (e.g., tool call vs. model response).
Interrupt
Section titled “Interrupt”class Interrupt(BaseModel)Defined in: src/strands/experimental/steering/core/action.py:50
Pause execution for human input via interrupt system.
Execution is paused and human input is requested through Strands’ interrupt system. The human can approve or deny the operation, and their decision determines whether execution continues or is cancelled.
ToolSteeringAction
Section titled “ToolSteeringAction”Steering actions valid for tool steering (steer_before_tool).
- Proceed: Allow tool execution to continue
- Guide: Cancel tool and provide feedback for alternative approaches
- Interrupt: Pause for human input before tool execution
ModelSteeringAction
Section titled “ModelSteeringAction”Steering actions valid for model steering (steer_after_model).
- Proceed: Accept model response without modification
- Guide: Discard model response and retry with guidance