> 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/administracao-e-configuracao/artefatos/toolboxes.md).

# Toolboxes

As **Toolboxes** permitem reunir várias ferramentas em um único conjunto e disponibilizá-las aos Agentes do Power Omni.

Em vez de configurar recursos relacionados separadamente, você pode criar uma Toolbox para uma finalidade específica, selecionar as ferramentas que fazem parte dela e depois associá-la aos agentes que precisam desses recursos.

Por exemplo, uma Toolbox de atendimento pode reunir uma API de tickets, um servidor MCP e a Busca na Web.

### Acessar Toolboxes

Acesse:

**Configurações → Artefatos → Toolboxes**<br>

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F4wDRQcViAeyvPCd53VKA%2Fimage.png?alt=media&amp;token=d988c125-7dc9-4e16-b51a-8537c7a962ec" alt=""><figcaption></figcaption></figure>

Na tela de Toolboxes você pode visualizar os conjuntos já cadastrados e criar novas configurações.

A listagem apresenta:

* Nome
* Descrição
* Projeto
* Ações<br>

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F7cQK8Wph54Ya3g2S8CYb%2Fimage.png?alt=media&amp;token=363531a0-7318-4051-8c8e-5ab877258de4" alt=""><figcaption></figcaption></figure>

Para adicionar uma nova Toolbox, clique em **Criar**.

***

## Criar uma Toolbox

Ao clicar em **Criar**, será aberto o painel de configuração.

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FEeV3X0oRVOYH2BXR3QEr%2Fimage.png?alt=media&amp;token=18dd94a8-3e05-4cd7-977e-974696b63dab" alt=""><figcaption></figcaption></figure>

Preencha os campos:

### Projeto

Projeto do Microsoft Foundry associado ao seu Power Omni vai ser selecionado automaticamente.

### Nome

Informe um nome para identificar a Toolbox.

Exemplos:

* Atendimento ao Cliente
* Pesquisa na Web
* Consulta de Documentos
* Integrações Financeiras

### Descrição

Informe quando a Toolbox deve ser utilizada.

Exemplo:

`Ferramentas utilizadas pelos agentes responsáveis por consultar e gerenciar chamados de atendimento.`

Uma descrição clara ajuda a identificar a finalidade da Toolbox quando ela for associada aos agentes.

***

## Adicionar ferramentas

Na seção **Tools**, escolha quais recursos farão parte da Toolbox.

O Power Omni organiza as ferramentas disponíveis por categoria.

#### Conectores MCP Server

Permite adicionar servidores MCP disponíveis para o projeto selecionado.

Caso nenhum MCP esteja disponível, a interface exibirá:

`Nenhum conector MCP disponível.`

#### Conectores OpenAPI

Permite adicionar conectores criados a partir de APIs que utilizam o padrão OpenAPI.

Os conectores disponíveis aparecem na lista para seleção.

#### Conectores Logic App

Permite incluir integrações com Logic Apps disponíveis no projeto.

#### Conectores N8N

Permite incluir integrações N8N disponíveis no projeto.

#### Ferramentas nativas

Também é possível adicionar ferramentas fornecidas diretamente pelo Power Omni.

Atualmente, a tela permite selecionar:

* **Manipulador de Arquivos**
* **Busca na Web**

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2Fb9vb4vWaLfupqqxReOm7%2Fimage.png?alt=media&amp;token=ff7ea03f-5905-49e2-85c4-9338c562c885" alt=""><figcaption></figcaption></figure>

Marque as ferramentas que deseja incluir e clique em **Salvar**.

A Toolbox ficará disponível na página de Toolboxes do projeto.

***

## Associar uma Toolbox a um Agente

Depois de criar a Toolbox, é necessário definir quais agentes poderão utilizá-la.

Acesse:

**Configurações → Artefatos → Agentes**

Localize o agente desejado e abra o menu de ações.

Selecione **Toolboxes**.

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FQ1gxr6jca1EI8Wgf8fX4%2Fimage.png?alt=media&amp;token=f4560909-1347-4235-9289-bca7e6a39e88" alt=""><figcaption></figcaption></figure>

Será aberta a tela de associação de Toolboxes.

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F5K4nejHkla4FCVhBtoOy%2Fimage.png?alt=media&amp;token=e9f9e596-123f-4f1a-b226-847e87334cf8" alt=""><figcaption></figcaption></figure>

Na parte superior são exibidas as Toolboxes que já estão associadas ao agente.

Na seção **Selecionar Toolboxes**, são apresentadas as Toolboxes disponíveis para seleção.

Depois de definir quais Toolboxes o agente poderá utilizar, clique em **Salvar Seleção**.

O agente passa então a ter acesso às ferramentas incluídas nas Toolboxes selecionadas.

***

## Toolboxes e Conectores

Toolboxes e Conectores possuem funções diferentes.

Um **Conector** representa uma integração específica, como um servidor MCP, uma API OpenAPI, uma Logic App ou uma integração N8N.

Uma **Toolbox** reúne essas ferramentas em um conjunto.

Por exemplo:

```
Toolbox: Atendimento

├── OpenAPI - Tickets
├── MCP - Sistema Corporativo
├── Busca na Web
└── Manipulador de Arquivos
```

Essa Toolbox pode ser associada aos agentes que trabalham com atendimento, sem que seja necessário reconstruir o mesmo conjunto de ferramentas para cada agente.

***

### Resumo

O fluxo de configuração é:

**Criar ou configurar as ferramentas → Criar a Toolbox → Selecionar as ferramentas → Salvar → Associar a Toolbox ao Agente**

As Toolboxes tornam mais simples organizar e reutilizar conjuntos de ferramentas entre os agentes do Power Omni.