🎯Skills do Assistente de Negócios no HubCount BI

As Skills do Assistente de Negócios são capacidades específicas que ajudam a IA a executar análises mais direcionadas dentro do HubCount BI. Elas funcionam como especializações do assistente para determinados tipos de pergunta, contexto ou tarefa.

Com as skills, o Assistente de Negócios consegue responder melhor a solicitações como análises de indicadores, comparações de períodos, investigação de dados, geração de resumos e apoio à tomada de decisão.

O que são skills

Uma skill é uma habilidade que orienta o Assistente de Negócios a trabalhar melhor em um determinado cenário.

Na prática, ela ajuda a IA a entender:

Qual tipo de análise deve ser feita.
Quais dados são mais importantes.
Como organizar a resposta.
Que tipo de informação o usuário espera receber.
Qual linguagem usar para explicar o resultado.

As skills tornam o assistente mais direcionado, evitando respostas genéricas.

Para que servem

As skills servem para melhorar a qualidade das respostas do Assistente de Negócios em situações específicas.

Elas podem ajudar em tarefas como:

Resumir indicadores.
Comparar períodos.
Identificar variações relevantes.
Explicar resultados financeiros.
Analisar inadimplência.
Avaliar despesas.
Encontrar pontos de atenção.
Gerar recomendações práticas.
Preparar resumos para gestores.

Como as skills funcionam

Quando o usuário faz uma pergunta, o Assistente de Negócios interpreta a solicitação e utiliza a capacidade mais adequada para responder.

Por exemplo:

Se o usuário pede um resumo executivo, o assistente pode organizar a resposta em tópicos gerenciais.
Se o usuário pede uma comparação, o assistente pode destacar aumentos, quedas e variações.
Se o usuário pergunta sobre inadimplência, o assistente pode priorizar valores vencidos, clientes em atraso e riscos.
Se o usuário pede recomendações, o assistente pode sugerir ações práticas com base nos dados.

As skills não substituem os dados do BI. Elas ajudam a IA a interpretar e apresentar esses dados de forma mais útil.

Diferença entre skill e input

É importante entender a diferença entre skills e inputs.

Input

Input é a fonte de dados usada pelo assistente ou agente.

Exemplos:

Um cubo de contas a receber.
Uma medida de faturamento.
Um gráfico de despesas.
Uma informação contábil.

O input responde à pergunta:

Quais dados devem ser analisados?

Skill

Skill é a forma como o assistente conduz a análise.

Exemplos:

Fazer um resumo executivo.
Comparar períodos.
Explicar um indicador.
Identificar pontos fora do padrão.
Sugerir ações.

A skill responde à pergunta:

Como a análise deve ser feita?

Quando usar skills

Use skills quando quiser orientar melhor o Assistente de Negócios sobre o tipo de resposta esperada.

Exemplos:

"Faça um resumo executivo."
"Compare com o mês anterior."
"Explique os principais motivos da variação."
"Liste os maiores riscos."
"Sugira ações práticas."
"Analise como gestor financeiro."

Mesmo quando o usuário não menciona uma skill explicitamente, o assistente pode aplicar uma habilidade adequada com base na pergunta.

Principais tipos de skills

Resumo executivo

Essa skill ajuda a transformar dados em uma visão curta, objetiva e voltada para gestão.

Exemplo de pergunta:

Faça um resumo executivo do faturamento deste mês.

Resposta esperada:

Principais resultados.
Pontos de atenção.
Variações relevantes.
Conclusão em linguagem simples.

Comparação de períodos

Essa skill ajuda a comparar dados entre dois períodos.

Exemplo de pergunta:

Compare as despesas deste mês com o mês anterior.

Resposta esperada:

Aumentos.
Reduções.
Variações percentuais ou absolutas.
Possíveis causas.
Pontos que merecem análise.

Análise de variação

Essa skill ajuda a entender o que mudou nos dados.

Exemplo de pergunta:

O que mais impactou a queda no faturamento?

Resposta esperada:

Principais fatores da variação.
Itens com maior impacto.
Grupos, clientes, categorias ou períodos relevantes.

Identificação de riscos

Essa skill ajuda a encontrar situações que merecem atenção.

Exemplo de pergunta:

Quais são os maiores riscos na inadimplência atual?

Resposta esperada:

Clientes com maior valor em aberto.
Valores vencidos.
Atrasos relevantes.
Recomendações de acompanhamento.

Explicação de indicadores

Essa skill ajuda a explicar métricas e resultados.

Exemplo de pergunta:

Explique o que significa este indicador.

Resposta esperada:

Definição em linguagem simples.
Como interpretar o resultado.
O que pode indicar melhora ou piora.

Recomendações práticas

Essa skill ajuda a transformar a análise em ações.

Exemplo de pergunta:

Com base nesses dados, quais ações devo tomar?

Resposta esperada:

Recomendações objetivas.
Priorização dos principais pontos.
Próximos passos sugeridos.

Como pedir uma skill na prática

Você não precisa usar o termo "skill" ao conversar com o assistente. Basta escrever o que deseja.

Exemplos:

"Resuma em linguagem executiva."
"Compare com o período anterior."
"Explique os motivos da variação."
"Identifique os principais riscos."
"Sugira ações práticas."
"Liste os 5 maiores impactos."

Essas frases indicam ao assistente qual habilidade deve ser aplicada.

Onde ficam as skills

As skills ficam disponíveis em dois lugares:

No próprio chat, ao digitar /, que abre a lista de comandos e skills publicadas.
No Skills Studio, a tela onde você consulta, cria, edita e publica skills.

No Skills Studio você encontra:

A biblioteca de skills, com filtros por Todas, Oficiais, Empresa e Rascunhos.
Uma busca por nome, descrição, categoria, tags e casos de uso.
O detalhe de cada skill, com descrição, quando usar, modo e política de aprovação.
O botão Usar no chat, que insere a skill diretamente na conversa.

Existem três origens de skills:

Oficiais (HubCount): mantidas pela HubCount. Não podem ser editadas, mas podem ser duplicadas para servir de base.
Da empresa: criadas pela sua organização e compartilhadas entre os usuários.
Rascunhos: skills ainda em construção, que não aparecem no / até serem publicadas.

Como criar uma skill

Você pode criar suas próprias skills no Skills Studio. A criação é guiada por um assistente em quatro etapas: Identidade, Comportamento, Permissões e Teste e publicação.

Para começar, abra o Skills Studio e clique em Nova skill. Você também pode partir de uma skill existente usando a opção de duplicar (útil para adaptar uma skill oficial).

Etapa 1: Identidade

Aqui você define como a skill será reconhecida.

Nome da skill: nome claro e fácil de entender.
Identificador no slash: é o atalho usado no chat, como /analisar-dre. Ele é gerado automaticamente a partir do nome, mas pode ser ajustado. Cada identificador deve ser único.
Descrição curta: explica o que a skill faz. Esse texto aparece na lista do /.
Categoria: ajuda a organizar a skill (por exemplo, Análise, Gráficos, Dashboards, Qualidade dos dados, Modelagem, Executivo ou Customizada).

Etapa 2: Comportamento

Aqui você define como a skill deve trabalhar.

Quando usar: descreve as situações em que a skill é indicada. Isso ajuda o assistente a escolher a skill certa.
O que o assistente deve fazer: são as instruções principais. É o campo mais importante, pois orienta o passo a passo, o foco da análise e o formato esperado da resposta.
Texto inicial ao inserir no chat: é o texto que já aparece no campo de mensagem quando a skill é selecionada, ajudando o usuário a começar.

Quanto mais claras as instruções, mais consistente será o resultado da skill.

Etapa 3: Permissões

Aqui você define o que a skill pode fazer e quais recursos ela pode usar.

Pode alterar o relatório?: define o modo da skill.
- Leitura: a skill apenas consulta e analisa dados. Não altera nada no BI.
- Escrita: a skill pode criar ou alterar itens como gráficos, séries, dashboards e medidas.
Recursos permitidos: você seleciona quais capacidades a skill pode usar, organizadas em grupos como Contexto, Dados, Gráficos, Dashboard e Modelagem. Selecione apenas o necessário para o objetivo da skill.
Política de aprovação: define se o usuário precisa confirmar antes de alterações.
- Sem aprovação: não pede confirmação.
- Antes da primeira alteração: pede confirmação antes da primeira ação que altera algo.
- Sempre confirmar: pede confirmação a cada alteração.

Importante: skills que podem alterar o relatório (modo escrita) exigem uma política de aprovação. Não é possível publicar uma skill de escrita com a opção Sem aprovação.

Etapa 4: Teste e publicação

Antes de publicar, teste a skill.

Pergunta de teste: escreva um exemplo de solicitação.
Testar skill: mostra uma prévia do prompt final, uma resposta de teste e possíveis avisos.
Salvar rascunho: guarda a skill sem publicá-la. Rascunhos não aparecem no /.
Publicar: torna a skill disponível no chat para uso.

Para publicar, é necessário preencher pelo menos: nome, identificador, descrição, quando usar e instruções.

Versões e ciclo de vida das skills

As skills da empresa têm um ciclo de vida simples:

Rascunho: skill em construção, ainda não disponível no /.
Publicada: skill disponível para uso no chat.
Arquivada: skill desativada, que deixa de aparecer na lista.

Cada vez que você edita e salva uma skill, é gerada uma nova versão. A versão publicada é a que fica disponível para uso. Isso permite evoluir a skill sem perder o histórico.

Skills oficiais não podem ser editadas nem arquivadas, mas podem ser duplicadas para criar uma versão própria da sua empresa.

Boas práticas ao criar skills

Use nomes e identificadores claros, fáceis de lembrar no /.
Escreva instruções objetivas, com o passo a passo esperado.
Descreva bem o campo Quando usar, para o assistente escolher a skill certa.
Comece com skills de leitura sempre que possível.
Ative o modo escrita apenas quando a skill realmente precisar criar ou alterar algo.
Em skills de escrita, configure uma política de aprovação adequada.
Selecione apenas os recursos necessários para o objetivo da skill.
Teste a skill antes de publicar.
Evolua a skill aos poucos, publicando novas versões conforme necessário.

Exemplos práticos

Exemplo 1: resumo executivo

Pergunta:

Faça um resumo executivo da inadimplência do mês atual.

O assistente deve priorizar uma resposta objetiva, com os principais números, riscos e conclusão.

Exemplo 2: comparação

Pergunta:

Compare o faturamento deste mês com o mês anterior e destaque as maiores diferenças.

O assistente deve buscar variações relevantes e apresentar os principais aumentos ou quedas.

Exemplo 3: investigação

Pergunta:

Quais clientes mais contribuíram para o aumento do contas a receber vencido?

O assistente deve procurar os maiores responsáveis pela variação e organizar a resposta por impacto.

Exemplo 4: recomendação

Pergunta:

Quais ações práticas devo tomar com base nesses dados?

O assistente deve transformar a análise em recomendações claras.

Boas práticas para usar skills

Diga o tipo de análise desejada.
Informe o período quando necessário.
Peça comparação se quiser entender evolução.
Peça resumo executivo se quiser objetividade.
Peça recomendações se quiser apoio para decisão.
Especifique quantidade quando quiser uma lista, como "top 5" ou "3 principais pontos".

O que evitar

Evite pedidos vagos, como:

"Veja isso."
"Analise tudo."
"O que acha?"

Prefira comandos claros:

"Resuma os principais pontos."
"Compare com o mês anterior."
"Mostre os 5 clientes com maior atraso."
"Explique os motivos da queda."
"Sugira ações para reduzir o risco."

Skills em agentes de IA

As skills também podem ser úteis na configuração de Agentes de IA.

Ao escrever as instruções de um agente, você pode orientar a IA a usar um estilo específico de análise.

Exemplos:

"Gere um resumo executivo."
"Compare sempre com o período anterior."
"Destaque os principais riscos."
"Sugira ações práticas ao final."
"Liste os maiores ofensores por valor."

Isso ajuda o agente a entregar relatórios e alertas mais consistentes.

Diferença entre Assistente de Negócios, Agentes e Skills

Assistente de Negócios

É o chat com IA usado para perguntas sob demanda.

Agentes de IA

São automações configuradas para gerar relatórios ou alertas automaticamente.

Skills

São habilidades reutilizáveis que orientam como a IA deve conduzir a análise e, em alguns casos, executar ações no relatório (como criar gráficos ou dashboards). Podem ser oficiais da HubCount ou criadas pela sua empresa.

Em resumo:

O assistente é onde você conversa.
O agente é uma automação configurada.
A skill é a capacidade usada para conduzir melhor a análise.

Dúvidas comuns

Preciso escolher uma skill manualmente?

Nem sempre. Em muitos casos, basta escrever o que você quer, e o assistente entende o tipo de análise desejada.

Skills alteram os dados?

Os dados de origem (vindos dos conectores) nunca são alterados por skills.

O que muda é o modo da skill:

Skills de leitura apenas consultam e analisam. Não alteram nada no BI.
Skills de escrita podem criar ou alterar itens do relatório, como gráficos, séries, dashboards e medidas, sempre respeitando a política de aprovação configurada.

Posso combinar skills?

Sim. Você pode pedir, por exemplo:

Compare com o mês anterior, resuma em linguagem executiva e sugira ações práticas.

Nesse caso, o assistente combina comparação, resumo e recomendação.

Skills substituem os inputs?

Não. Inputs são os dados analisados. Skills são a forma de análise aplicada sobre esses dados.

Conclusão

As Skills do Assistente de Negócios ajudam a IA do HubCount BI a entregar respostas mais úteis, objetivas e adequadas ao contexto do usuário.

Ao pedir resumos, comparações, explicações, riscos ou recomendações, você orienta o assistente a aplicar a habilidade correta para transformar dados em informação prática para decisão.