Understand where tools live — agent-level vs task-level
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.
from upsonic import Agent, Taskfrom upsonic.tools import tool@tooldef search(query: str) -> str: """Search for information.""" return f"Results for: {query}"agent = Agent("anthropic/claude-sonnet-4-5")agent.add_tools(search) # Agent-level tool# search is available in both taskstask1 = Task(description="Search for Python tutorials")result = agent.print_do(task1)print("Result:", result)task2 = Task(description="Search for JavaScript frameworks")result = agent.print_do(task2)print("Result:", result)
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.
from upsonic import Agent, Taskfrom upsonic.tools import tool@tooldef calculate_tax(amount: float, rate: float) -> float: """Calculate tax for given amount.""" return amount * rateagent = Agent("anthropic/claude-sonnet-4-5")# calculate_tax is only available for this tasktask1 = Task( description="Calculate 18% tax on 1000", tools=[calculate_tax])result = agent.print_do(task1)print("Result:", result)# This task does NOT have access to calculate_taxtask2 = Task(description="What is the capital of France?")result = agent.print_do(task2)print("Result:", result)
Combining Both Levels
When an agent has tools and a task also has tools, the task gets access to both:
from upsonic import Agent, Taskfrom upsonic.tools import tool@tooldef search(query: str) -> str: """Search for information.""" return f"Results for: {query}"@tooldef summarize(text: str) -> str: """Summarize the given text.""" return f"Summary of: {text}"# search is available for ALL tasksagent = Agent("anthropic/claude-sonnet-4-5", tools=[search])# This task has both: search (from agent) + summarize (task-only)task1 = Task( description="Search for AI news and summarize the results", tools=[summarize])result = agent.print_do(task1)print("Result:", result)# This task only has search (from agent), NOT summarizetask2 = Task(description="Search for Python tutorials")result = agent.print_do(task2)print("Result:", result)
Summary
Level
Scope
Use When
Agent
Available for all tasks the agent runs
The tool is generally useful across many tasks
Task
Available only for that specific task
The tool is needed for one specific operation
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.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Upsonic AI","colors":{"primary":"#03D47E","light":"#00D37F","dark":"#00D37F"},"logo":{"light":"https://mintcdn.com/upsonic/eD3pOHUjFRrpRlr1/logo/logo_name.png?fit=max\u0026auto=format\u0026n=eD3pOHUjFRrpRlr1\u0026q=85\u0026s=a5f719ba8cc7e2e5247f98ce0f4cd570","dark":"https://mintcdn.com/upsonic/NvtIPMvILtME55zd/logo/logo_name_dark.png?fit=max\u0026auto=format\u0026n=NvtIPMvILtME55zd\u0026q=85\u0026s=b6ee805d29e1196fd56206200f0fe42b"},"favicon":"https://mintcdn.com/upsonic/Q5tER9e3gIUsdKBE/favicon.png?fit=max\u0026auto=format\u0026n=Q5tER9e3gIUsdKBE\u0026q=85\u0026s=6d90389a3780b1c15cff5e3f56f8bd5b","appearance":{"default":"dark","strict":false},"navbar":{"primary":{"type":"github","href":"https://github.com/Upsonic/Upsonic"}},"footer":{"socials":{"discord":"https://discord.gg/7648R8JahY","x":"https://x.com/UpsonicAI","github":"https://github.com/Upsonic","linkedin":"https://www.linkedin.com/company/getupsonic"}},"fonts":{"heading":{"family":"Helvetica","weight":750},"body":{"family":"Inter","weight":400}},"integrations":{"gtm":{"tagId":"GTM-MQ8VVXSB"}},"interaction":{"drilldown":true},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"upsonic","hasAudioNarration":false,"actualSubdomain":"upsonic","customDomains":["docs.upsonic.ai"],"gitSource":{"type":"github","owner":"upsonic","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae0964beb5b4f30de3efad5","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Upsonic Framework","count":373},{"language":"default","tag":"CONCEPTS","count":353},{"language":"default","tag":"Usage","count":109},{"language":"default","tag":"Advanced","count":79},{"language":"default","tag":"AgentOS","count":53},{"language":"default","tag":"Tools","count":52},{"language":"default","tag":"Knowledge Base","count":51},{"language":"default","tag":"Integrations","count":45},{"language":"default","tag":"LLM Support","count":32},{"language":"default","tag":"Examples","count":31}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"concepts/tools/tool-locations","slug":"/concepts/tools/tool-locations","pageMetadata":{"title":"Tool Locations","description":"Understand where tools live — agent-level vs task-level","sidebarTitle":"Tool Locations (Agent/Task)","href":"/concepts/tools/tool-locations"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Understand where tools live — agent-level vs task-level\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Tools can be attached at two levels: `,_jsx(_components.strong,{children:`Agent`}),` and `,_jsx(_components.strong,{children:`Task`}),`. Where you place a tool determines its scope and availability.`]}),`\n`,_jsx(Heading,{level:`2`,id:`agent-level-tools`,children:`Agent-Level Tools`}),`\n`,_jsxs(_components.p,{children:[`Tools added to an `,_jsx(_components.strong,{children:`agent`}),` are available for `,_jsx(_components.strong,{children:`every task`}),` that agent executes.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`19`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`19`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` upsonic `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Agent, Task`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` upsonic.tools `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` tool`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`@tool`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`def`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` search`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`query`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`str`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) -> `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`str`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\"\"Search for information.\"\"\"`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Results for: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`query`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`agent `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Agent(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"anthropic/claude-sonnet-4-5\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`agent.add_tools(search) `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Agent-level tool`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# search is available in both tasks`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`task1 `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Task(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`description`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Search for Python tutorials\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` agent.print_do(task1)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Result:\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, result)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`task2 `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Task(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`description`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Search for JavaScript frameworks\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` agent.print_do(task2)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Result:\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, result)`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`task-level-tools`,children:`Task-Level Tools`}),`\n`,_jsxs(_components.p,{children:[`Tools added to a `,_jsx(_components.strong,{children:`task`}),` are `,_jsx(_components.strong,{children:`only available for that specific task`}),`. Other tasks executed by the same agent cannot use them.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`22`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`22`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` upsonic `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Agent, Task`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` upsonic.tools `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` tool`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`@tool`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`def`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` calculate_tax`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`amount`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`float`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`rate`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`float`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) -> `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`float`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\"\"Calculate tax for given amount.\"\"\"`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` amount `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`*`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` rate`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`agent `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Agent(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"anthropic/claude-sonnet-4-5\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# calculate_tax is only available for this task`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`task1 `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Task(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` description`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Calculate 18% tax on 1000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` tools`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[calculate_tax]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` agent.print_do(task1)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Result:\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, result)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# This task does NOT have access to calculate_tax`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`task2 `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Task(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`description`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"What is the capital of France?\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` agent.print_do(task2)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Result:\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, result)`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`combining-both-levels`,children:`Combining Both Levels`}),`\n`,_jsxs(_components.p,{children:[`When an agent has tools and a task also has tools, the task gets access to `,_jsx(_components.strong,{children:`both`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`28`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`28`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` upsonic `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Agent, Task`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` upsonic.tools `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` tool`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`@tool`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`def`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` search`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`query`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`str`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) -> `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`str`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\"\"Search for information.\"\"\"`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Results for: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`query`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`@tool`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`def`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` summarize`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`text`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`str`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) -> `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`str`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\"\"Summarize the given text.\"\"\"`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Summary of: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`text`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# search is available for ALL tasks`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`agent `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Agent(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"anthropic/claude-sonnet-4-5\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`tools`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[search])`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# This task has both: search (from agent) + summarize (task-only)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`task1 `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Task(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` description`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Search for AI news and summarize the results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` tools`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[summarize]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` agent.print_do(task1)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Result:\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, result)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# This task only has search (from agent), NOT summarize`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`task2 `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Task(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`description`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Search for Python tutorials\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` agent.print_do(task2)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Result:\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, result)`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`summary`,children:`Summary`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Level`}),_jsx(_components.th,{children:`Scope`}),_jsx(_components.th,{children:`Use When`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Agent`})}),_jsx(_components.td,{children:`Available for all tasks the agent runs`}),_jsx(_components.td,{children:`The tool is generally useful across many tasks`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Task`})}),_jsx(_components.td,{children:`Available only for that specific task`}),_jsx(_components.td,{children:`The tool is needed for one specific operation`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.strong,{children:`agent-level tools`}),` for general-purpose tools like search, database access, or utilities. Use `,_jsx(_components.strong,{children:`task-level tools`}),` for specialized tools that are only relevant to a specific task — this keeps the LLM focused by not exposing unnecessary tools.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Tool Locations","description":"Understand where tools live — agent-level vs task-level","sidebarTitle":"Tool Locations (Agent/Task)","href":"/concepts/tools/tool-locations"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Agent-Level Tools","slug":"agent-level-tools","depth":2,"children":[]},{"title":"Task-Level Tools","slug":"task-level-tools","depth":2,"children":[]},{"title":"Combining Both Levels","slug":"combining-both-levels","depth":2,"children":[]},{"title":"Summary","slug":"summary","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/upsonic/418601343a17abbb/ga.js"],"subdomain":"upsonic","siteName":"Upsonic AI","title":"Tool Locations - Upsonic AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-17T14:37:03.348Z","originalFileLocation":"concepts/tools/tool-locations.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Understand where tools live — agent-level vs task-level\">\u003cmeta data-mint-head name=\"application-name\" content=\"Upsonic AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/upsonic/adDEYx-Qrl3jC12g/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/upsonic/adDEYx-Qrl3jC12g/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/upsonic/adDEYx-Qrl3jC12g/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/upsonic/adDEYx-Qrl3jC12g/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/upsonic/adDEYx-Qrl3jC12g/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/upsonic/adDEYx-Qrl3jC12g/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/upsonic/adDEYx-Qrl3jC12g/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/upsonic/adDEYx-Qrl3jC12g/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/upsonic/adDEYx-Qrl3jC12g/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Tool Locations - Upsonic AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Understand where tools live — agent-level vs task-level\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Upsonic AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.upsonic.ai/concepts/tools/tool-locations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://upsonic.mintlify.site/_mintlify/api/og/v2?division=Tools\u0026amp;title=Tool+Locations\u0026amp;description=Understand+where+tools+live+%E2%80%94+agent-level+vs+task-level\u0026amp;theme=4220d6dda423f32b3126fd51\u0026amp;signature=59bcbfb2a3697b463b5b170bda013a0747964d26a35387894c92fbf2af438f4e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Tool Locations - Upsonic AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Understand where tools live — agent-level vs task-level\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://upsonic.mintlify.site/_mintlify/api/og/v2?division=Tools\u0026amp;title=Tool+Locations\u0026amp;description=Understand+where+tools+live+%E2%80%94+agent-level+vs+task-level\u0026amp;theme=4220d6dda423f32b3126fd51\u0026amp;signature=59bcbfb2a3697b463b5b170bda013a0747964d26a35387894c92fbf2af438f4e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/upsonic/adDEYx-Qrl3jC12g/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Upsonic AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#03D47E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.upsonic.ai/concepts/tools/tool-locations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/concepts/tools/tool-locations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.upsonic.ai/#organization\",\"name\":\"Upsonic AI\",\"url\":\"https://docs.upsonic.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/upsonic/eD3pOHUjFRrpRlr1/logo/logo_name.png?fit=max\u0026auto=format\u0026n=eD3pOHUjFRrpRlr1\u0026q=85\u0026s=a5f719ba8cc7e2e5247f98ce0f4cd570\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.upsonic.ai#website\",\"name\":\"Upsonic AI\",\"url\":\"https://docs.upsonic.ai\",\"publisher\":{\"@id\":\"https://docs.upsonic.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.upsonic.ai/concepts/tools/tool-locations#webpage\",\"url\":\"https://docs.upsonic.ai/concepts/tools/tool-locations\",\"name\":\"Tool Locations\",\"description\":\"Understand where tools live — agent-level vs task-level\",\"dateModified\":\"2026-02-17T14:37:03.348Z\",\"isPartOf\":{\"@id\":\"https://docs.upsonic.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.upsonic.ai/concepts/tools/tool-locations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.upsonic.ai/concepts/tools/tool-locations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"CONCEPTS\",\"item\":\"https://docs.upsonic.ai/concepts/agents/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tools\",\"item\":\"https://docs.upsonic.ai/concepts/tools/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Tool Locations\",\"item\":\"https://docs.upsonic.ai/concepts/tools/tool-locations\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.upsonic.ai/concepts/tools/tool-locations#article\",\"headline\":\"Tool Locations\",\"name\":\"Tool Locations\",\"description\":\"Understand where tools live — agent-level vs task-level\",\"url\":\"https://docs.upsonic.ai/concepts/tools/tool-locations\",\"mainEntityOfPage\":{\"@id\":\"https://docs.upsonic.ai/concepts/tools/tool-locations#webpage\"},\"dateModified\":\"2026-02-17T14:37:03.348Z\",\"publisher\":{\"@id\":\"https://docs.upsonic.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.upsonic.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Upsonic AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Upsonic AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/concepts/tools/tool-locations.md","siteName":"Upsonic AI","nav":{"global":null,"tabs":[{"tab":"Upsonic Framework","groups":[{"group":"GET STARTED","icon":"https://mintlify-assets.b-cdn.net/compass-2.svg","pages":[{"title":"What is Upsonic","sidebarTitle":"Introduction","href":"/get-started/introduction"},{"title":"Quickstart","sidebarTitle":"Quickstart","href":"/get-started/quickstart"},{"sidebarTitle":"Installation","title":"Installation","href":"/get-started/installation"},{"title":"Guides","sidebarTitle":"Guides","href":"/get-started/guides"},{"title":"Examples","sidebarTitle":"Examples","href":"/get-started/examples"},{"title":"IDE Integration","sidebarTitle":"IDE Integration","href":"/get-started/ide-integration"}]},{"group":"CONCEPTS","icon":"https://mintlify-assets.b-cdn.net/star-2.svg","pages":[{"group":"Agent","icon":"user-robot","pages":[{"title":"Agents","sidebarTitle":"Overview","href":"/concepts/agents/overview"},{"title":"Attributes","href":"/concepts/agents/attributes"},{"title":"Basic Agent Example","sidebarTitle":"Basic Agent Example","href":"/concepts/agents/creating-an-agent"},{"title":"Clanker","sidebarTitle":"Clanker","href":"/concepts/agents/clanker"},{"group":"Usage","pages":[{"title":"Adding Tools","sidebarTitle":"Adding Tools","href":"/concepts/agents/adding-tools"},{"title":"Image Generation","sidebarTitle":"Image Generation","href":"/concepts/agents/image-generation-agent"},{"title":"Running Agents","href":"/concepts/agents/running-agents"},{"title":"Accessing Agent Output","href":"/concepts/agents/access_output"},{"title":"Agent printing","href":"/concepts/agents/printing"},{"title":"Debugging Agents","href":"/concepts/agents/debugging-agents"},{"title":"Agent Metrics","sidebarTitle":"Metrics","href":"/concepts/agents/metrics"}]},{"group":"Advanced","pages":[{"title":"Adding a Memory","sidebarTitle":"Memory","href":"/concepts/agents/advanced/adding-a-memory"},{"title":"Adding Reasoning","sidebarTitle":"Reasoning","href":"/concepts/agents/advanced/adding-reasoning"},{"title":"Adding Thinking","sidebarTitle":"Thinking","href":"/concepts/agents/advanced/adding-thinking"},{"title":"Automatic Model Selection","sidebarTitle":"Model Selection","href":"/concepts/agents/advanced/automatic-model-selection"},{"title":"Reliability \u0026 Retries","sidebarTitle":"Reliability \u0026 Retries","href":"/concepts/agents/advanced/reliability-and-retries"},{"title":"Reflection","sidebarTitle":"Reflection","href":"/concepts/agents/advanced/reflection"},{"title":"Context Compression","sidebarTitle":"Context Compression","href":"/concepts/agents/advanced/context-compression"},{"title":"Company Knowledge","sidebarTitle":"Company Knowledge","href":"/concepts/agents/advanced/company-knowledge"},{"title":"Workspace Configuration","sidebarTitle":"Workspace (AGENTS.md)","href":"/concepts/agents/advanced/workspace"},{"title":"Expose Agent as MCP Server","sidebarTitle":"Agent as MCP","href":"/concepts/agents/advanced/agent-as-mcp"}]}]},{"group":"Autonomous Agent","icon":"robot","pages":[{"title":"Autonomous Agent","sidebarTitle":"Overview","href":"/concepts/autonomous-agent/overview"},{"title":"Attributes","href":"/concepts/autonomous-agent/attributes"},{"title":"Basic Autonomous Agent Example","sidebarTitle":"Basic Example","href":"/concepts/autonomous-agent/examples/basic-autonomous-agent-example"},{"group":"Usage","pages":[{"title":"Creating an Autonomous Agent","sidebarTitle":"Creating an Agent","href":"/concepts/autonomous-agent/creating-an-autonomous-agent"},{"title":"Running an Autonomous Agent","href":"/concepts/autonomous-agent/running-an-autonomous-agent"},{"title":"AGENTS.md","sidebarTitle":"AGENTS.md","href":"/concepts/autonomous-agent/agents-md"}]},{"group":"Advanced","pages":[{"title":"Filesystem Tools","href":"/concepts/autonomous-agent/advanced/filesystem-tools"},{"title":"Memory Integration","href":"/concepts/autonomous-agent/advanced/memory-integration"},{"title":"Shell Tools","href":"/concepts/autonomous-agent/advanced/shell-tools"},{"title":"Workspace Security","href":"/concepts/autonomous-agent/advanced/workspace-security"}]}]},{"group":"Prebuilt Autonomous Agents","icon":"sparkles","tag":"NEW","pages":[{"title":"Prebuilt Autonomous Agents","sidebarTitle":"Overview","href":"/concepts/prebuilt-autonomous-agents/overview"},{"title":"Applied Scientist","sidebarTitle":"Applied Scientist","href":"/concepts/prebuilt-autonomous-agents/applied-scientist"}]},{"group":"Safety Engine (Guardrails)","icon":"shield-check","pages":[{"title":"Safety Engine","sidebarTitle":"Overview","tag":"NEW","href":"/concepts/safety-engine/overview"},{"title":"Policy Points","sidebarTitle":"Policy Points","href":"/concepts/safety-engine/policy-points"},{"group":"Usage","pages":[{"group":"Prebuilt Policies","pages":[{"group":"Privacy \u0026 Compliance","pages":[{"title":"PII Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/pii-policies"},{"title":"Phone Number Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/phone-number-policies"}]},{"group":"Financial \u0026 Legal","pages":[{"title":"Financial Information Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/financial-information-policies"},{"title":"Cryptocurrency Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/cryptocurrency-policies"},{"title":"Legal Information Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/legal-information-policies"},{"title":"Medical Information Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/medical-information-policies"}]},{"group":"Security \u0026 Threats","pages":[{"title":"Cybersecurity Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/cybersecurity-policies"},{"title":"Technical Security Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/technical-security-policies"},{"title":"Fraud Detection Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/fraud-detection-policies"},{"title":"Phishing Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/phishing-policies"},{"title":"Insider Threat Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/insider-threat-policies"}]},{"group":"Content Moderation","pages":[{"title":"Adult Content Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/adult-content-policies"},{"title":"Profanity Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/profanity-policies"},{"title":"Sensitive Social Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/sensitive-social-policies"}]},{"group":"Tool Safety","pages":[{"title":"Tool Safety Policies","href":"/concepts/safety-engine/usage/prebuilt-policies/tool-safety-policies"}]}]},{"group":"Custom Policy","pages":[{"title":"Creating Rule","href":"/concepts/safety-engine/custom-policy/creating-rule"},{"title":"Creating Action","href":"/concepts/safety-engine/custom-policy/creating-action"},{"title":"Creating Policy","href":"/concepts/safety-engine/custom-policy/creating-policy"}]}]},{"group":"Advanced","pages":[{"title":"Policy Feedback Loop","href":"/concepts/safety-engine/policy-feedback-loop"}]}]},{"group":"Task","icon":"list-check","pages":[{"title":"Tasks","sidebarTitle":"Overview","href":"/concepts/tasks/overview"},{"title":"Attributes","href":"/concepts/tasks/attributes"},{"title":"Basic Task Example","sidebarTitle":"Basic Task Example","href":"/concepts/tasks/creating-task"},{"group":"Usage","pages":[{"title":"Adding Tools","sidebarTitle":"Adding Tools","href":"/concepts/tasks/adding-tools"},{"title":"Response Format","sidebarTitle":"Response Format","href":"/concepts/tasks/response-format"},{"title":"Task Result","sidebarTitle":"Task Result","href":"/concepts/tasks/results"},{"title":"Task Metrics","sidebarTitle":"Metrics","href":"/concepts/tasks/metrics"},{"title":"Task Response Caching","sidebarTitle":"Caching","href":"/concepts/tasks/task-caching"},{"group":"Context","pages":[{"title":"Adding Documents to Task Context","sidebarTitle":"Document Context","href":"/concepts/tasks/context-management/adding-document-context-to-task"},{"title":"Adding Tasks to Other Tasks as Context","sidebarTitle":"Task Context","href":"/concepts/tasks/context-management/adding-tasks-to-other-tasks-as-context"},{"title":"Adding Knowledge Base to Task Context","sidebarTitle":"Knowledge Base Context","href":"/concepts/tasks/context-management/adding-knowledge-base-to-task-context"},{"title":"Adding Images to Task Context","sidebarTitle":"Image Context","href":"/concepts/tasks/context-management/adding-images-to-task-context"}]}]}]},{"group":"Tools","icon":"wrench","pages":[{"title":"Tools","sidebarTitle":"Overview","description":"Extend your AI agents with powerful tools","href":"/concepts/tools/overview"},{"title":"Tool Locations","sidebarTitle":"Tool Locations (Agent/Task)","href":"/concepts/tools/tool-locations"},{"group":"Function \u0026 Class Tools","pages":[{"title":"Overview","description":"Create powerful custom tools for your AI agents","href":"/concepts/tools/function-class-tools/overview"},{"title":"Creating Function Tool","href":"/concepts/tools/function-class-tools/creating-function-tool"},{"title":"Creating Class Tool","href":"/concepts/tools/function-class-tools/creating-class-tool"},{"title":"Creating ToolKit","href":"/concepts/tools/function-class-tools/creating-toolkit"},{"title":"Attributes","href":"/concepts/tools/function-class-tools/attributes"},{"group":"Advanced","pages":[{"group":"Behavior \u0026 Control","pages":[{"title":"Required Confirmation","href":"/concepts/tools/function-class-tools/advanced/behavior-control/required-confirmation"},{"title":"Requires User Input","href":"/concepts/tools/function-class-tools/advanced/behavior-control/requires-user-input"},{"title":"User Input Fields","href":"/concepts/tools/function-class-tools/advanced/behavior-control/user-input-fields"},{"title":"External Execution","href":"/concepts/tools/function-class-tools/advanced/behavior-control/external-execution"},{"title":"Show Result","href":"/concepts/tools/function-class-tools/advanced/behavior-control/show-result"},{"title":"Stop After Tool Call","href":"/concepts/tools/function-class-tools/advanced/behavior-control/stop-after-tool-call"},{"title":"Instructions","href":"/concepts/tools/function-class-tools/advanced/behavior-control/instructions"}]},{"group":"Performance","pages":[{"title":"Sequential \u0026 Parallel Run","href":"/concepts/tools/function-class-tools/advanced/performance/sequential-parallel-run"},{"title":"Caching","href":"/concepts/tools/function-class-tools/advanced/performance/caching"},{"title":"Timeout","href":"/concepts/tools/function-class-tools/advanced/performance/timeout"},{"title":"Tool Hooks","href":"/concepts/tools/function-class-tools/advanced/performance/tool-hooks"}]},{"group":"Schema \u0026 Validation","pages":[{"title":"Strict","href":"/concepts/tools/function-class-tools/advanced/schema-validation/strict"},{"title":"Docstring Format","href":"/concepts/tools/function-class-tools/advanced/schema-validation/docstring-format"}]}]}]},{"group":"MCP Tools","pages":[{"title":"Overview","href":"/concepts/tools/mcp-tools/overview"},{"title":"MCPHandler","href":"/concepts/tools/mcp-tools/mcp-handler"},{"title":"MultiMCPHandler","href":"/concepts/tools/mcp-tools/multi-mcp-handler"},{"title":"Authentication","href":"/concepts/tools/mcp-tools/authentication"},{"group":"Examples","pages":[{"title":"GitHub MCP Agent","sidebarTitle":"GitHub","href":"/concepts/tools/mcp-tools/examples/github-agent"},{"title":"Notion MCP Agent","sidebarTitle":"Notion","href":"/concepts/tools/mcp-tools/examples/notion-agent"},{"title":"Stripe MCP Agent","sidebarTitle":"Stripe","href":"/concepts/tools/mcp-tools/examples/stripe-agent"},{"title":"Google Calendar MCP Agent","sidebarTitle":"Google Calendar","href":"/concepts/tools/mcp-tools/examples/google-calendar-agent"},{"title":"Gmail agent","href":"/concepts/tools/mcp-tools/examples/gmail-agent"},{"title":"Twitter (X) MCP Agent","sidebarTitle":"Twitter (X)","href":"/concepts/tools/mcp-tools/examples/twitter-agent"}]}]},{"group":"Ready-to-Use Tools","pages":[{"group":"Search Tools","pages":[{"title":"DuckDuckGo","href":"/concepts/tools/search-tools/duckduckgo"},{"title":"BoCha Search","href":"/concepts/tools/search-tools/bochasearch"},{"title":"Tavily","href":"/concepts/tools/search-tools/tavily"}]},{"group":"Data Tools","pages":[{"title":"YFinanceTools","href":"/concepts/tools/data-tools/yfinance"}]},{"group":"Scraping Tools","pages":[{"title":"ApifyTools","href":"/concepts/tools/scraping-tools/apify"},{"title":"ExaTools","href":"/concepts/tools/scraping-tools/exa"},{"title":"FirecrawlTools","href":"/concepts/tools/scraping-tools/firecrawl"}]},{"group":"Sandbox Tools","pages":[{"title":"DaytonaTools","href":"/concepts/tools/sandbox-tools/daytona"},{"title":"E2BTools","href":"/concepts/tools/sandbox-tools/e2b"}]},{"group":"Model Provider Tools","pages":[{"title":"Supported Providers","href":"/concepts/tools/model-provider-tools/supported-providers"},{"title":"WebSearchTool","href":"/concepts/tools/model-provider-tools/web-search-tool"},{"title":"WebSearchUserLocation","href":"/concepts/tools/model-provider-tools/web-search-user-location"},{"title":"WebFetchTool","href":"/concepts/tools/model-provider-tools/web-fetch-tool"},{"title":"FileSearchTool","href":"/concepts/tools/model-provider-tools/file-search-tool"},{"title":"CodeExecutionTool","href":"/concepts/tools/model-provider-tools/code-execution-tool"},{"title":"UrlContextTool (Deprecated)","href":"/concepts/tools/model-provider-tools/url-context-tool"},{"title":"MCPServerTool","href":"/concepts/tools/model-provider-tools/mcp-server-tool"},{"title":"ImageGenerationTool","href":"/concepts/tools/model-provider-tools/image-generation-tool"}]}]},{"group":"Advanced","pages":[{"title":"Combining Multiple Tools","href":"/concepts/tools/advanced/combining-multiple-tools"},{"title":"Agent as Tool","href":"/concepts/tools/advanced/agent-as-tool"},{"title":"Adding Tools","href":"/concepts/tools/advanced/adding-tools"},{"title":"Removing Tools","href":"/concepts/tools/advanced/removing-tools"}]},{"title":"Best Practices","href":"/concepts/tools/best-practices"}]},{"group":"Usage Registry","icon":"gauge","tag":"NEW","pages":[{"title":"Usage Registry","sidebarTitle":"Usage Registry","href":"/concepts/usage-registry"}]},{"group":"Tracing","icon":"chart-line","pages":[{"title":"OpenTelemetry Tracing","href":"/concepts/tracing/overview"},{"group":"Integrations","pages":[{"group":"Langfuse","pages":[{"title":"Overview","href":"/concepts/tracing/integrations/langfuse/index"},{"group":"Advanced","pages":[{"title":"Scores","href":"/concepts/tracing/integrations/langfuse/advanced/scores"},{"title":"Score Configs","href":"/concepts/tracing/integrations/langfuse/advanced/score-configs"},{"title":"Datasets","href":"/concepts/tracing/integrations/langfuse/advanced/datasets"},{"title":"Annotation Queues","href":"/concepts/tracing/integrations/langfuse/advanced/annotation-queues"},{"title":"Update Trace","href":"/concepts/tracing/integrations/langfuse/advanced/update-trace"}]}]},{"group":"PromptLayer","pages":[{"title":"Overview","href":"/concepts/tracing/integrations/promptlayer/index"},{"title":"PromptLayer Advanced API","href":"/concepts/tracing/integrations/promptlayer/advanced"}]}]}]},{"group":"Skills","icon":"graduation-cap","tag":"NEW","pages":[{"title":"Skills","sidebarTitle":"Overview","href":"/concepts/skills/overview"},{"title":"SKILL.md Format","sidebarTitle":"SKILL.md Format","href":"/concepts/skills/skill-format"},{"title":"Metrics \u0026 Monitoring","sidebarTitle":"Metrics","href":"/concepts/skills/metrics"},{"group":"Loaders","pages":[{"title":"Skill Loaders","sidebarTitle":"Overview","href":"/concepts/skills/loaders/overview"},{"title":"LocalSkills","sidebarTitle":"LocalSkills","href":"/concepts/skills/loaders/local"},{"title":"URLSkills","sidebarTitle":"URLSkills","href":"/concepts/skills/loaders/url"},{"title":"GitHubSkills","sidebarTitle":"GitHubSkills","href":"/concepts/skills/loaders/github"},{"title":"InlineSkills","sidebarTitle":"InlineSkills","href":"/concepts/skills/loaders/inline"},{"title":"BuiltinSkills","sidebarTitle":"BuiltinSkills","href":"/concepts/skills/loaders/builtin"}]},{"group":"Advanced","pages":[{"title":"Advanced Features","sidebarTitle":"Overview","href":"/concepts/skills/advanced/overview"},{"title":"Callbacks","sidebarTitle":"Callbacks","href":"/concepts/skills/advanced/callbacks"},{"title":"Auto-Selection","sidebarTitle":"Auto-Selection","href":"/concepts/skills/advanced/auto-selection"},{"title":"Safety Policies","sidebarTitle":"Safety Policies","href":"/concepts/skills/advanced/safety"},{"title":"Versioning","sidebarTitle":"Versioning","href":"/concepts/skills/advanced/versioning"},{"title":"Dependencies","sidebarTitle":"Dependencies","href":"/concepts/skills/advanced/dependencies"},{"title":"Caching","sidebarTitle":"Caching","href":"/concepts/skills/advanced/caching"}]}]},{"group":"Memory","icon":"brain","pages":[{"title":"Memory","sidebarTitle":"Overview","href":"/concepts/memory/overview"},{"title":"Attributes","href":"/concepts/memory/attributes"},{"title":"Basic Memory Example","href":"/concepts/memory/examples/basic-memory-example"},{"group":"Usage","pages":[{"title":"Choosing Right Memory Types","href":"/concepts/memory/choosing-right-memory-types"},{"group":"Memory Types","pages":[{"title":"Conversation Memory","href":"/concepts/memory/memory-types/conversation-memory"},{"title":"User Analysis Memory","href":"/concepts/memory/memory-types/focus-memory"},{"title":"Summary Memory","href":"/concepts/memory/memory-types/summary-memory"}]},{"group":"Storage Backends","pages":[{"title":"InMemoryStorage","href":"/concepts/memory/storage/inmemory"},{"title":"JSONStorage","href":"/concepts/memory/storage/json"},{"title":"SqliteStorage","href":"/concepts/memory/storage/sqlite"},{"title":"PostgresStorage","href":"/concepts/memory/storage/postgres"},{"title":"RedisStorage","href":"/concepts/memory/storage/redis"},{"title":"MongoStorage","href":"/concepts/memory/storage/mongo"},{"title":"Mem0Storage","href":"/concepts/memory/storage/mem0"},{"title":"AsyncSqliteStorage","sidebarTitle":"SQLite (Async)","href":"/concepts/memory/storage/async-sqlite"},{"title":"AsyncPostgresStorage","sidebarTitle":"PostgreSQL (Async)","href":"/concepts/memory/storage/async-postgres"},{"title":"AsyncMongoStorage","sidebarTitle":"MongoDB (Async)","href":"/concepts/memory/storage/async-mongo"},{"title":"AsyncMem0Storage","sidebarTitle":"Mem0 (Async)","href":"/concepts/memory/storage/async-mem0"},{"title":"Storage Tables","href":"/concepts/memory/storage/storage-tables"}]}]}]},{"group":"Knowledge Base","icon":"book-open","pages":[{"title":"KnowledgeBase","sidebarTitle":"Overview","href":"/concepts/knowledgebase/overview"},{"title":"Attributes","href":"/concepts/knowledgebase/attributes"},{"title":"Getting Started","sidebarTitle":"Getting Started","href":"/concepts/knowledgebase/basic-rag-example"},{"group":"Usage","pages":[{"title":"Putting Files","href":"/concepts/knowledgebase/putting-files"},{"title":"Query Control","href":"/concepts/knowledgebase/query-control"},{"title":"Using as Tool","href":"/concepts/knowledgebase/using-as-tool"},{"title":"Examples","href":"/concepts/knowledgebase/examples"}]},{"group":"Integrations","pages":[{"group":"Embedding Providers","pages":[{"title":"OpenAI Embeddings","href":"/concepts/knowledgebase/embedding-providers/openai"},{"title":"Azure OpenAI Embeddings","href":"/concepts/knowledgebase/embedding-providers/azure"},{"title":"Google Gemini Embeddings","href":"/concepts/knowledgebase/embedding-providers/google"},{"title":"AWS Bedrock Embeddings","href":"/concepts/knowledgebase/embedding-providers/bedrock"},{"title":"HuggingFace Embeddings","href":"/concepts/knowledgebase/embedding-providers/huggingface"},{"title":"FastEmbed Embeddings","href":"/concepts/knowledgebase/embedding-providers/fastembed"},{"title":"Ollama Embeddings","href":"/concepts/knowledgebase/embedding-providers/ollama"}]},{"group":"Document Loaders","pages":[{"title":"PyPDF Loader","href":"/concepts/knowledgebase/document-loaders/pypdf"},{"title":"PdfPlumber Loader","href":"/concepts/knowledgebase/document-loaders/pdfplumber"},{"title":"PyMuPDF Loader","href":"/concepts/knowledgebase/document-loaders/pymupdf"},{"title":"Docling Loader","href":"/concepts/knowledgebase/document-loaders/docling"},{"title":"DOCX Loader","href":"/concepts/knowledgebase/document-loaders/docx"},{"title":"CSV Loader","href":"/concepts/knowledgebase/document-loaders/csv"},{"title":"JSON Loader","href":"/concepts/knowledgebase/document-loaders/json"},{"title":"Markdown Loader","href":"/concepts/knowledgebase/document-loaders/markdown"},{"title":"HTML Loader","href":"/concepts/knowledgebase/document-loaders/html"},{"title":"XML Loader","href":"/concepts/knowledgebase/document-loaders/xml"},{"title":"YAML Loader","href":"/concepts/knowledgebase/document-loaders/yml"},{"title":"Text Loader","href":"/concepts/knowledgebase/document-loaders/text"}]},{"group":"Text Splitters","pages":[{"title":"Recursive Splitter","href":"/concepts/knowledgebase/text-splitters/recursive"},{"title":"Semantic Splitter","href":"/concepts/knowledgebase/text-splitters/semantic"},{"title":"Agentic Splitter","href":"/concepts/knowledgebase/text-splitters/agentic"},{"title":"Character Splitter","href":"/concepts/knowledgebase/text-splitters/character"},{"title":"Markdown Splitter","href":"/concepts/knowledgebase/text-splitters/markdown"},{"title":"HTML Splitter","href":"/concepts/knowledgebase/text-splitters/html"},{"title":"JSON Splitter","href":"/concepts/knowledgebase/text-splitters/json"},{"title":"Python Splitter","href":"/concepts/knowledgebase/text-splitters/python"}]},{"group":"Vector Stores","pages":[{"title":"Vector Stores","sidebarTitle":"Overview","href":"/concepts/knowledgebase/vector-stores/overview"},{"title":"Chroma","href":"/concepts/knowledgebase/vector-stores/chroma"},{"title":"Qdrant","href":"/concepts/knowledgebase/vector-stores/qdrant"},{"title":"Pinecone","href":"/concepts/knowledgebase/vector-stores/pinecone"},{"title":"Milvus","href":"/concepts/knowledgebase/vector-stores/milvus"},{"title":"PGVector","href":"/concepts/knowledgebase/vector-stores/pgvector"},{"title":"FAISS","href":"/concepts/knowledgebase/vector-stores/faiss"},{"title":"Weaviate","href":"/concepts/knowledgebase/vector-stores/weaviate"},{"title":"SuperMemory","href":"/concepts/knowledgebase/vector-stores/supermemory"}]}]},{"group":"Advanced","pages":[{"title":"Advanced Features","sidebarTitle":"Overview","href":"/concepts/knowledgebase/advanced/overview"},{"title":"Intelligent Auto-Detection","sidebarTitle":"Auto-Detection","href":"/concepts/knowledgebase/advanced/auto-detection"},{"title":"Indexed Processing","sidebarTitle":"Indexed Processing","href":"/concepts/knowledgebase/advanced/indexed-processing"},{"title":"Direct Content","sidebarTitle":"Direct Content","href":"/concepts/knowledgebase/advanced/direct-content"},{"title":"Vector Search Tuning","sidebarTitle":"Search Tuning","href":"/concepts/knowledgebase/advanced/vector-search-params"},{"title":"Document Management","sidebarTitle":"Document Management","href":"/concepts/knowledgebase/advanced/document-management"},{"title":"Storage Persistence","href":"/concepts/knowledgebase/advanced/storage-persistence"},{"title":"Isolated Search","href":"/concepts/knowledgebase/advanced/isolate-search"}]}]},{"group":"Team","icon":"people-group","pages":[{"title":"Team","sidebarTitle":"Overview","href":"/concepts/team/overview"},{"title":"Attributes","href":"/concepts/team/attributes"},{"title":"Basic Team Example","href":"/concepts/team/examples/basic-team-example"},{"group":"Usage","pages":[{"group":"Team Modes","pages":[{"title":"Choosing Right Team Mode","href":"/concepts/team/choosing-right-team-mode"},{"title":"Sequential","href":"/concepts/team/modes/sequential"},{"title":"Coordinate","href":"/concepts/team/modes/coordinate"},{"title":"Route","href":"/concepts/team/modes/route"}]},{"title":"Assigning Tasks Manually","href":"/concepts/team/assigning-tasks-manually"},{"title":"Team Metrics","sidebarTitle":"Metrics","href":"/concepts/team/metrics"}]},{"group":"Advanced","pages":[{"title":"Expose Team as MCP Server","sidebarTitle":"Team as MCP","href":"/concepts/team/advanced/team-as-mcp"},{"title":"Nested Teams","href":"/concepts/team/advanced/nested-teams"}]}]},{"group":"LLM Support","icon":"brain-circuit","pages":[{"title":"LLM","sidebarTitle":"Overview","href":"/concepts/llm-support/llm-overview"},{"title":"Model as String","href":"/concepts/llm-support/model-as-string"},{"title":"Compatibility Overview","href":"/concepts/llm-support/compatibility-overview"},{"group":"Native Providers","pages":[{"title":"OpenAI Chat","href":"/concepts/llm-support/providers/openai-chat"},{"title":"OpenAI Responses","href":"/concepts/llm-support/providers/openai-responses"},{"title":"Anthropic","href":"/concepts/llm-support/providers/anthropic"},{"title":"Google (Gemini)","href":"/concepts/llm-support/providers/google"},{"title":"Grok","href":"/concepts/llm-support/providers/grok"},{"title":"Mistral","href":"/concepts/llm-support/providers/mistral"},{"title":"Cohere","href":"/concepts/llm-support/providers/cohere"},{"title":"Moonshot AI","href":"/concepts/llm-support/providers/moonshotai"},{"title":"xAI","href":"/concepts/llm-support/providers/xai"}]},{"group":"Cloud Providers","pages":[{"title":"Azure OpenAI","href":"/concepts/llm-support/providers/azure"},{"title":"AWS Bedrock","href":"/concepts/llm-support/providers/bedrock"},{"title":"Huggingface","href":"/concepts/llm-support/providers/huggingface"},{"title":"Heroku","href":"/concepts/llm-support/providers/heroku"},{"title":"OVHcloud","href":"/concepts/llm-support/providers/ovhcloud"}]},{"group":"Local Providers","pages":[{"title":"Ollama","href":"/concepts/llm-support/providers/ollama"},{"title":"vLLM","href":"/concepts/llm-support/providers/vllm"},{"title":"LM Studio","href":"/concepts/llm-support/providers/lmstudio"}]},{"group":"Model Gateways","pages":[{"title":"Groq","href":"/concepts/llm-support/providers/groq"},{"title":"LiteLLM","href":"/concepts/llm-support/providers/litellm"},{"title":"NVIDIA NIM","href":"/concepts/llm-support/providers/nvidia"},{"title":"OpenRouter","href":"/concepts/llm-support/providers/openrouter"},{"title":"Cerebras","href":"/concepts/llm-support/providers/cerebras"},{"title":"GitHub Models","href":"/concepts/llm-support/providers/github"},{"title":"Outlines","href":"/concepts/llm-support/providers/outlines"},{"title":"SambaNova","href":"/concepts/llm-support/providers/sambanova"},{"title":"Together","href":"/concepts/llm-support/providers/together"},{"title":"Vercel","href":"/concepts/llm-support/providers/vercel"}]},{"title":"OpenAI-Like Models","href":"/concepts/llm-support/openai-compatible"},{"title":"Error Handling","href":"/concepts/llm-support/error-handling"}]},{"group":"OCR","icon":"scanner-image","pages":[{"title":"OCR","sidebarTitle":"Overview","href":"/concepts/ocr/overview"},{"title":"Architecture","href":"/concepts/ocr/architecture"},{"title":"Attributes","href":"/concepts/ocr/attributes"},{"title":"Basic OCR Example","href":"/concepts/ocr/examples/basic-ocr-example"},{"group":"Usage","pages":[{"title":"Create an OCR","href":"/concepts/ocr/create-an-ocr"},{"title":"Running an OCR","href":"/concepts/ocr/running-an-ocr"},{"group":"Engines","pages":[{"title":"EasyOCR","href":"/concepts/ocr/engines/easyocr"},{"title":"RapidOCR","href":"/concepts/ocr/engines/rapidocr"},{"title":"Tesseract","href":"/concepts/ocr/engines/tesseract"},{"title":"DeepSeek OCR (VLLM)","href":"/concepts/ocr/engines/deepseek-ocr"},{"title":"DeepSeek OCR (Ollama)","href":"/concepts/ocr/engines/deepseek-ocr-ollama"},{"title":"PaddleOCR","href":"/concepts/ocr/engines/paddleocr"}]},{"title":"Timeout","href":"/concepts/ocr/timeout"},{"title":"Metrics and Performance","href":"/concepts/ocr/metrics-and-performance"}]},{"group":"Advanced","pages":[{"title":"Advanced Features","href":"/concepts/ocr/advanced-features"},{"title":"Exception Handling","href":"/concepts/ocr/exception-handling"}]}]},{"group":"HITL (Human in the Loop)","icon":"user-check","pages":[{"title":"Human-in-the-Loop (HITL)","sidebarTitle":"Overview","href":"/concepts/hitl/overview"},{"group":"Usage","pages":[{"title":"Durable Execution","sidebarTitle":"Durable Execution","href":"/concepts/hitl/durable-execution"},{"title":"External Tool Execution","sidebarTitle":"External Tool Execution","href":"/concepts/hitl/external-tool-execution"},{"title":"Cancel Run","sidebarTitle":"Cancel Run","href":"/concepts/hitl/cancel-run"},{"title":"User Input","sidebarTitle":"User Input","href":"/concepts/hitl/user-input"},{"title":"Dynamic User Input","sidebarTitle":"Dynamic User Input","href":"/concepts/hitl/dynamic-user-input"},{"title":"User Confirmation","sidebarTitle":"User Confirmation","href":"/concepts/hitl/user-confirmation"}]}]},{"group":"Culture","icon":"users-gear","pages":[{"title":"Culture","sidebarTitle":"Overview","tag":"NEW","href":"/concepts/culture/overview"}]},{"group":"Deep Agent","icon":"brain-circuit","pages":[{"title":"Deep Agent","sidebarTitle":"Overview","href":"/concepts/deep-agent/overview"},{"title":"Attributes","href":"/concepts/deep-agent/attributes"},{"title":"Basic Deep Agent Example","href":"/concepts/deep-agent/examples/basic-deep-agent-example"},{"group":"Usage","pages":[{"title":"Planning","href":"/concepts/deep-agent/capabilities/planning"},{"title":"To-Do Management","href":"/concepts/deep-agent/capabilities/to-do-management"},{"title":"Virtual File System","href":"/concepts/deep-agent/capabilities/virtual-file-system"},{"title":"Subagent Generation","href":"/concepts/deep-agent/capabilities/subagent-generation"},{"title":"Storage Backends","href":"/concepts/deep-agent/capabilities/backends"}]},{"group":"Advanced","pages":[{"title":"Advanced","href":"/concepts/deep-agent/advanced"},{"title":"Software Developer Agent","href":"/concepts/deep-agent/examples/software-developer-agent"},{"title":"Research and Analysis Agent","href":"/concepts/deep-agent/examples/research-and-analysis-agent"},{"title":"Content Creation Agent","href":"/concepts/deep-agent/examples/content-creation-agent"}]}]},{"group":"Direct LLM Call","icon":"message-bot","pages":[{"title":"Direct","sidebarTitle":"Overview","href":"/concepts/direct-llm-call/overview"},{"title":"Attributes","href":"/concepts/direct-llm-call/attributes"},{"title":"Basic Direct LLM Call Example","href":"/concepts/direct-llm-call/examples/basic-direct-llm-call-example"},{"group":"Usage","pages":[{"title":"Image Processing","href":"/concepts/direct-llm-call/image-processing"}]}]},{"group":"Interfaces","icon":"plug","pages":[{"title":"Interfaces","sidebarTitle":"Overview","href":"/concepts/interfaces/Overview"},{"group":"Usage","pages":[{"title":"Slack","sidebarTitle":"Slack","href":"/concepts/interfaces/slack"},{"title":"WhatsApp","sidebarTitle":"WhatsApp","href":"/concepts/interfaces/whatsapp"},{"title":"Telegram","sidebarTitle":"Telegram","tag":"NEW","href":"/concepts/interfaces/telegram"},{"title":"Gmail","sidebarTitle":"Gmail","href":"/concepts/interfaces/gmail"},{"title":"Mail (SMTP/IMAP)","sidebarTitle":"Mail","href":"/concepts/interfaces/mail"}]},{"group":"Advanced","pages":[{"title":"Telegram Advanced","sidebarTitle":"Telegram Advanced","href":"/concepts/interfaces/telegram-advanced"}]}]},{"group":"Chat","icon":"messages","pages":[{"title":"Chat","sidebarTitle":"Overview","href":"/concepts/chat/overview"},{"title":"Attributes","href":"/concepts/chat/attributes"},{"title":"Basic Example","href":"/concepts/chat/examples/basic"},{"group":"Usage","pages":[{"title":"Creating a Chat","href":"/concepts/chat/creating-a-chat"},{"title":"Running a Chat","href":"/concepts/chat/running-a-chat"},{"title":"History Management","href":"/concepts/chat/history-management"},{"title":"Chat Metrics","sidebarTitle":"Metrics","href":"/concepts/chat/metrics"},{"title":"Storage Backends","href":"/concepts/chat/storage-backends"}]},{"group":"Advanced","pages":[{"title":"Context Manager","href":"/concepts/chat/advanced/context-manager"},{"title":"Error Handling","href":"/concepts/chat/advanced/error-handling"},{"title":"Memory Strategies","href":"/concepts/chat/advanced/memory-strategies"},{"title":"Multi-Session","href":"/concepts/chat/examples/multi-session"},{"title":"Persistent Storage","href":"/concepts/chat/examples/persistent-storage"},{"title":"User Profile","href":"/concepts/chat/examples/user-profile"}]}]},{"group":"StateGraph","icon":"diagram-project","pages":[{"title":"StateGraph","sidebarTitle":"Overview","href":"/concepts/stategraph/overview"},{"title":"Attributes","href":"/concepts/stategraph/attributes"},{"title":"Quick Start","href":"/concepts/stategraph/quickstart"},{"group":"Usage","pages":[{"title":"Core Concepts","href":"/concepts/stategraph/core-concepts"}]},{"group":"Advanced","pages":[{"title":"Advanced Features","href":"/concepts/stategraph/advanced/advanced-features"},{"title":"Building AI Agents","href":"/concepts/stategraph/advanced/building-agents"},{"title":"Human-in-the-Loop","href":"/concepts/stategraph/advanced/human-in-loop"},{"title":"Persistence \u0026 Time Travel","href":"/concepts/stategraph/advanced/persistence"},{"title":"Reliability \u0026 Resilience","href":"/concepts/stategraph/advanced/reliability"}]}]},{"group":"UEL","icon":"layer-group","pages":[{"title":"UEL (Upsonic Expression Language)","sidebarTitle":"Overview","href":"/concepts/uel/overview"},{"title":"Attributes","href":"/concepts/uel/attributes"},{"group":"Advanced","pages":[{"title":"Async Execution","href":"/concepts/uel/advanced/async-execution"},{"title":"Conditional Routing","href":"/concepts/uel/advanced/conditional-routing"},{"title":"Custom Chains","href":"/concepts/uel/advanced/custom-chains"},{"title":"Parallel Execution","href":"/concepts/uel/advanced/parallel-execution"},{"title":"RAG Patterns","href":"/concepts/uel/advanced/rag-patterns"},{"title":"Model Memory Modes","href":"/concepts/uel/advanced/memory-modes"},{"title":"Visualization","href":"/concepts/uel/advanced/visualization"}]}]},{"group":"Simulation","icon":"flask","pages":[{"title":"Simulation","sidebarTitle":"Overview","href":"/concepts/simulation/overview"},{"group":"Usage","pages":[{"title":"Merchant Revenue Forecast","href":"/concepts/simulation/scenarios/merchant_revenue_forecast"}]}]},{"group":"Evals","icon":"chart-line","pages":[{"title":"Evals","sidebarTitle":"Overview","href":"/concepts/evals/overview"},{"group":"Usage","pages":[{"group":"Reliability Evals","pages":[{"title":"Reliability Evaluation","sidebarTitle":"Overview","href":"/concepts/evals/usage/reliability/introduction"},{"title":"Reliability Evaluation with Agent","sidebarTitle":"Agent","href":"/concepts/evals/usage/reliability/agent"},{"title":"Reliability Evaluation with Team","sidebarTitle":"Team","href":"/concepts/evals/usage/reliability/team"},{"title":"Reliability Evaluation with Graph","sidebarTitle":"Graph","href":"/concepts/evals/usage/reliability/graph"}]},{"group":"Performance Evals","pages":[{"title":"Performance Evaluation","sidebarTitle":"Overview","href":"/concepts/evals/usage/performance/introduction"},{"title":"Performance Evaluation with Agent","sidebarTitle":"Agent","href":"/concepts/evals/usage/performance/agent"},{"title":"Performance Evaluation with Team","sidebarTitle":"Team","href":"/concepts/evals/usage/performance/team"},{"title":"Performance Evaluation with Graph","sidebarTitle":"Graph","href":"/concepts/evals/usage/performance/graph"}]},{"group":"Accuracy Evals","pages":[{"title":"Accuracy Evaluation","sidebarTitle":"Overview","href":"/concepts/evals/usage/accuracy/introduction"},{"title":"Accuracy Evaluation with Agent","sidebarTitle":"Agent","href":"/concepts/evals/usage/accuracy/agent"},{"title":"Accuracy Evaluation with Team","sidebarTitle":"Team","href":"/concepts/evals/usage/accuracy/team"},{"title":"Accuracy Evaluation with Graph","sidebarTitle":"Graph","href":"/concepts/evals/usage/accuracy/graph"}]}]}]},{"group":"Canvas","icon":"palette","pages":[{"title":"Canvas","href":"/concepts/canvas"}]},{"group":"Graph","icon":"sitemap","pages":[{"title":"Graph","href":"/concepts/graph"}]}]},{"group":"STARTING AN AGENT PROJECT","pages":[{"title":"Overview","href":"/CLI/overview"},{"title":"Initialization","href":"/CLI/initialization"},{"title":"Start Agent API","href":"/CLI/start-agent-api"}]},{"group":"READY TO USE SNIPPETS","pages":[{"title":"AGENTS.md","sidebarTitle":"AGENTS.md","href":"/ready-to-use-snippets/agents-md"},{"title":"BOOTSTRAP.md","href":"/ready-to-use-snippets/bootstrap"},{"title":"SKILL.md","sidebarTitle":"SKILL.md","href":"/ready-to-use-snippets/skill"},{"title":"SOUL.md","sidebarTitle":"SOUL.md","href":"/ready-to-use-snippets/soul-md"},{"title":"USER.md","sidebarTitle":"USER.md","href":"/ready-to-use-snippets/user-md"}]},{"group":"DEPLOYMENT","pages":[{"title":"Deployment Overview","sidebarTitle":"Overview","href":"/deployment/overview"},{"title":"Deploy via FastAPI","sidebarTitle":"FastAPI","href":"/deployment/fastapi"},{"title":"Deploy via Django","sidebarTitle":"Django","href":"/deployment/django"},{"title":"Debugging","href":"/concepts/debugging"}]},{"group":"FURTHER READINGS","pages":[{"title":"Telemetry","href":"/further-readings/telemetry"},{"title":"Comparison","href":"/further-readings/comparison"}]}]},{"tab":"AgentOS","pages":[{"title":"AgentOS","href":"/agentos/get-started/introduction"}]},{"tab":"Universal Commerce Protocol (UCP)","pages":[{"title":"Universal Commerce Protocol (UCP)","href":"/ucp"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/1-create-a-task"}]},{"tab":"Reference","pages":[{"title":"Reference","href":"/reference/agent/agent"}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/examples/overview/introduction"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/overview"}]},{"tab":"Community","pages":[{"title":"Community","href":"/community"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Tool Locations - Upsonic AI","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}