> 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/skills.md).

# Skills

O menu **Skills** permite criar e versionar instruções reutilizáveis para os agentes do Power OMNI. As Skills são armazenadas no projeto e vinculadas a uma **Toolbox**, que depois é conectada ao agente.

Uma Skill ensina ao agente **como executar uma tarefa**. Ela pode definir um processo, regras internas, critérios de decisão, formato de resposta e limites que devem ser respeitados.

{% hint style="info" %}

### **Importante:**

Skills e ferramentas têm funções diferentes. Uma ferramenta permite que o agente consulte dados ou execute uma ação. Uma Skill orienta como ele deve trabalhar em uma situação específica.
{% endhint %}

### Como funciona

O uso de uma Skill no Power OMNI segue este fluxo:

{% stepper %}
{% step %}
Criar a Skill
{% endstep %}

{% step %}
Adicionar à Toolbox
{% endstep %}

{% step %}
Conectar ao agente
{% endstep %}

{% step %}
Usar durante a conversa
{% endstep %}
{% endstepper %}

Esse modelo permite reutilizar a mesma orientação em vários agentes sem copiar o conteúdo para as instruções de cada um.

### Acessar o menu Skills

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F4XxsCeX5dF53fRkEranq%2Fimage.png?alt=media&amp;token=b2f9e00e-a73d-4fe3-a644-9162ec0677bf" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
Entre no Portal de Administração do Power OMNI
{% endstep %}

{% step %}
Abra Artefatos
{% endstep %}

{% step %}
Selecione Skills
{% endstep %}
{% endstepper %}

### Criar uma Skill

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FWdyz16iRc6BXpaCThe1J%2Fimage.png?alt=media&amp;token=1b6c7c71-2be8-4b99-a6c3-89027497359f" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
Acesse Skills

Acesse **Artefatos > Skills**.
{% endstep %}

{% step %}
Clique em Criar

Clique em **Criar** no canto superior direito.
{% endstep %}

{% step %}
Preencha o formulário lateral

<table><thead><tr><th width="158">Campo</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Projeto</strong></td><td>Selecione o projeto do Microsoft Foundry em que a Skill será armazenada.</td></tr><tr><td><strong>Nome</strong></td><td>Informe um identificador único para a Skill. Depois da criação, esse nome não poderá ser alterado.</td></tr><tr><td><strong>Descrição</strong></td><td>Escreva quando o agente deve usar a Skill. Essa informação ajuda o agente a decidir se deve carregar as instruções.</td></tr><tr><td><strong>Instruções</strong></td><td>Escreva, em Markdown, o processo e as regras que o agente deve seguir ao usar a Skill.</td></tr></tbody></table>
{% endstep %}

{% step %}
Salve a Skill

Depois de preencher os campos, clique em **Salvar**. O Power OMNI criará a Skill no projeto selecionado e registrará a primeira versão.
{% endstep %}
{% endstepper %}

### Como definir o nome

Use um nome curto, estável e fácil de reconhecer. Prefira letras minúsculas, números e hífens, sem espaços ou acentos.

Exemplos:

* `analise-faturamento`
* `suporte-produto`
* `consulta-politicas-rh`

Como o nome fica bloqueado após a criação, evite referências temporárias, datas ou nomes de pessoas.

### Como escrever a descrição

A descrição deve dizer com clareza **quando** a Skill entra em ação. Evite textos como “Skill de atendimento” ou “Ajuda o agente”, pois eles não informam o gatilho de uso.

Exemplo pouco claro:

```
Informações sobre a empresa.
```

Exemplo recomendado:

```
Use esta Skill quando o usuário perguntar sobre a empresa,
seus produtos, serviços, história, posicionamento ou equipe.
```

### Como escrever as instruções

As instruções dizem **como** o agente deve responder ou executar a tarefa. Organize o conteúdo em Markdown e inclua apenas regras ligadas ao objetivo da Skill.

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FTiDZv8dt6P96cpVAQ5Ja%2Fimage.png?alt=media&amp;token=b8857be3-8932-4a6d-a619-b354581ee5c8" alt=""><figcaption></figcaption></figure>

Uma estrutura simples costuma funcionar bem:

```markdown
# Skill Institucional

## Quando usar
Use esta Skill quando o usuário perguntar sobre a empresa, seus produtos,
serviços, história, posicionamento ou equipe.

## Regras
- Responda apenas com informações institucionais confirmadas.
- Se a informação não estiver disponível, diga que não foi possível confirmá-la.
- Não invente datas, clientes, números ou funcionalidades.

## Formato da resposta
- Use português claro e direto.
- Comece pela resposta principal.
- Use uma lista somente quando ela facilitar a leitura.
```

### Editar e versionar uma Skill

Para alterar uma Skill existente:

{% stepper %}
{% step %}
Localize a Skill na listagem
{% endstep %}

{% step %}
Abra a edição

Na coluna **Ações**, clique no ícone de edição.
{% endstep %}

{% step %}
Atualize o conteúdo

Atualize a descrição ou as instruções.
{% endstep %}

{% step %}
Salve.
{% endstep %}
{% endstepper %}

O nome da Skill não pode ser alterado depois da criação. Essa regra mantém o vínculo com o Microsoft Foundry e evita que referências existentes deixem de funcionar.

Cada alteração salva gera uma nova versão imutável no Microsoft Foundry. A seção **Versão padrão** mostra a versão ativa e a data em que ela foi criada.

Quando uma Skill é vinculada à Toolbox sem a escolha de uma versão específica, a Toolbox acompanha a versão padrão. Assim, uma atualização pode ser disponibilizada aos agentes conectados sem recriar a Skill.

{% hint style="info" %}

### **Recomendação:**&#x20;

Teste as mudanças antes de adotá-las em agentes usados em produção. Uma instrução nova pode alterar o formato, o tom ou a lógica das respostas.
{% endhint %}

### Adicionar a Skill a uma Toolbox

A Skill não é conectada diretamente ao agente. Primeiro, ela precisa fazer parte de uma Toolbox.

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FDmu26lsD0lWSPMjRFNk2%2Fimage.png?alt=media&amp;token=07a05e75-6795-4701-997a-5cd0ebbd3f0b" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
Acesse Toolboxes

Acesse **Artefatos > Toolboxes**.
{% endstep %}

{% step %}
Crie ou edite uma Toolbox
{% endstep %}

{% step %}
Localize Skills

No formulário da Toolbox, localize a seção **Skills**.
{% endstep %}

{% step %}
Adicione a Skill

Marque a Skill que deseja adicionar.
{% endstep %}

{% step %}
Salve.
{% endstep %}
{% endstepper %}

Uma Toolbox pode reunir ferramentas, conectores e Skills. Dessa forma, o agente recebe em um único vínculo as capacidades necessárias e as orientações de uso.

### Conectar a Toolbox ao agente

Depois de adicionar a Skill à Toolbox:

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FFpS4SnSXCyy14eIFfsZD%2Fimage.png?alt=media&amp;token=8a0678b0-22b3-4a63-be66-c9203df0faa7" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
Acesse **Artefatos > Agentes**
{% endstep %}

{% step %}
Crie ou edite o agente
{% endstep %}

{% step %}
Abra os relacionamentos do agente
{% endstep %}

{% step %}
Localize Toolboxes
{% endstep %}

{% step %}
Selecione a Toolbox que contém a Skill.
{% endstep %}

{% step %}
Salve as alterações.
{% endstep %}
{% endstepper %}

O agente poderá usar a Skill nas conversas em que a descrição corresponder ao pedido do usuário.

### Testar a Skill

Após concluir os vínculos, abra o chat e selecione o agente configurado. Faça uma pergunta que corresponda à descrição da Skill.

Exemplo:

```
Quais serviços a Power Tuning oferece e como a empresa se posiciona no mercado?
```

Confira se a resposta:

* segue as regras escritas nas instruções;
* respeita o formato solicitado;
* não apresenta informações fora do escopo;
* usa as ferramentas corretas quando a Skill orientar uma consulta ou ação.

Se necessário, ajuste a descrição ou as instruções, salve uma nova versão e teste novamente.

### Skill, Toolbox e ferramenta: qual é a diferença?

<table><thead><tr><th width="199">Recurso</th><th>Função</th><th>Exemplo</th></tr></thead><tbody><tr><td><strong>Skill</strong></td><td>Ensina como conduzir uma tarefa.</td><td>Define o roteiro de uma análise de faturamento.</td></tr><tr><td><strong>Toolbox</strong></td><td>Reúne Skills e ferramentas que serão entregues ao agente.</td><td>Agrupa a Skill de análise, o conector do Fabric e a Busca na Web.</td></tr><tr><td><strong>Ferramenta ou conector</strong></td><td>Consulta dados ou executa uma ação.</td><td>Pesquisa documentos, consulta o Fabric ou chama uma API.</td></tr><tr><td><strong>Instruções do agente</strong></td><td>Define o comportamento geral daquele agente.</td><td>Delimita o papel, o tom e as regras permanentes do assistente.</td></tr></tbody></table>

Use as instruções do agente para regras que valem em toda conversa. Use Skills para processos especializados que podem ser reutilizados em mais de um agente.

### Excluir uma Skill

Para excluir uma Skill, localize-a na listagem e clique no ícone de lixeira na coluna **Ações**.

Antes da exclusão, remova a Skill das Toolboxes que ainda a utilizam. A exclusão pode afetar todos os agentes conectados a essas Toolboxes.

Se você pretende apenas trocar as instruções, edite a Skill e crie uma nova versão. Não é necessário excluí-la.

### Solução de problemas

<details>

<summary>O agente não utiliza a Skill</summary>

Verifique estes pontos:

* a Skill foi adicionada à Toolbox;
* a Toolbox foi conectada ao agente;
* as alterações foram salvas;
* a descrição explica com clareza quando a Skill deve ser usada;
* a pergunta de teste realmente corresponde ao escopo descrito.

</details>

<details>

<summary>O agente carrega a Skill em momentos errados</summary>

Deixe a descrição mais específica. Informe o assunto, o tipo de solicitação e, quando necessário, os casos em que a Skill não deve ser usada.

</details>

<details>

<summary>As respostas não seguem o processo esperado</summary>

Reescreva as instruções com passos numerados, regras objetivas e um formato de saída. Remova orientações que se contradizem ou que também aparecem nas instruções gerais do agente.

</details>

<details>

<summary>O nome não pode ser editado</summary>

Esse comportamento é esperado. O nome funciona como identificador da Skill no Microsoft Foundry e fica bloqueado após a criação.

</details>

{% hint style="info" %}

#### Preciso de ajuda? <a href="#preciso-de-ajuda" id="preciso-de-ajuda"></a>

Se tiver alguma dúvida para configurar as Skills, procure o suporte do Power Omni.
{% endhint %}