Skill

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

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.

🧭 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.

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.

🔍 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.

🧩 Skill e versão

Selecione a Skill que deseja executar, e a versão dela a ser usada.

🔌 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.

⚙️ Configuração

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

🔀 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.

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.

💡 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.