> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/controle-de-fluxo/skill.md).

# Skill

O módulo **Skill** executa uma **Skill** — uma funcionalidade personalizada desenvolvida especificamente para a sua empresa — diretamente do fluxo.

{% hint style="info" %}
Uma Skill é diferente do módulo **Tool**: enquanto o Tool define uma função simples usada por um Agente de IA, a Skill é um pacote de funcionalidade completo, desenvolvido e publicado para a sua conta pela equipe técnica responsável, cobrindo casos de uso específicos do seu negócio.
{% endhint %}

{% hint style="danger" %}
Uma Skill pode rodar um código personalizado diretamente no navegador de quem está usando o fluxo, sem uma camada extra de isolamento de segurança. Por isso, use apenas Skills desenvolvidas ou aprovadas pela equipe técnica responsável pela sua conta — nunca uma Skill de origem desconhecida ou não confiável.
{% endhint %}

**📷 Inserir print:** visão geral do módulo Skill na área de trabalho do fluxo

***

### 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Controle de fluxo**.
5. Arraste o módulo **Skill** para a área de trabalho do fluxo.

**📷 Inserir print:** painel de módulos com a categoria Controle de fluxo expandida e o módulo Skill visível

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário que pelo menos uma Skill já tenha sido publicada para a sua conta. As Skills disponíveis podem ser consultadas na tela **Skills**, no menu de configurações da conta.
{% endhint %}

***

### 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

**📷 Inserir print:** painel de configuração do módulo Skill aberto

***

#### 🧩 Skill e versão

| Campo  | O que preencher                                                        |
| ------ | ---------------------------------------------------------------------- |
| Skill  | Selecione, na lista, a Skill que deseja executar neste ponto do fluxo. |
| Versão | Selecione a versão da Skill que deve ser usada.                        |

**📷 Inserir print:** campos Skill e Versão preenchidos

***

#### 🔌 Integrações

Se a Skill selecionada precisar de alguma integração (por exemplo, uma conta de e-mail ou um sistema externo), os campos correspondentes aparecem automaticamente para você selecionar as integrações já cadastradas.

**📷 Inserir print:** campo de integração exigido pela Skill

***

#### ⚙️ Configuração

Cada Skill pode ter sua própria tela de configuração específica, com os campos definidos por quem desenvolveu a Skill.

**📷 Inserir print:** aba de configuração específica da Skill selecionada

***

#### 🔀 Saídas do módulo

O módulo tem duas saídas:

* **Sucesso** — a Skill foi executada com sucesso.
* **Erro** — a execução da Skill falhou.

{% hint style="warning" %}
Em alguns casos, a mensagem de erro detalhada pode não aparecer na saída de Erro, mostrando um valor vazio. Se isso acontecer, entre em contato com o responsável pela Skill para investigar a causa da falha.
{% endhint %}

**📷 Inserir print:** módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro

***

### 💡 Caso de uso

**Cenário:** uma empresa tem uma integração personalizada com um sistema interno de estoque, desenvolvida sob medida como uma Skill.

**Configuração:**

1. Adicione o módulo **Skill** ao fluxo, no ponto em que a consulta de estoque é necessária.
2. Selecione a Skill de consulta de estoque e a versão desejada.
3. Selecione a integração exigida pela Skill, se houver.
4. Preencha os campos de configuração específicos da Skill.
5. Conecte a saída **Sucesso** a um módulo que use o resultado na conversa.

**Resultado:** o fluxo consulta automaticamente o estoque através da funcionalidade personalizada desenvolvida para a empresa.

***

### 📌 Dicas úteis

* Sempre use a versão mais recente da Skill, a menos que haja um motivo específico para usar uma versão anterior.
* Sempre conecte a saída **Erro** a algum tratamento, já que a execução de uma Skill pode falhar por motivos específicos dela.
* Consulte a tela **Skills** para ver quais Skills estão disponíveis para a sua conta e seus detalhes.

***

### 📝 Resumo

* O módulo **Skill** executa uma funcionalidade personalizada (Skill) publicada para a sua conta.
* Você seleciona a Skill, a versão e, se necessário, integrações e configurações específicas.
* O módulo tem uma saída de **Sucesso** e uma de **Erro**.