Struct GraphAgent 

pub struct GraphAgent { /* private fields */ }

GraphAgent wraps a CompiledGraph as an ADK Agent

Turns and checkpoints

Each Agent::run call is one turn on a thread whose id is the session id. With a checkpointer configured:

Thread’s latest checkpoint	What the turn does
None	Runs the graph from its entry nodes.
Paused (non-empty frontier)	Resumes the paused run, with the turn’s input merged into its state.
Finished (empty frontier)	Runs the graph again from its entry nodes, starting from the previous turn’s final state with the turn’s input merged on top.

The recursion limit applies to each turn separately. GraphAgent::invoke keeps the direct-graph behaviour, where re-invoking a finished thread returns its final state without running anything.

Implementations

impl GraphAgent

pub fn builder(name: &str) -> GraphAgentBuilder

Create a new GraphAgent builder

pub fn from_graph(name: &str, graph: CompiledGraph) -> Self

Create directly from a compiled graph

pub fn graph(&self) -> &CompiledGraph

Get the underlying compiled graph

pub async fn invoke( &self, input: State, config: ExecutionConfig, ) -> Result<State>

Execute the graph directly (bypassing Agent trait)

pub fn stream( &self, input: State, config: ExecutionConfig, mode: StreamMode, ) -> impl Stream<Item = Result<StreamEvent>> + '_

Stream execution

Trait Implementations

impl Agent for GraphAgent

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 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 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 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.