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

# Overview

> Use Tool Decorator with Agno agents.

| Example                                                                                             | Description                                                          |
| --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [Tool Decorator](/examples/tools/tool-decorator/tool-decorator)                                     | Define tool decorator with @tool, including sync and async examples. |
| [Async Tool Decorator](/examples/tools/tool-decorator/async-tool-decorator)                         | Define async tools with @tool and stream results via AsyncIterator.  |
| [Tool Decorator On Class Method](/examples/tools/tool-decorator/tool-decorator-on-class-method)     | Use @tool on toolkit class methods, including generators.            |
| [Tool Decorator With Hook](/examples/tools/tool-decorator/tool-decorator-with-hook)                 | Attach execution hooks to a tool via the decorator pattern.          |
| [Tool Decorator With Instructions](/examples/tools/tool-decorator/tool-decorator-with-instructions) | Add tool instructions to guide model usage and output.               |
| [Cache Tool Calls](/examples/tools/tool-decorator/cache-tool-calls)                                 | Cache tool results with `cache_results` to avoid repeat calls.       |
| [Stop After Tool Call](/examples/tools/tool-decorator/stop-after-tool-call)                         | Stop agent execution immediately after a tool call completes.        |