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.

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.

Como funciona

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

1

Criar a Skill

2

Adicionar à Toolbox

3

Conectar ao agente

4

Usar durante a conversa

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

1

Entre no Portal de Administração do Power OMNI

2

Abra Artefatos

3

Selecione Skills

Criar uma Skill

1

Acesse Skills

Acesse Artefatos > Skills.

2

Clique em Criar

Clique em Criar no canto superior direito.

3

Preencha o formulário lateral

Campo	Descrição
Projeto	Selecione o projeto do Microsoft Foundry em que a Skill será armazenada.
Nome	Informe um identificador único para a Skill. Depois da criação, esse nome não poderá ser alterado.
Descrição	Escreva quando o agente deve usar a Skill. Essa informação ajuda o agente a decidir se deve carregar as instruções.
Instruções	Escreva, em Markdown, o processo e as regras que o agente deve seguir ao usar a Skill.

4

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.

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.

Uma estrutura simples costuma funcionar bem:

# 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:

1

Localize a Skill na listagem

2

Abra a edição

Na coluna Ações, clique no ícone de edição.

3

Atualize o conteúdo

Atualize a descrição ou as instruções.

4

Salve.

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.

Recomendação:

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.

Adicionar a Skill a uma Toolbox

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

1

Acesse Toolboxes

Acesse Artefatos > Toolboxes.

2

Crie ou edite uma Toolbox

3

Localize Skills

No formulário da Toolbox, localize a seção Skills.

4

Adicione a Skill

Marque a Skill que deseja adicionar.

5

Salve.

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:

1

Acesse Artefatos > Agentes

2

Crie ou edite o agente

3

Abra os relacionamentos do agente

4

Localize Toolboxes

5

Selecione a Toolbox que contém a Skill.

6

Salve as alterações.

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?

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

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

O agente não utiliza a Skill

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.

O agente carrega a Skill em momentos errados

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.

As respostas não seguem o processo esperado

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.

O nome não pode ser editado

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

Preciso de ajuda?

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