Class SimpleToolSearchStrategy

java.lang.Object

dev.langchain4j.service.tool.search.simple.SimpleToolSearchStrategy

All Implemented Interfaces:

ToolSearchStrategy

@Experimental
public class SimpleToolSearchStrategy
extends Object
implements ToolSearchStrategy

A ToolSearchStrategy that allows an LLM to search for available tools using simple case-insensitive contains matching.

The LLM provides a list of search terms. Each term contributes to a tool's score:

• +2 if the tool name contains the term
• +1 if the tool description contains the term

Scores are accumulated across all terms. Tools are ranked by score (descending) and limited by maxResults.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SimpleToolSearchStrategy.Builder

Constructor Summary

Constructors

Constructor	Description
SimpleToolSearchStrategy()
SimpleToolSearchStrategy(SimpleToolSearchStrategy.Builder builder)

Method Summary

Modifier and Type	Method	Description
static SimpleToolSearchStrategy.Builder	builder()
protected List<String>	clean(List<String> terms)
protected List<String>	extractTerms(String argumentsJson)
List<ToolSpecification>	getToolSearchTools(InvocationContext context)	Returns one or more tool specifications that are exposed to the LLM and are used to perform tool searches.
protected int	score(ToolSpecification tool, List<String> terms)
ToolSearchResult	search(ToolSearchRequest request)	Executes a tool search request generated by the LLM and matching it against searchable tools.

Methods inherited from class Object

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

Constructor Details

SimpleToolSearchStrategy

public SimpleToolSearchStrategy()

SimpleToolSearchStrategy

public SimpleToolSearchStrategy(SimpleToolSearchStrategy.Builder builder)

Method Details

getToolSearchTools

public List<ToolSpecification> getToolSearchTools(InvocationContext context)

Description copied from interface: ToolSearchStrategy

Returns one or more tool specifications that are exposed to the LLM and are used to perform tool searches.

Specified by:

getToolSearchTools in interface ToolSearchStrategy

Parameters:

context - the AI Service invocation context

Returns:

list containing one or more tool search tools

search

public ToolSearchResult search(ToolSearchRequest request)

Description copied from interface: ToolSearchStrategy

Executes a tool search request generated by the LLM and matching it against searchable tools.

Specified by:

search in interface ToolSearchStrategy

Parameters:

request - the tool search request

Returns:

the search result containing matching tool names

score

protected int score(ToolSpecification tool,
 List<String> terms)

clean

protected List<String> clean(List<String> terms)

extractTerms

protected List<String> extractTerms(String argumentsJson)

builder

public static SimpleToolSearchStrategy.Builder builder()