Package org.springframework.ai.model.tool

Class DefaultToolCallingManager

java.lang.Object

org.springframework.ai.model.tool.DefaultToolCallingManager

All Implemented Interfaces:

ToolCallingManager

public final class DefaultToolCallingManager
extends Object
implements ToolCallingManager

Default implementation of ToolCallingManager.

Since:

1.0.0

Author:

Thomas Vitale, chabinhwang, Christian Tzolov, Dimitar Proynov

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	DefaultToolCallingManager.Builder

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_MAX_CALLS_PER_TOOL	Default cap applied to every tool name unless overridden via DefaultToolCallingManager.Builder.maxCallsPerTool(String, int), exempted via DefaultToolCallingManager.Builder.excludeToolFromLimit(String), or disabled entirely via DefaultToolCallingManager.Builder.unlimitedCallsPerTool().
static final int	DEFAULT_MAX_TOTAL_TOOL_CALLS	Default cap on the total number of tool calls, across all tools combined, allowed within a turn, unless disabled entirely via DefaultToolCallingManager.Builder.unlimitedTotalToolCalls().

Constructor Summary

Constructors

Constructor	Description
DefaultToolCallingManager(io.micrometer.observation.ObservationRegistry observationRegistry, ToolCallbackResolver toolCallbackResolver, ToolExecutionExceptionProcessor toolExecutionExceptionProcessor)

Method Summary

Modifier and Type	Method	Description
static DefaultToolCallingManager.Builder	builder()	Create a default ToolCallingManager builder.
ToolExecutionResult	executeToolCalls(Prompt prompt, ChatResponse chatResponse)	Execute the tool calls requested by the model.
List<ToolDefinition>	resolveToolDefinitions(ToolCallingChatOptions chatOptions)	Resolve the tool definitions from the model's tool calling options.
void	setObservationConvention(ToolCallingObservationConvention observationConvention)

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT_MAX_CALLS_PER_TOOL

public static final int DEFAULT_MAX_CALLS_PER_TOOL

Default cap applied to every tool name unless overridden via DefaultToolCallingManager.Builder.maxCallsPerTool(String, int), exempted via DefaultToolCallingManager.Builder.excludeToolFromLimit(String), or disabled entirely via DefaultToolCallingManager.Builder.unlimitedCallsPerTool(). Generous enough for legitimate iterative tool use (pagination, retries) while still catching a runaway loop long before it becomes expensive.

See Also:

• Constant Field Values

DEFAULT_MAX_TOTAL_TOOL_CALLS

public static final int DEFAULT_MAX_TOTAL_TOOL_CALLS

Default cap on the total number of tool calls, across all tools combined, allowed within a turn, unless disabled entirely via DefaultToolCallingManager.Builder.unlimitedTotalToolCalls().

See Also:

• Constant Field Values

Constructor Details

DefaultToolCallingManager

public DefaultToolCallingManager(io.micrometer.observation.ObservationRegistry observationRegistry,
 ToolCallbackResolver toolCallbackResolver,
 ToolExecutionExceptionProcessor toolExecutionExceptionProcessor)

Method Details

resolveToolDefinitions

public List<ToolDefinition> resolveToolDefinitions(ToolCallingChatOptions chatOptions)

Description copied from interface: ToolCallingManager

Resolve the tool definitions from the model's tool calling options.

Specified by:

resolveToolDefinitions in interface ToolCallingManager

executeToolCalls

public ToolExecutionResult executeToolCalls(Prompt prompt,
 ChatResponse chatResponse)

Description copied from interface: ToolCallingManager

Execute the tool calls requested by the model.

Specified by:

executeToolCalls in interface ToolCallingManager

setObservationConvention

public void setObservationConvention(ToolCallingObservationConvention observationConvention)

builder

public static DefaultToolCallingManager.Builder builder()

Description copied from interface: ToolCallingManager

Create a default ToolCallingManager builder.