For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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

The list displays:

  • Name

  • Description

  • Project

  • Actions

To add a new Toolbox, click Create.


Creating a Toolbox

When you click Create, the configuration panel will open.

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

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.

The Toolbox association screen will open.

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:

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.

Last updated