Tool Decorator
Reference for the @tool decorator.
The @tool decorator converts a function into a Function that agents can call. Use it bare (@tool) or with the parameters below (@tool(...)).
from agno.tools import toolParameters
| Parameter | Type | Description |
|---|---|---|
name | str | Override for the function name |
title | Optional[str] | Human-readable MCP tool title (default: None). |
annotations | Optional[Dict[str, Any]] | MCP behavior hints such as readOnlyHint (default: None); hints do not enforce permissions. |
description | str | Override for the function description |
strict | bool | If True, enforces strict parameter checking on the function schema |
instructions | str | Instructions for using the tool |
add_instructions | bool | If True, adds the tool instructions to the system message (default: True) |
show_result | bool | If True, shows the result after the function call |
stop_after_tool_call | bool | If True, the agent will stop after the function call |
tool_hooks | list[Callable] | List of hooks that wrap the function execution |
pre_hook | Callable | Hook to run before the function is executed |
post_hook | Callable | Hook to run after the function is executed |
requires_confirmation | bool | If True, requires user confirmation before execution |
requires_user_input | bool | If True, requires user input before execution |
user_input_fields | list[str] | List of fields that require user input |
external_execution | bool | If True, the tool will be executed outside of the agent's control |
external_execution_silent | bool | If True (with external_execution=True), suppresses verbose paused messages |
cache_results | bool | If True, enables caching of function results |
cache_dir | str | Directory to store cache files |
cache_ttl | int | Time-to-live for cached results in seconds (default: 3600) |
requires_confirmation, requires_user_input, and external_execution are mutually exclusive. Enable at most one for a tool.