> For the complete documentation index, see [llms.txt](https://alludium.gitbook.io/alludium-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alludium.gitbook.io/alludium-docs/administration/6.-applications/8.-tools.md).

# Tools

Tools are the specific actions exposed by an integration. A tool might search documentation, read CRM records, create a calendar event, retrieve files, or update a project management system.

**Location:** Administration -> Integrations -> open an integration -> Available Tools

## What A Tool Is

A tool is a structured action with defined inputs and outputs. Tools let agents and workflows do useful work beyond generating text.

Examples:

* Search a documentation source
* Retrieve company records from a CRM
* List files in a drive
* Create a task in a project management system
* Send a message through a communication tool

## Tool Access Chain

Tool access usually follows this chain:

Integration -> Connection -> Tool -> Agent, task, project setup, or automation

The integration defines the tool. A connection authorizes access when needed. A workflow can use the tool only when it has been configured or allowed to do so.

## Tool Scope

Choose only the tools a workflow needs. Narrow tool access improves safety and makes agent behavior easier to audit.

When deciding whether to enable a tool, ask:

* Does the workflow need live data?
* Does it need write access or only read access?
* Which user or workspace connection should it use?
* Should this access be available to one agent, a task type, a project setup, or an automation?

## Tool Auditing

Tool calls should be visible in the relevant execution, task, agent, or automation history where available. Use that history to understand what data was sent, what came back, and whether the workflow used the expected integration.

## Troubleshooting Tools

If a tool does not work:

1. Confirm the integration is available.
2. Confirm the required connection is active.
3. Confirm the workflow has access to the specific tool.
4. Check whether the provider returned an authentication or permission error.
5. Re-test after reconnecting or updating the workflow configuration.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://alludium.gitbook.io/alludium-docs/administration/6.-applications/8.-tools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.