Package com.alibaba.cloud.ai.graph.agent.flow.agent

Class FlowAgent

java.lang.Object

com.alibaba.cloud.ai.graph.agent.Agent

com.alibaba.cloud.ai.graph.agent.flow.agent.FlowAgent

Direct Known Subclasses:

LlmRoutingAgent, LoopAgent, ParallelAgent, SequentialAgent

public abstract class FlowAgent
extends Agent

Field Summary

Fields

Modifier and Type	Field	Description
protected List<Hook>	hooks
protected List<String>	interruptBefore
protected StateSerializer	stateSerializer
protected List<Agent>	subAgents

Fields inherited from class com.alibaba.cloud.ai.graph.agent.Agent

compileConfig, compiledGraph, description, executor, graph, name

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	FlowAgent(String name, String description, CompileConfig compileConfig, List<Agent> subAgents)
protected	FlowAgent(String name, String description, CompileConfig compileConfig, List<Agent> subAgents, StateSerializer stateSerializer)
protected	FlowAgent(String name, String description, CompileConfig compileConfig, List<Agent> subAgents, StateSerializer stateSerializer, Executor executor)
protected	FlowAgent(String name, String description, CompileConfig compileConfig, List<Agent> subAgents, StateSerializer stateSerializer, Executor executor, List<Hook> hooks)

Method Summary

Modifier and Type	Method	Description
StateGraph	asStateGraph()
protected abstract StateGraph	buildSpecificGraph(FlowGraphBuilder.FlowGraphConfig config)	Abstract method for subclasses to specify their graph building strategy.
List<Hook>	hooks()	Returns the list of hooks configured for this agent.
protected StateGraph	initGraph()
ScheduledAgentTask	schedule(ScheduleConfig scheduleConfig)	Schedule the agent task with trigger.
List<Agent>	subAgents()

Methods inherited from class com.alibaba.cloud.ai.graph.agent.Agent

applyExecutorConfig, buildMessageInput, buildNonStreamConfig, buildStreamConfig, description, doInvoke, doInvokeAndGetOutput, doStream, getAndCompileGraph, getCurrentState, getGraph, invoke, invoke, invoke, invoke, invoke, invoke, invoke, invoke, invokeAndGetOutput, invokeAndGetOutput, invokeAndGetOutput, invokeAndGetOutput, invokeAndGetOutput, invokeAndGetOutput, invokeAndGetOutput, invokeAndGetOutput, name, schedule, stream, stream, stream, stream, stream, stream, stream, stream, streamMessages, streamMessages, streamMessages, streamMessages, streamMessages, streamMessages, streamMessages, streamMessages

Methods inherited from class java.lang.Object

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

Field Details

interruptBefore

protected List<String> interruptBefore

subAgents

protected List<Agent> subAgents

stateSerializer

protected StateSerializer stateSerializer

hooks

protected List<Hook> hooks

Constructor Details

FlowAgent

protected FlowAgent(String name,
 String description,
 CompileConfig compileConfig,
 List<Agent> subAgents)

FlowAgent

protected FlowAgent(String name,
 String description,
 CompileConfig compileConfig,
 List<Agent> subAgents,
 StateSerializer stateSerializer)

FlowAgent

protected FlowAgent(String name,
 String description,
 CompileConfig compileConfig,
 List<Agent> subAgents,
 StateSerializer stateSerializer,
 Executor executor)

FlowAgent

protected FlowAgent(String name,
 String description,
 CompileConfig compileConfig,
 List<Agent> subAgents,
 StateSerializer stateSerializer,
 Executor executor,
 List<Hook> hooks)

Method Details

initGraph

protected StateGraph initGraph()
                        throws GraphStateException

Specified by:

initGraph in class Agent

Throws:

GraphStateException

schedule

public ScheduledAgentTask schedule(ScheduleConfig scheduleConfig)

Description copied from class: Agent

Schedule the agent task with trigger.

Overrides:

schedule in class Agent

Parameters:

scheduleConfig - the schedule configuration

Returns:

a ScheduledAgentTask instance for managing the scheduled task

asStateGraph

public StateGraph asStateGraph()

buildSpecificGraph

protected abstract StateGraph buildSpecificGraph(FlowGraphBuilder.FlowGraphConfig config)
                                          throws GraphStateException

Abstract method for subclasses to specify their graph building strategy. This method should be implemented by concrete FlowAgent subclasses to define how their specific graph structure should be built.

Parameters:

config - the graph configuration

Returns:

the constructed StateGraph

Throws:

GraphStateException - if graph construction fails

subAgents

public List<Agent> subAgents()

hooks

public List<Hook> hooks()

Returns the list of hooks configured for this agent. Hooks can be used for message trimming, summarization, logging, and other purposes.

Returns:

the list of hooks, or null if no hooks are configured