Struct ConditionalAgent 

pub struct ConditionalAgent { /* private fields */ }

Available on crate feature agents only.

Rule-based conditional routing agent.

Executes one of two sub-agents based on a synchronous condition function. For LLM-based intelligent routing, use crate::LlmConditionalAgent instead.

Example

// Route based on session state flag
let router = ConditionalAgent::new(
    "premium_router",
    |ctx| ctx.session().state().get("is_premium").map(|v| v.as_bool()).flatten().unwrap_or(false),
    Arc::new(premium_agent),
).with_else(Arc::new(basic_agent));

Implementations

impl ConditionalAgent

pub fn new<F>( name: impl Into<String>, condition: F, if_agent: Arc<dyn Agent>, ) -> ConditionalAgent

where F: Fn(&dyn InvocationContext) -> bool + Send + Sync + 'static,

Create a new conditional agent with a condition function and the if-branch agent.

pub fn with_description(self, desc: impl Into<String>) -> ConditionalAgent

Set the agent description.

pub fn with_else(self, else_agent: Arc<dyn Agent>) -> ConditionalAgent

Set the else-branch agent executed when the condition is false.

pub fn before_callback( self, callback: Box<dyn Fn(Arc<dyn CallbackContext>) -> Pin<Box<dyn Future<Output = Result<Option<Content>, AdkError>> + Send>> + Sync + Send>, ) -> ConditionalAgent

Add a before-agent callback.

pub fn after_callback( self, callback: Box<dyn Fn(Arc<dyn CallbackContext>) -> Pin<Box<dyn Future<Output = Result<Option<Content>, AdkError>> + Send>> + Sync + Send>, ) -> ConditionalAgent

Add an after-agent callback.

pub fn with_skills(self, index: SkillIndex) -> ConditionalAgent

Available on crate feature skills only.

Set a preloaded skills index for this agent.

pub fn with_auto_skills(self) -> Result<ConditionalAgent, AdkError>

Available on crate feature skills only.

Auto-load skills from .skills/ in the current working directory.

pub fn with_skills_from_root( self, root: impl AsRef<Path>, ) -> Result<ConditionalAgent, AdkError>

Available on crate feature skills only.

Auto-load skills from .skills/ under a custom root directory.

pub fn with_skill_policy(self, policy: SelectionPolicy) -> ConditionalAgent

Available on crate feature skills only.

Customize skill selection behavior.

pub fn with_skill_budget(self, max_chars: usize) -> ConditionalAgent

Available on crate feature skills only.

Limit injected skill content length.

Trait Implementations

impl Agent for ConditionalAgent

fn name(&self) -> &str

Returns the unique name of this agent.

fn description(&self) -> &str

Returns a human-readable description of this agent’s purpose.

fn sub_agents(&self) -> &[Arc<dyn Agent>]

Returns the child agents managed by this agent.

fn supports_agent_transfer(&self) -> bool

Whether this agent participates in LLM-driven agent transfer and may be resumed directly across conversation turns.

fn run<'life0, 'async_trait>( &'life0 self, ctx: Arc<dyn InvocationContext>, ) -> Pin<Box<dyn Future<Output = Result<Pin<Box<dyn Stream<Item = Result<Event, AdkError>> + Send>>, AdkError>> + Send + 'async_trait>>

where 'life0: 'async_trait, ConditionalAgent: 'async_trait,

Executes the agent and returns a stream of events.