tooluniverse.agentic_tool module

class tooluniverse.agentic_tool.AgenticTool

Bases: BaseTool

Generic wrapper around LLM prompting supporting JSON-defined configs with prompts and input arguments.

STREAM_FLAG_KEY = '_tooluniverse_stream'

static has_any_api_keys()

Check if any API keys are available across all supported API types.

Returns:

True if at least one API type has all required keys, False otherwise

Return type:

bool

__init__(tool_config)

name: str

_prompt_template: str

_input_arguments: List[str]

_required_arguments: List[str]

_argument_defaults: Dict[str, str]

_api_type: str

_model_id: str

_temperature: float | None

_max_new_tokens: int | None

_return_json: bool

_max_retries: int

_retry_delay: int

return_metadata: bool

_validate_api_key: bool

_fallback_api_type: str | None

_fallback_model_id: str | None

_use_global_fallback: bool

_global_fallback_chain: List[Dict[str, str]]

_gemini_model_id: str

_get_global_fallback_chain()

Get the global fallback chain from environment or use default.

_try_initialize_api()

Try to initialize the primary API, fallback to secondary if configured.

_try_api(api_type, model_id, server_url=None)

Try to initialize a specific API and model.

_validate_model_config()

run(arguments, stream_callback=None)

Execute the tool.

The default BaseTool implementation accepts an optional arguments mapping to align with most concrete tool implementations which expect a dictionary of inputs.

Parameters:

• arguments (dict, optional) – Tool-specific arguments

• stream_callback (callable, optional) – Callback for streaming responses

• use_cache (bool, optional) – Whether result caching is enabled

• validate (bool, optional) – Whether parameter validation was performed

Note

These additional parameters (stream_callback, use_cache, validate) are passed from run_one_function() to provide context about the execution. Tools can use these for optimization or special handling.

For backward compatibility, tools that don’t accept these parameters will still work - they will only receive the arguments parameter.

static _iter_chunks(text, size=800)

_emit_stream_chunk(chunk, stream_callback)

_validate_arguments(arguments)

_format_prompt(arguments)

get_prompt_preview(arguments)

get_model_info()

is_available()

Check if the tool is available for use.

get_availability_status()

Get detailed availability status of the tool.

retry_initialization()

Attempt to reinitialize the tool (useful if API keys were updated).

get_prompt_template()

get_input_arguments()

validate_configuration()

estimate_token_usage(arguments)

_cached_version_hash: str | None