Package org.springframework.ai.tool.function

Class FunctionToolCallback<I,O>

java.lang.Object

org.springframework.ai.tool.function.FunctionToolCallback<I,O>

All Implemented Interfaces:

ToolCallback

public class FunctionToolCallback<I,O>
extends Object
implements ToolCallback

A ToolCallback implementation to invoke functions as tools.

Since:

1.0.0

Author:

Thomas Vitale, YunKui Lu

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	FunctionToolCallback.Builder<I,O>

Constructor Summary

Constructors

Constructor	Description
FunctionToolCallback(ToolDefinition toolDefinition, ToolMetadata toolMetadata, Type toolInputType, BiFunction<I,ToolContext,O> toolFunction, ToolCallResultConverter toolCallResultConverter)

Method Summary

Modifier and Type	Method	Description
static <I, O> FunctionToolCallback.Builder<I,O>	builder(String name, BiFunction<I,ToolContext,O> function)	Build a FunctionToolCallback from a BiFunction.
static <I> FunctionToolCallback.Builder<I,Void>	builder(String name, Consumer<I> consumer)	Build a FunctionToolCallback from a Consumer.
static <I, O> FunctionToolCallback.Builder<I,O>	builder(String name, Function<I,O> function)	Build a FunctionToolCallback from a Function.
static <O> FunctionToolCallback.Builder<Void,O>	builder(String name, Supplier<O> supplier)	Build a FunctionToolCallback from a Supplier.
String	call(String toolInput)	Execute tool with the given input and return the result to send back to the AI model.
String	call(String toolInput, ToolContext toolContext)	Execute tool with the given input and context, and return the result to send back to the AI model.
ToolDefinition	getToolDefinition()	Definition used by the AI model to determine when and how to call the tool.
ToolMetadata	getToolMetadata()	Metadata providing additional information on how to handle the tool.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Details

FunctionToolCallback

public FunctionToolCallback(ToolDefinition toolDefinition,
 @Nullable
 ToolMetadata toolMetadata,
 Type toolInputType,
 BiFunction<I,ToolContext,O> toolFunction,
 @Nullable
 ToolCallResultConverter toolCallResultConverter)

Method Details

getToolDefinition

public ToolDefinition getToolDefinition()

Description copied from interface: ToolCallback

Definition used by the AI model to determine when and how to call the tool.

Specified by:

getToolDefinition in interface ToolCallback

getToolMetadata

public ToolMetadata getToolMetadata()

Description copied from interface: ToolCallback

Metadata providing additional information on how to handle the tool.

Specified by:

getToolMetadata in interface ToolCallback

call

public String call(String toolInput)

Description copied from interface: ToolCallback

Execute tool with the given input and return the result to send back to the AI model.

Specified by:

call in interface ToolCallback

call

public String call(String toolInput,
 @Nullable
 ToolContext toolContext)

Description copied from interface: ToolCallback

Execute tool with the given input and context, and return the result to send back to the AI model.

Specified by:

call in interface ToolCallback

toString

public String toString()

Overrides:

toString in class Object

builder

public static <I,
O>
FunctionToolCallback.Builder<I,O> builder(String name,
 BiFunction<I,ToolContext,O> function)

Build a FunctionToolCallback from a BiFunction.

builder

public static <I,
O>
FunctionToolCallback.Builder<I,O> builder(String name,
 Function<I,O> function)

Build a FunctionToolCallback from a Function.

builder

public static <O>
FunctionToolCallback.Builder<Void,O> builder(String name,
 Supplier<O> supplier)

Build a FunctionToolCallback from a Supplier.

builder

public static <I>
FunctionToolCallback.Builder<I,Void> builder(String name,
 Consumer<I> consumer)

Build a FunctionToolCallback from a Consumer.