> ## Documentation Index
> Fetch the complete documentation index at: https://friendli.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Tool Assisted API
> Use the Friendli Tool Assisted API to extend chat completions with built-in and integrated tools. Models can call a calculator, Python interpreter, and web search automatically.
export const ToolIcon = () => {
return ;
};
export const ChatIcon = () => {
return ;
};
**Tool Assisted API** extends [Friendli Model APIs](/guides/model-apis/introduction) chat completions with tool calling. The model decides when to call a tool, runs it, and uses the result to return a more accurate, up-to-date response—without you wiring up each tool yourself.
Two kinds of tools are available:
* **Built-in tools**: Available with no external setup—free and instantly usable, such as a calculator and a Python interpreter.
* **Integrated tools**: Backed by external services for production-grade performance. They require connecting your API key for the service, such as Linkup web search.
## Built-In Tools
Tool Assisted API automatically selects the best tool to perform an action based on user input when a specific tool is enabled. Built-in tools are available without any external integration, making them free to use and instantly accessible.
See the list below for available built-in tools.
### `math:calculator`
**Description:**
Performs basic arithmetic operations like addition, subtraction, multiplication, division, and more complex calculations like square roots or exponents.
It is useful for any tasks requiring mathematical computation.
**When Used:**
Automatically called when mathematical expressions or calculations are required.\
Whether you're solving equations, calculating percentages, or handling financial calculations, this tool performs the task for you.
### `code:python-interpreter`
**Description:**
Executes Python code directly within the platform for custom scripts, data processing, or automation.
You can run Python scripts, test snippets of code, or automate tasks through coding logic.
**When Used:**
Automatically called when tasks involve writing or running Python scripts, such as custom data manipulations or logic-based automation.
## Integrated Tools
Tool Assisted API can also make use of integrated tools, which operate in the same way as built-in tools but require a connection to external services.
Because they leverage specialized APIs or platforms, integrated tools are more likely to be production-ready compared to built-in tools, offering higher performance and broader functionality.
### `linkup:search`
**Description:**
[Linkup](https://www.linkup.so) seamlessly integrates with models served by FriendliAI to provide real-time web search capabilities. This enables AI applications to retrieve up-to-date facts, events, and information beyond the model’s training data, complete with accurate citations.
Grounding responses in real-time data, Linkup improves precision, accuracy, and factuality while delivering production-ready state-of-the-art web information retrieval.
**When Used:**
Automatically called when you need to retrieve current information from the web, such as recent news, real-time data, or up-to-date facts.
This tool is particularly useful for tasks requiring accurate and reliable web search results.
This tool requires integration setup for SDK/API usage. You can obtain your Linkup API key from [app.linkup.so](https://app.linkup.so) and integrate it in the [Friendli Suite > Personal Settings > Integrations](https://friendli.ai/suite/~/setting/integrations).
For more details, see the [Linkup integration guide](/integrate/sdks/linkup#for-sdk%2Fapi-usage).
## Explore APIs
To get started with Tool Assisted APIs, follow this tutorial: [**Tool Calling with Model APIs**](/guides/tutorials/tool-calling-with-model-apis).
For more details, check out the API Reference documentation below:
} href="/openapi/model-apis/chat-completions">
Discover how to generate text through interactive conversations.
} href="/openapi/model-apis/tool-assisted-chat-completions">
Learn how to enhance responses with tool-assisted chat completions using built-in tools.
**Description:**
[Linkup](https://www.linkup.so) seamlessly integrates with models served by FriendliAI to provide real-time web search capabilities. This enables AI applications to retrieve up-to-date facts, events, and information beyond the model’s training data, complete with accurate citations.
Grounding responses in real-time data, Linkup improves precision, accuracy, and factuality while delivering production-ready state-of-the-art web information retrieval.
**When Used:**
Automatically called when you need to retrieve current information from the web, such as recent news, real-time data, or up-to-date facts.
This tool is particularly useful for tasks requiring accurate and reliable web search results.