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