> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Index of @tool decorator examples: sync and async tools, class methods, hooks, instructions, caching, and stop-after-tool-call.

| Example | Description |
| - | - |
| [Tool Decorator](https://agno-v2.mintlify.site/examples/tools/tool-decorator/tool-decorator.md) | Define tool decorator with @tool, including sync and async examples. |
| [Async Tool Decorator](https://agno-v2.mintlify.site/examples/tools/tool-decorator/async-tool-decorator.md) | Define async tools with @tool and stream results via AsyncIterator. |
| [Tool Decorator On Class Method](https://agno-v2.mintlify.site/examples/tools/tool-decorator/tool-decorator-on-class-method.md) | Use @tool on toolkit class methods, including generators. |
| [Tool Decorator with Hook](https://agno-v2.mintlify.site/examples/tools/tool-decorator/tool-decorator-with-hook.md) | Attach execution hooks to a tool via the decorator pattern. |
| [Tool Decorator With Instructions](https://agno-v2.mintlify.site/examples/tools/tool-decorator/tool-decorator-with-instructions.md) | Add tool instructions to guide model usage and output. |
| [Cache Tool Calls](https://agno-v2.mintlify.site/examples/tools/tool-decorator/cache-tool-calls.md) | Cache tool results with `cache_results` to avoid repeat calls. |
| [Stop After Tool Call](https://agno-v2.mintlify.site/examples/tools/tool-decorator/stop-after-tool-call.md) | Stop agent execution immediately after a tool call completes. |
| [Toolkit Per-Tool Instructions](https://agno-v2.mintlify.site/examples/tools/tool-decorator/toolkit-per-tool-instructions.md) | Verify per-tool instructions from a bare @tool function and a Toolkit both reach agent.\_tool\_instructions via parse\_tools. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.