O que é uma skill?

Em uma frase

Uma skill é um procedimento que o agente de IA consulta quando precisa executar algo específico.

A explicação simples

Todo agente já tem um prompt: em que você define a missão dele, a função geral, o tom de voz. Isso vale para toda conversa e está sempre carregado.

Só que existem coisas que o agente precisa saber fazer e que não cabem no prompt. Por exemplo:

• Como orientar o cliente, passo a passo, a emitir uma segunda via no site.

• O que fazer quando o cliente envia uma imagem?

• O roteiro completo de abertura de um chamado

Se você jogar tudo isso no prompt, dois problemas aparecem:

• O primeiro é custo: o prompt inteiro é processado em toda mensagem, então cada procedimento adicionado gasta token o tempo todo, mesmo nas conversas em que ele nunca será usado.

• O segundo é qualidade: um prompt muito grande confunde o agente, que perde o foco no que importa naquele momento.

A skill resolve os dois. O procedimento sai do prompt e fica guardado. O agente vai buscá-lo só quando aquela situação aparecer.

Regra prática: se o conteúdo é um passo a passo ou uma instrução de como agir numa situação específica, é skill.

O que é uma RAG

Em uma frase

Uma RAG é uma base de documentação que o agente consulta para buscar informação.

RAG é a sigla de Retrieval-Augmented Generation — "geração aumentada por recuperação".

Na prática: o agente recupera um trecho de conteúdo antes de escrever a resposta.

A explicação simples

Se a skill é o procedimento que o agente executa, a RAG é o material de referência que ela lê.

O agente não decorou o contrato inteiro, nem a política de trocas de quarenta páginas. Mas ele sabe onde procurar. Quando o cliente pergunta algo específico, ele consulta a base, encontra o trecho certo e responde.

Regra prática: se o conteúdo é documentação extensa que serve de referência, é RAG.

Como criar uma skill na SellFlux

Na SellFlux, uma skill não é um arquivo solto. A estrutura tem dois níveis: a pasta com as skills e as skills dentro da pasta em si.
Cada pasta agrupa skills relacionadas. Você cria, renomeia, reordena, arquiva e exclui pastas nesta tela.

Aqui há um passo a passo de como criar uma nova skill:

1. Clique na aba "Funnel".

2. Clique no menu lateral na opção "Skills".

3. Clique no botão "+ Nova Skill".

Ao clicar numa pasta, a tabela central mostra os conteúdos dela. Cada conteúdo é um documento em markdown, criado pelo botão "Novo conteúdo" no canto superior direito. Ou, caso não tenha criado nada, pode clicar no botão "Adicionar conteúdo".
Você pode buscar, paginar e excluir skills.

Agora, dentro da skill:

1. Adicione o nome da skill, nesse caso, pode ser um tópico ou uma pergunta.
   IMPORTANTE: Esse nome da skill será o que o agente utilizará para achar essa skill, por isso é importante que ele esteja claro.

2. Aqui será o conhecimento da skill mesmo, o passo a passo que o agente pode executar, as instruções completas que você deverá colocar.

💡 Você pode utilizar títulos, divisores e outros recursos dentro da skill, somente é necessário escrever "/", que terá um dropdown com as opções!

Também é importante sempre prestar atenção no indicador de qualidade da skill. Caso a sua skill esteja muito pequena, este indicador irá lhe avisar!

O essencial é segmentar as informações em mais skills caso fique muito grande o conteúdo também.

• Rascunho: 0 a 14 palavras.

• Básico: 15 a 39 palavras.

• Bom: 40 a 79 palavras.

• Excelente: 80 palavras em diante.

💡 O limite de palavras por skill é de aproximadamente 8000 palavras!

📌 Lembre-se: o agente sempre lê a skill inteira. Uma skill com muitos assuntos diferentes faz o agente carregar tudo para usar uma parte só, gastando tokens à toa. Skills grandes e muito usadas rendem mais quando divididas em skills menores, uma para cada assunto.

Após criada, pode salvar.

### Como vincular skills aos seus agentes de IA

Dentro do seu agente, clique no bloco do seu "Agente IA".

Clique na opção "+ Vincular skill".

Aqui nesta tela você pode vincular suas skills ao seu agente, para ele conseguir consultá-las.

💡 Observação: A vinculação de skills, é pelas pastas da skill, o agente vai ter acesso a todas skills dentro da pasta que você criou.

# Como criar uma RAG na SellFlux

1. Acesse a aba "Funnel".

2. Acesse a aba no menu lateral "RAG".

3. Clique no botão "+ Novo conhecimento RAG".

Na janela que for aberta:

1. Configure o nome da RAG.

2. Adicione o conteúdo da RAG; aqui você pode adicionar os conhecimentos que deseja que a IA tenha acesso.

A terceira opção é a que mais gera dúvida — e é o que mais afeta a qualidade das respostas do seu agente. Sendo ela o tamanho de cada parte.

O que acontece quando você salva

A SellFlux não guarda o seu documento inteiro em bloco. Ele divide o texto em partes menores, e o limite de palavras define o tamanho de cada uma.

Um documento de 1.000 palavras com limite de 200 vira aproximadamente 5 partes. O mesmo documento com limite de 50 vira mais de 20.

Você não precisa fazer nada: a divisão é automática ao salvar. A tela mostra o total de caracteres, o total de palavras e a estimativa de partes.

### Por que dividir em partes o texto?

Porque o agente não lê o documento inteiro a cada mensagem.

Quando o cliente faz uma pergunta, o agente consulta a RAG e recebe de volta apenas algumas partes — as mais relacionadas àquela pergunta específica. Não o documento todo, não as primeiras páginas: as mais próximas do assunto.

Se o cliente pergunta sobre prazo de entrega, o agente recebe as partes que falam de prazo. As partes sobre faturamento ficam de fora daquela conversa.

Isso existe por dois motivos.

• Primeiro, economia: carregar um manual de cinquenta páginas em toda mensagem consumiria tokens sem necessidade.

• Segundo, precisão: um agente com o texto certo à frente responde melhor do que um agente com tudo à frente.

É exatamente por isso que a RAG é o lugar da documentação extensa, enquanto a skill entrega o conteúdo completo e serve para procedimentos.

Como as partes são escolhidas:

A busca não é por palavra-chave. É por significado.

O sistema compara o sentido da pergunta com o sentido de cada parte e devolve as mais próximas. O cliente pode perguntar "Quanto tempo demora para chegar?" E o agente recupera a parte que fala em "faixas de prazo de entrega", mesmo sem nenhuma palavra em comum.

Quantas partes o agente recebe?

Além do limite de palavras, que você define ao criar a RAG, existe um segundo controle: quantas partes cada consulta devolve. Ele fica na tool de RAG, no construtor do agente, e aceita valores de até 500.

Os dois parâmetros trabalham juntos. O limite de palavras define o tamanho de cada pedaço; o número de partes define quantos pedaços chegam ao agente. Multiplicando um pelo outro, você tem quanto texto entra na conversa a cada pergunta.

Trazer mais partes aumenta a chance de a informação certa estar entre elas. Em troca, consome mais tokens e traz mais texto irrelevante junto — o que pode confundir o agente em vez de ajudar.

Comece com o padrão. Aumente só quando notar que o agente deixa de encontrar informação que existe no documento.

### Onde a divisão corta:

O corte é feito por contagem de palavras, não por títulos ou seções. Uma parte pode terminar no meio de um parágrafo e a seguinte começar no meio de uma frase.

Para reduzir o problema, as partes têm uma pequena sobreposição entre si: o fim de uma parte se repete no começo da próxima. Isso evita que uma informação cortada no limite desapareça das duas.

Ainda assim, o corte é cego ao sentido do seu texto. E é daí que vem a única recomendação de escrita que realmente importa aqui.

Como escrever para a RAG?

Escreva cada trecho para ser lido sozinho.

O agente vai receber uma parte isolada, sem o parágrafo anterior. Se essa parte diz "nesse caso, o prazo é de 7 dias", ele não sabe qual caso. Vai responder errado, com confiança.

Na prática:

• Repita o sujeito em vez de usar pronomes. Por exemplo, escreva "o plano Premium" toda vez, não "ele".
  Se o corte separar "O plano Premium inclui suporte prioritário" de "Ele também dá direito a relatórios avançados", o agente não sabe quem é "ele" — e pode, por exemplo, atribuir o benefício ao plano errado. Vale para "esse", "isso", "o mesmo", e para atalhos como "o produto" ou "a modalidade".

• Evite referências ao que veio antes. Nada de "como vimos acima", "conforme o item anterior", "nesse caso".

• Mantenha as seções curtas, próximas do tamanho da parte. Uma seção de ~200 palavras tende a virar uma parte inteira, o que preserva o sentido.

• Coloque a informação junto do seu contexto. Um prazo, uma condição e uma exceção que se referem à mesma regra devem estar no mesmo parágrafo.

Documentação mal estruturada produz RAG ruim. Não porque o sistema falhe, mas porque um pedaço de um texto confuso pode ficar ainda mais confuso.

Qual limite escolher?

Se estiver em dúvida, fique com 200. É o valor que funciona bem na maioria dos casos, e o ajuste só compensa quando você já identificou um problema concreto nas respostas do agente.

Um sinal de que o limite está errado.

Se o agente responde certo sobre um assunto e diz não encontrar informação sobre outro, no mesmo documento, as partes relevantes não estão chegando até ele. Aumente o número de partes na tool de RAG ou reduza o limite de palavras para que os pedaços fiquem mais específicos.

Se ele responde de forma vaga, misturando assuntos, está chegando texto demais. Reduza o número de partes ou o limite de palavras se cada pedaço estiver cobrindo vários temas.

Ajuste, salve e teste de novo. A redivisão é imediata.

Após configurar o nome da sua RAG, o conteúdo e o tamanho das partes, pode clicar no botão "Salvar".

Agora, dentro do seu agente, adicione a tool RAG.

Após adicionar a Tool, dentro dela faça o seguinte:

1. Descreva quando o agente deve ativar essa tool e qual ação ela faz, por exemplo:
   Retorna informações relevantes sobre a SellFlux; deve ser utilizada quando o cliente realiza alguma pergunta específica sobre a plataforma.

2. Defina o limite de informações que o agente deve retornar; nesse caso, vamos deixar 5.

3. Vincule a RAG que criamos anteriormente.

4. Clique no botão "Salvar".

Assim você terá configurado com sucesso uma RAG para o seu agente conseguir consultar informações e fazer um atendimento mais completo!

💡 Também é uma excelente prática especificar no prompt do agente quando ele deve utilizar a tool da RAG. A tool e o prompt devem conversar entre si.

Exemplos de utilização:

A melhor forma de entender a diferença é ver os três elementos convivendo no mesmo agente. Em cada exemplo abaixo, repare no que muda: o prompt é curto e sempre presente, a skill é um procedimento, a RAG é material de consulta.

Exemplo 1 — Agente de vendas de um e-commerce

No prompt

Você é o consultor de vendas de uma Loja. Fale de forma cordial e objetiva. Nunca prometa desconto que não esteja documentado.

Ao atender, pergunte para quem é o produto e qual a ocasião de uso. Ofereça no máximo três opções, da mais barata para a mais cara. Confirme tamanho e cor antes de enviar o link de compra. Se não souber algo, diga que vai verificar.

Sempre que a pergunta envolver detalhes de produto, medidas, composição, lavagem, cupom ou frete, consulte a tool de RAG sobre o catálogo antes de responder.

Se o cliente relatar que um cupom não está aplicando no checkout, consulte a skill sobre cupom no checkout.

Repare que a qualificação do lead entrou no prompt, e não numa skill. É o que esse agente faz em praticamente toda conversa — não vale gastar uma consulta para buscar uma instrução que ele sempre vai precisar.

Na skill — "Cupom que não aplica no checkout".

1. Peça o código do cupom e o valor total do carrinho.

2. Confirme se o valor atinge o mínimo exigido pelo cupom.

3. Se atingir, oriente o cliente a limpar o carrinho e adicionar os itens novamente.

4. Instrua a aplicar o cupom antes de escolher o frete, e não depois.

5. Se ainda assim não aplicar, colete o print da tela e encaminhe ao time.

Essa sim é uma skill. Acontece de vez em quando, tem um passo a passo específico, e ocuparia espaço no prompt sem necessidade nas centenas de conversas em que ninguém usa cupom.

Na RAG — "Catálogo Aurora".

Ficha completa de cada produto: composição do tecido, tabela de medidas, instruções de lavagem, política de cupons por categoria, faixas de frete por região.

É material de consulta, longo, usado sob demanda. Quando o cliente pergunta se a blusa encolhe na lavagem, o agente busca essa informação específica.

Como fica na conversa: o prompt define o tom, a skill conduz a qualificação e a RAG entrega a medida do produto quando o cliente pergunta.

Exemplo 2 — Agente de suporte de um software

No prompt

Você é um agente de Suporte Técnico. Seja direto. Nunca peça a senha do cliente. Antes de escalar um chamado, confirme que as verificações básicas foram feitas.

Sempre que a pergunta envolver código de erro, requisito de sistema, limite de plano ou mudança de versão, consulte a tool de RAG sobre a documentação técnica antes de responder.

Se o cliente enviar uma imagem, consulte a skill sobre recebimento de print de erro. Se o cliente pedir para trocar ou recuperar a senha, consulte a skill sobre redefinição de senha.

Na skill — "Recebimento de print de erro".

1. Descreva o que você identificou na imagem e confirme com o cliente.

2. Se a mensagem de erro estiver legível, extraia o código e siga para o passo 4.

3. Se estiver ilegível, peça um novo print com a tela inteira visível.

4. Pergunte o que o cliente estava fazendo no momento do erro.

5. Só então consulte a documentação para identificar a causa.

Um procedimento acionado por uma situação específica. Se isso estivesse no prompt, seria carregado em toda conversa — inclusive nas centenas em que ninguém envia imagem alguma.

Na skill — "Redefinição de senha".

1. Oriente o cliente a acessar Configurações → Segurança.

2. Instrua a clicar em "Redefinir senha" e informar o e-mail cadastrado.

3. Avise que o link expira em 30 minutos.

4. Se o e-mail não chegar em 5 minutos, oriente a verificar a caixa de spam.

5. Se ainda assim não chegar, abra um chamado. Nunca redefina a senha manualmente.

Note que um mesmo agente pode ter várias skills. Elas ficam agrupadas em pastas, e você vincula a pasta inteira ao agente.

Na RAG — "Documentação técnica"

O manual completo do produto: todos os códigos de erro e suas causas, requisitos de sistema, limites de plano, changelog das últimas versões.

Centenas de páginas. Ninguém colocaria isso numa skill — e o agente só precisa do trecho referente ao erro que apareceu.

Como fica na conversa: o cliente manda um print. A skill de imagem entra em ação, o agente extrai o código de erro e aí consulta a RAG para descobrir o que aquele código significa.

Exemplo 3 — Agente de uma clínica

No prompt

Você é o atendente de uma Clínica. Seja acolhedor. Nunca dê orientação médica, diagnóstico ou opinião sobre sintomas.

Para agendar, pergunte a especialidade, confirme se o paciente já foi atendido aqui e colete nome completo, data de nascimento e telefone se for a primeira vez. Ofereça os três horários disponíveis mais próximos, confirme os dados e informe a política de cancelamento com 24 horas de antecedência.

Sempre que a pergunta envolver convênio, cobertura de procedimento, carência ou valor particular, consulte a tool de RAG sobre convênios antes de responder.

Se o paciente precisar enviar uma guia de autorização, consulte a skill sobre envio de guia pelo portal.

O agendamento é a rotina principal desse agente — está em quase toda conversa. Por isso vai no prompt, mesmo sendo um passo a passo.

Na skill — "Envio de guia de autorização pelo portal"

1. Confirme qual convênio e qual procedimento precisam de autorização.

2. Oriente o paciente a acessar o portal e entrar em Meus Documentos → Enviar guia.

3. Instrua a fotografar a guia inteira, com as bordas visíveis e sem reflexo.

4. Avise que o formato aceito é imagem ou PDF, com até 10 MB.

5. Informe que a análise leva até 3 dias úteis, e que o paciente recebe um SMS ao final.

6. Se o upload falhar, oriente a enviar pelo WhatsApp da recepção.

Poucos pacientes por semana passam por isso. É procedimento específico, com um roteiro que ninguém decora. Skill.

Na RAG — "Convênios e coberturas"

A lista completa de convênios aceitos, quais procedimentos cada um cobre, quais exigem autorização prévia, prazos de carência, valores particulares por especialidade.

Documento extenso, que muda de tempos em tempos, e do qual o agente só precisa de um trecho por vez.

Como fica na conversa: o paciente pergunta se o convênio dele cobre uma consulta com dermatologista. O agente consulta a RAG, confirma a cobertura, e então executa a skill de agendamento.

O padrão que se repete

Nos três exemplos, a divisão obedece à mesma lógica:

Note que a skill não se diferencia do prompt por ser um procedimento — o prompt também pode conter um. A diferença é a frequência. Se o agente precisa daquilo sempre, deixe no prompt, onde já está carregado. Se precisa de vez em quando, tire do prompt e coloque numa skill: o agente busca quando a situação aparecer, e nas demais conversas nem gasta token com aquilo.

E o teste mais rápido, quando bater a dúvida:

• Se você escreveria em imperativo — "pergunte", "confirme", "oriente" — é prompt ou skill. Aí pergunte: acontece em toda conversa? Prompt. Só às vezes? Skill.

• Se você escreveria como afirmação sobre o mundo — "o prazo é de 7 dias", "o convênio X cobre" — é RAG.

Pronto! Agora é só aplicar nos seus agentes. Combinando prompt, skills e RAG, você monta um atendimento muito mais completo, e seus clientes recebem respostas melhores em cada conversa.