Package com.google.adk.agents

Class PlannerAgent

java.lang.Object

com.google.adk.workflow.BaseNode

com.google.adk.agents.BaseAgent

com.google.adk.agents.PlannerAgent

All Implemented Interfaces:

Node

public class PlannerAgent
extends BaseAgent

An agent that delegates execution planning to a Planner strategy.

The PlannerAgent owns a set of sub-agents and a planner. At runtime, the planner inspects session state and decides which sub-agent(s) to run next. This enables dynamic, goal-oriented agent orchestration — the execution topology is determined at runtime rather than being fixed at build time.

The planning loop:

1. Planner is initialized with context and available agents
2. Planner returns what to do next via PlannerAction
3. Selected sub-agent(s) execute, producing events
4. Session state (world state) is updated from events
5. Planner sees updated state and decides the next action
6. Repeat until PlannerAction.Done or maxIterations

Example usage with a custom planner:

 PlannerAgent agent = PlannerAgent.builder()
     .name("myAgent")
     .subAgents(agentA, agentB, agentC)
     .planner(new GoalOrientedPlanner("finalOutput", metadata))
     .maxIterations(20)
     .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	PlannerAgent.Builder	Builder for PlannerAgent.

Method Summary

Modifier and Type	Method	Description
static PlannerAgent.Builder	builder()	Returns a new PlannerAgent.Builder for creating PlannerAgent instances.
int	maxIterations()	Returns the maximum number of planning iterations.
Planner	planner()	Returns the planner strategy used by this agent.
protected io.reactivex.rxjava3.core.Flowable<Event>	runAsyncImpl(InvocationContext invocationContext)	Agent-specific asynchronous logic.
protected io.reactivex.rxjava3.core.Flowable<Event>	runLiveImpl(InvocationContext invocationContext)	Agent-specific synchronous logic.

Methods inherited from class com.google.adk.agents.BaseAgent

afterAgentCallback, beforeAgentCallback, canonicalAfterAgentCallbacks, canonicalBeforeAgentCallbacks, close, findAgent, findSubAgent, fromConfig, parentAgent, parentAgent, rootAgent, runAsync, runLive, runNode, subAgents, toolOrigin

Methods inherited from class com.google.adk.workflow.BaseNode

config, description, inputSchema, name, outputSchema, rerunOnResume, stateSchema, waitForOutput

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.google.adk.workflow.Node

requiresAllPredecessors

Method Details

planner

public Planner planner()

Returns the planner strategy used by this agent.

maxIterations

public int maxIterations()

Returns the maximum number of planning iterations.

runAsyncImpl

protected io.reactivex.rxjava3.core.Flowable<Event> runAsyncImpl(InvocationContext invocationContext)

Description copied from class: BaseAgent

Agent-specific asynchronous logic.

Specified by:

runAsyncImpl in class BaseAgent

Parameters:

invocationContext - Current invocation context.

Returns:

stream of agent-generated events.

runLiveImpl

protected io.reactivex.rxjava3.core.Flowable<Event> runLiveImpl(InvocationContext invocationContext)

Description copied from class: BaseAgent

Agent-specific synchronous logic.

Specified by:

runLiveImpl in class BaseAgent

Parameters:

invocationContext - Current invocation context.

Returns:

stream of agent-generated events.

builder

public static PlannerAgent.Builder builder()

Returns a new PlannerAgent.Builder for creating PlannerAgent instances.