Skip to main content

Overview

Tools can be attached at two levels: Agent and Task. Where you place a tool determines its scope and availability.

Agent-Level Tools

Tools added to an agent are available for every task that agent executes.

Task-Level Tools

Tools added to a task are only available for that specific task. Other tasks executed by the same agent cannot use them.

Combining Both Levels

When an agent has tools and a task also has tools, the task gets access to both:

Summary

Use agent-level tools for general-purpose tools like search, database access, or utilities. Use task-level tools for specialized tools that are only relevant to a specific task — this keeps the LLM focused by not exposing unnecessary tools.