Struct ExplicitHandoffPolicy 

pub struct ExplicitHandoffPolicy { /* private fields */ }

Explicit handoff policy - generates a handoff tool for specific target agent. The LLM can call this tool to explicitly handoff to the target agent.

Implementations

impl ExplicitHandoffPolicy

pub fn new(target_agent: impl Into<String>) -> Self

Create new explicit handoff policy for target agent.

pub fn with_tool_name(self, name: impl Into<String>) -> Self

Set custom tool name (default: “handoff_to_{target}”)

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

Set custom tool description

Trait Implementations

impl Clone for ExplicitHandoffPolicy

fn clone(&self) -> ExplicitHandoffPolicy

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExplicitHandoffPolicy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<ExplicitHandoffPolicy> for AnyHandoffPolicy

fn from(policy: ExplicitHandoffPolicy) -> Self

Converts to this type from the input type.

impl HandoffPolicy for ExplicitHandoffPolicy

fn handoff_tools(&self) -> Vec<ChatCompletionTool>

Generate handoff tools that the LLM can call. These tools will be injected into the agent’s available tools.

fn handle_handoff_tool( &self, invocation: &ToolInvocation, ) -> Result<HandoffRequest, BoxError>

Handle a handoff tool call by converting it to a HandoffRequest. This is called when the LLM invokes one of the handoff tools.

fn should_handoff( &self, _state: &LoopState, _outcome: &StepOutcome, ) -> Option<HandoffRequest>

Make runtime handoff decisions based on agent state and step outcome. This allows for automatic handoffs based on conditions (e.g., no tools called).

fn is_handoff_tool(&self, tool_name: &str) -> bool

Check if a tool call is a handoff tool managed by this policy.

fn transform_on_handoff( &self, messages: Vec<ChatCompletionRequestMessage>, _from_agent: &str, _to_agent: &str, _handoff: &HandoffRequest, ) -> Pin<Box<dyn Future<Output = Result<Vec<ChatCompletionRequestMessage>, BoxError>> + Send>>

Transform messages during handoff.