Struct CustomAgent 

pub struct CustomAgent { /* private fields */ }

An agent with a user-defined async handler function.

CustomAgent allows you to implement arbitrary agent logic without conforming to the LLM request/response loop. Use the builder to configure the handler, sub-agents, and lifecycle callbacks.

Implementations

impl CustomAgent

pub fn builder(name: impl Into<String>) -> CustomAgentBuilder

Create a new builder for CustomAgent with the given name.

Trait Implementations

impl Agent for CustomAgent

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.

fn interaction_mode(&self) -> AgentInteractionMode

Returns the agent’s primary interaction pattern.

fn supports_agent_transfer(&self) -> bool

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

fn capabilities(&self) -> AgentCapabilities

Declares the execution-plane capabilities this agent supports.

fn topology(&self) -> Option<AgentTopology>

Returns portable composition metadata when this agent owns an explicit topology.

fn configure_run(&self, _agent_name: &str, _config: &mut RunConfig)

Applies agent-composition policy to a run before the runtime creates the invocation context for agent_name.

fn transfer_targets_for(&self, _agent_name: &str) -> Option<Vec<String>>

Returns the exact handoff targets allowed for agent_name, when this agent owns an explicit transfer topology.

fn strict_transfer_policy(&self) -> bool

Whether transfer-policy violations should fail the run.

fn govern_transfer<'life0, 'life1, 'async_trait>( &'life0 self, _request: &'life1 AgentTransferRequest, ) -> Pin<Box<dyn Future<Output = Result<AgentTransferDecision, AdkError>> + Send + 'async_trait>>

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

Applies asynchronous policy to an otherwise valid transfer.