Struct ConditionalAgent 

pub struct ConditionalAgent { /* private fields */ }

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>, ) -> Self

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>) -> Self

Set the agent description.

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

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

pub fn before_callback(self, callback: BeforeAgentCallback) -> Self

Add a before-agent callback.

pub fn after_callback(self, callback: AfterAgentCallback) -> Self

Add an after-agent callback.

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

Set a preloaded skills index for this agent.

pub fn with_auto_skills(self) -> Result<Self>

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

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

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

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

Customize skill selection behavior.

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

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 run<'life0, 'async_trait>( &'life0 self, ctx: Arc<dyn InvocationContext>, ) -> Pin<Box<dyn Future<Output = Result<EventStream>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Executes the agent and returns a stream of events.