> For the complete documentation index, see [llms.txt](https://docs.poweromni.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.poweromni.ai/en/administration-and-configuration/artifacts/toolboxes.md).

# Toolboxes

**Toolboxes** allow you to group multiple tools into a single set and make them available to Power Omni Agents.

Instead of configuring related resources separately, you can create a Toolbox for a specific purpose, select the tools it should include, and then associate it with the agents that need those resources.

For example, a customer support Toolbox can include a ticketing API, an MCP server, and Web Search.

#### Accessing Toolboxes

Go to:

**Settings → Artifacts → Toolboxes**<br>

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2FirW1SDS0OdLsJEtZ1npy%2Fimage.png?alt=media&amp;token=61345f42-5470-4f73-ad6d-cba23dc3334c" alt=""><figcaption></figcaption></figure>

On the Toolboxes page, you can view existing Toolboxes and create new ones.

The list displays:

* Name
* Description
* Project
* Actions

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2FHheRRxwaOzvxELHH2JqM%2Fimage.png?alt=media&amp;token=41d98672-db4f-41ae-a514-a05e7982934b" alt=""><figcaption></figcaption></figure>

To add a new Toolbox, click **Create**.

***

### Creating a Toolbox

When you click **Create**, the configuration panel will open.<br>

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2FfUwBwMeOWv4yEt92IfVK%2Fimage.png?alt=media&amp;token=9c738fff-dfe5-4a05-96d2-3a3625ede8f8" alt=""><figcaption></figcaption></figure>

Fill in the following fields:

#### Project

The Microsoft Foundry project associated with your Power Omni environment will be selected automatically.

#### Name

Enter a name to identify the Toolbox.

Examples:

* Customer Support
* Web Research
* Document Search
* Financial Integrations

#### Description

Describe when the Toolbox should be used.

Example:

`Tools used by agents responsible for searching and managing customer support tickets.`

A clear description makes it easier to understand the purpose of the Toolbox when associating it with agents.

***

### Adding Tools

In the **Tools** section, choose which resources should be included in the Toolbox.

Power Omni organizes the available tools by category.

**MCP Server Connectors**

Allows you to add MCP servers available for the selected project.

If no MCP server is available, the interface will display:

`No MCP connector available.`

**OpenAPI Connectors**

Allows you to add connectors created from APIs that use the OpenAPI specification.

Available connectors are displayed in the list for selection.

**Logic App Connectors**

Allows you to include Logic App integrations available for the project.

**N8N Connectors**

Allows you to include N8N integrations available for the project.

**Native Tools**

You can also add tools provided directly by Power Omni.

Currently, the following tools can be selected:

* **File Handler**
* **Web Search**

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2FiiK7lp3jKAstVKJc7NhN%2Fimage.png?alt=media&amp;token=5cbadd4b-8e5c-4464-b943-f4e60d85d560" alt=""><figcaption></figcaption></figure>

Select the tools you want to include and click **Save**.

The Toolbox will then be available on the project's Toolboxes page.

***

### Associating a Toolbox with an Agent

After creating a Toolbox, you need to define which agents can use it.

Go to:

**Settings → Artifacts → Agents**

Find the desired agent and open the actions menu.

Select **Toolboxes**.<br>

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2FzAZqWJDW8AMtG6oEfrkr%2Fimage.png?alt=media&amp;token=f2807ccf-3bb4-486b-ab98-615b50834012" alt=""><figcaption></figcaption></figure>

The Toolbox association screen will open.

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2F6pbtpl0wNNRgrUEtrc9M%2Fimage.png?alt=media&amp;token=088944ab-8ba2-4e16-962f-e7e5102c6ac1" alt=""><figcaption></figcaption></figure>

At the top, you will see the Toolboxes that are already associated with the agent.

In the **Select Toolboxes** section, the available Toolboxes are listed for selection.

After selecting the Toolboxes the agent should be able to use, click **Save Selection**.

The agent will then have access to the tools included in the selected Toolboxes.

***

### Toolboxes and Connectors

Toolboxes and Connectors serve different purposes.

A **Connector** represents a specific integration, such as an MCP server, OpenAPI API, Logic App, or N8N integration.

A **Toolbox** groups these tools into a single set.

For example:

```
Toolbox: Customer Support├── OpenAPI - Tickets├── MCP - Corporate System├── Web Search└── File Handler
```

This Toolbox can be associated with customer support agents without having to rebuild the same set of tools for each agent.

***

#### Summary

The configuration flow is:

**Create or configure the tools → Create the Toolbox → Select the tools → Save → Associate the Toolbox with an Agent**

Toolboxes make it easier to organize and reuse sets of tools across Power Omni Agents.
