Package org.machanism.machai.ai.provider.impl

Class ToolsProvider

java.lang.Object

org.machanism.machai.ai.provider.AbstractAIProvider

org.machanism.machai.ai.provider.impl.ToolsProvider

All Implemented Interfaces:

Genai

public class ToolsProvider
extends AbstractAIProvider

AI provider implementation for managing and invoking host-defined function tools.

The ToolsProvider class extends AbstractAIProvider and provides infrastructure for registering tool functions, handling prompts, and executing tool invocations based on structured YAML input. Tools are registered in a map and can be invoked dynamically.

• Prompts are collected and stored for later processing.
• Tool functions are registered by name and can be invoked with parameters parsed from YAML.
• Supports execution mode where the last prompt is interpreted as a YAML tool call description.

Usage Example

 ToolsProvider provider = new ToolsProvider();
 provider.addTool("myTool", "Description", myToolFunction, ...);
 provider.prompt("tool: myTool\nparams:\n  key: value");
 String result = provider.perform();
 

Since:

1.2.0

Author:

Viktor Tovstyi

Field Summary

Fields inherited from class org.machanism.machai.ai.provider.AbstractAIProvider

chatModel, DEFAULT_WEBSEARCH_TYPE_NAME, instructions, LINE_SEPARATOR, LOG_INPUTS_PROP_NAME, LOG_LINE_LENG, LOG_SECTION_SEPARATOR, MAX_OUTPUT_TOKENS, maxOutputTokens, maxToolCalls, MCP_PROP_NAME_PREFIX, PARAGRAPH_SEPARATOR, PASSWORD_PROP_NAME, PROJECT_DIR_PARAM_NAME, projectDir, SERVERID_PROP_NAME, timeoutSec, USERNAME_PROP_NAME

Constructor Summary

Constructors

Constructor	Description
ToolsProvider()	Constructs a new ToolsProvider with a default configuration.

Method Summary

Modifier and Type	Method	Description
protected void	addTool(String name, String description, ToolFunction function, ParamDescriptor... paramsDesc)	Registers a tool function with the provider.
String	perform()	Executes the provider's perform logic.
void	prompt(String text)	Adds a prompt text to the provider's prompt list.

Methods inherited from class org.machanism.machai.ai.provider.AbstractAIProvider

addMcpServer, addMcpServers, addPrompt, addPrompts, addTools, addWebSearch, addWebSearch, clear, getConfigurator, getParamValue, getProjectDir, getTimeout, init, inputsLog, instructions, isErrorHandling, logInputs, logInputsSpec, normalize, safelyInvokeTool, setErrorHandling, setProjectDir, setTimeout

Methods inherited from class java.lang.Object

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

Constructor Details

ToolsProvider

public ToolsProvider()

Constructs a new ToolsProvider with a default configuration.

This constructor initializes the superclass and explicitly disables conversational error handling by calling setErrorHandling(false).

By disabling conversational error interception, this provider operates under a fail-fast model: any exception thrown during a registered tool's execution is not converted into a text message for the model, but is instead immediately propagated up to the calling application as a SpecialException.

Method Details

prompt

public void prompt(String text)

Adds a prompt text to the provider's prompt list.

Specified by:

prompt in interface Genai

Overrides:

prompt in class AbstractAIProvider

Parameters:

text - the prompt text to add

perform

public String perform()

Executes the provider's perform logic.

If the chatModel is set to "yaml", the last prompt is parsed as a YAML tool call description. The tool name and parameters are extracted, and the corresponding tool function is invoked.

Returns:

the result of the tool invocation, or null if not applicable

addTool

protected void addTool(String name,
 String description,
 ToolFunction function,
 ParamDescriptor... paramsDesc)

Registers a tool function with the provider.

The tool is added to the internal map by name. Parameter descriptors are accepted but not used in this implementation.

Specified by:

addTool in class AbstractAIProvider

Parameters:

name - the tool name

description - the tool description

function - the tool function implementation

paramsDesc - parameter descriptors for the tool (optional)