Package com.alibaba.cloud.ai.graph.agent.hook.toolcalllimit

Class ToolCallLimitHook

java.lang.Object

com.alibaba.cloud.ai.graph.agent.hook.ModelHook

com.alibaba.cloud.ai.graph.agent.hook.toolcalllimit.ToolCallLimitHook

All Implemented Interfaces:

Hook, Prioritized

public class ToolCallLimitHook
extends ModelHook

Hook that tracks and limits tool call counts. This hook monitors the number of tool calls made during agent execution and can terminate the agent when specified limits are reached.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ToolCallLimitHook.Builder
static enum	ToolCallLimitHook.ExitBehavior

Field Summary

Fields inherited from interface com.alibaba.cloud.ai.graph.agent.Prioritized

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Method Summary

Modifier and Type	Method	Description
CompletableFuture<Map<String,Object>>	afterModel(OverAllState state, RunnableConfig config)
CompletableFuture<Map<String,Object>>	beforeModel(OverAllState state, RunnableConfig config)
static ToolCallLimitHook.Builder	builder()
List<JumpTo>	canJumpTo()	Gets the list of allowed jump destinations for this hook.
String	getName()	Gets the unique name of this hook.

Methods inherited from class com.alibaba.cloud.ai.graph.agent.hook.ModelHook

getAgent, getAgentName, getOrder, setAgent, setAgentName

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.alibaba.cloud.ai.graph.agent.hook.Hook

getHookPositions, getKeyStrategys, getModelInterceptors, getToolInterceptors, getTools

Method Details

builder

public static ToolCallLimitHook.Builder builder()

beforeModel

public CompletableFuture<Map<String,Object>> beforeModel(OverAllState state,
 RunnableConfig config)

Overrides:

beforeModel in class ModelHook

afterModel

public CompletableFuture<Map<String,Object>> afterModel(OverAllState state,
 RunnableConfig config)

Overrides:

afterModel in class ModelHook

getName

public String getName()

Description copied from interface: Hook

Gets the unique name of this hook. The name is used to identify the hook in the execution graph.

Returns:

the hook name, must not be null

canJumpTo

public List<JumpTo> canJumpTo()

Description copied from interface: Hook

Gets the list of allowed jump destinations for this hook.

Hooks can control the flow of execution by specifying where the agent can jump to after the hook executes. This allows hooks to redirect the execution flow based on their logic.

Common jump destinations include:

• JumpTo.model: Jump to model node
• JumpTo.tool: Jump to tool node
• JumpTo.end: Jump to end (terminate agent)

Returns:

list of allowed jump destinations, empty list by default

See Also:

• JumpTo