Sellbie

View saved version →

---
name: apresentar-analises
description: Escolha como apresentar resultados da Sellbie em texto, tabela, gráficos ou cards. Use em análises com comparações, vários indicadores, séries, rankings, produtos ou cestas, respeitando os componentes disponíveis e a preferência do usuário.
---

# Apresentar análises

Escolha o formato pela pergunta e preserve todos os indicadores solicitados. Use os contratos das ferramentas disponíveis; antes de escolher um componente, confira [formatos e limites](references/formatos-disponiveis.md).

## Escolher a apresentação

- Número pontual ou definição: texto breve. Valores exatos, muitas dimensões ou pedido de tabela: tabela no chat.
- Evolução: linhas; ranking: barras; reconhecimento de produtos e combinações: cards com nomes, medida relevante e fotos disponíveis. Não espere um pedido explícito de gráfico quando ele facilitar a leitura.
- Prefira uma chamada visual que cubra a pergunta. Resumo e evolução de vendas no mesmo período usam `visualizar_vendas` com `resumo_e_evolucao`. Envie somente as métricas necessárias; não acrescente gráficos acessórios.
- Compare períodos de uma mesma métrica no mesmo gráfico com `comparar_periodos_vendas`. Preserve datas, duração e convenção de alinhamento. Não calcule ticket do período pela média dos dias.
- Métricas distintas só devem compartilhar eixo com unidades, granularidade e escalas compatíveis. Receita e ticket podem ter escalas incompatíveis mesmo em reais. Não prometa seleção de indicadores, carrossel de gráficos ou normalização que o componente não oferece.
- Para pedido amplo sem métricas definidas, escolha um visual principal e os números complementares relevantes. Se o usuário pedir várias evoluções explicitamente, preserve-as em uma chamada compatível; o componente atual cria um gráfico por métrica. Não omita métricas para encurtar a resposta.
- Para SQL visual, selecione `dimensao` e `metrica` explicitamente quando houver ambiguidade. Não use o primeiro campo numérico por acaso nem altere a fonte oficial apenas para obter um gráfico.

## Acompanhar com texto

Explique o principal achado e sua implicação sustentada, com empresa, período, recorte e fonte clicável retornada pelo MCP. Inclua limitações que mudem a interpretação; detalhes técnicos somente se necessários. Análise personalizada deve ser identificada, sem inventar link para uma tela equivalente.

O texto complementa o visual: não repita todos os pontos, cards ou linhas. Quando útil, sugira um próximo aprofundamento concreto ligado ao resultado. Respeite pedidos explícitos por tabelas e informações completas.

## Preservar o resultado

- Uma chamada visual bem-sucedida já entrega o componente. Não repita a consulta nem produza outro gráfico para renderizar os mesmos dados.
- Se `auto` retornar tabela, use as linhas recebidas no chat, sem nova consulta. As tabelas não ficam dentro do widget.
- Distinga zero, ausência, falha e resultado parcial. Informe truncamento; top N não é total. Não complete lacunas temporais com zero nem gere percentuais sem denominador compatível.
- Use nomes legíveis, unidades e períodos claros. Preserve produtos sem foto; uma imagem pode representar outra variante.
- Se a ferramenta retornar dados sem componente, responda no chat. Se o visual falhar, aproveite os dados já recebidos e explique a limitação, sem alegar que ele foi exibido.

Referenced files: 2 — file references are metadata, not package contents.

View saved version →

---
name: desenvolver-clientes-e-campanhas
description: Analise a base de clientes, recorrência, retenção, reativação e campanhas com dados da Sellbie. Use para interpretar resultados de relacionamento e propor próximos aprofundamentos ou hipóteses de ação.
---

# Desenvolver clientes e campanhas

Conecte os indicadores à decisão de relacionamento do usuário. Use as ferramentas disponíveis na conexão Sellbie e as definições da própria plataforma.

## Consultar

- Resolva a empresa com `listar_empresas_disponiveis`. Use `filtros_valores_categoricos` para nomes de lojas e campanhas; campanhas exigem período. Reutilize o contexto já definido.
- Use `shortcutCRMAnalysis` para o resumo da base e `shortcutCRMTimeline` para sua evolução. Para campanhas, use `shortcutCampaignReport`, `shortcutCampaignRanking` e `shortcutCampaignMetrics`, conforme resumo, ranking ou detalhe.
- Consulte `consultar_definicoes_metricas` quando o significado ou denominador do indicador for necessário à conclusão. Para aprofundamentos personalizados permitidos, confira o catálogo com `explorar_dados_empresa`; não reconstrua por SQL um valor de campanha como se fosse o da tela.

## Interpretar

- Preserve período, filtros e população de cada fonte. Os relatórios públicos atuais de campanhas representam a marca, sem recorte garantido por loja. Não use esses totais como resultado de uma loja nem os divida por vendas de uma loja.
- Diferencie receita atribuída de receita incremental. Crescimento, atribuição e taxas de conversão não demonstram causalidade. ROI, ROAS e margem exigem custos e bases compatíveis disponíveis.
- Diferencie conversão em compras de conversão em compradores. Confira denominador e escala retornada; não multiplique novamente uma taxa já expressa em percentual. Diferencie variação percentual de pontos percentuais.
- Não some compradores distintos ou receitas sobrepostas entre campanhas e envios. Prefira o consolidado da fonte; um ranking não representa necessariamente todo o resultado. Se resumo e detalhe divergirem, preserve e identifique ambos, sem inventar a explicação.
- Compare volume e eficiência com o tamanho da base, objetivo, canal e tempo de observação disponíveis. Taxa alta sobre poucos impactados exige contexto; não invente um limiar universal de relevância.
- Valide recência, base ativa, churn e LTV pelas definições Sellbie. Recência pode representar intervalo entre compras; a janela de atividade depende da empresa; LTV não deve ser apresentado automaticamente como previsão de lucro futuro.
- Relacione o desempenho a novos, retidos, resgatados e não identificados quando os dados permitirem. Cobertura de identificação limita conclusões sobre clientes; não generalize a parte identificada para toda a base.
- Em coortes de recompra, use a mesma janela de acompanhamento. Clientes recentes sem tempo para recomprar não são perda comprovada. Não infira histórico de aberturas de e-mail a partir da data da última abertura.
- Preserve ausências e resultados parciais. Confira semanas e meses incompletos; horário da consulta não é atualização da fonte. O dashboard mensal aceita mês completo ou mês atual até ontem: explicite o período retornado.

## Responder e aprofundar

Explique o principal resultado, seu recorte e a fonte clicável retornada pelo MCP. Se o link não aplicar o período, indique o ajuste necessário na tela. Use linguagem de negócio, sem expor SQL, IDs ou nomes internos de relatórios.

Sugira um aprofundamento ligado ao achado: queda de base → novas entradas e retenção; muita receita e baixa conversão → alcance e perfil do público; maior frequência de contato → resposta e recorrência. Diga qual decisão essa investigação ajuda a tomar.

Ao propor uma ação, identifique a hipótese e o indicador de acompanhamento, sem prometer ganho. O catálogo atual não oferece disparos, uploads ou exportação de clientes. Pesquisa externa pode usar ferramentas do próprio ChatGPT; diferencie esse contexto da evidência interna.

Referenced files: 1 — file references are metadata, not package contents.

View saved version →

---
name: diagnosticar-vendas-e-mix
description: Investigue vendas, diferenças entre lojas, ticket, produtos e combinações de compra com dados da Sellbie. Use para explicar desempenho comercial e encontrar aprofundamentos úteis sobre o negócio.
---

# Diagnosticar vendas e mix

Responda à pergunta de negócio e investigue o que explica o resultado. Use somente ferramentas disponíveis na conexão Sellbie; siga seus schemas e metadados atuais.

## Consultar

- Resolva a empresa com `listar_empresas_disponiveis` e nomes de lojas com `filtros_valores_categoricos`. Reutilize o contexto definido; esclareça apenas ambiguidades que mudem a análise.
- Para indicadores da plataforma, use `shortcutSalesAnalysis`, `shortcutSalesRanking` e `shortcutRankingProducts`. Para evolução visual, use `visualizar_vendas`; para evolução diária entre períodos, `comparar_periodos_vendas`.
- Quando o recorte exigir SQL, consulte primeiro `explorar_dados_empresa` e as definições pertinentes em `consultar_definicoes_metricas`. Execute pelas ferramentas de consulta personalizada. Identifique o resultado como análise personalizada; não prometa equivalência com a tela.

## Interpretar

- Compare períodos com duração, dias da semana e maturação compatíveis. Mês parcial não equivale a mês completo. Horário da consulta não comprova atualização dos dados.
- O resumo padrão de vendas exclui lojas marcadas como fechadas; não transfira essa regra automaticamente para produtos ou SQL. Preserve o recorte da fonte e declare seu efeito histórico. Em análise personalizada, não exclua lojas do histórico apenas pelo estado atual. A comparação pública não garante mesmas lojas: confirme a população antes de usar esse termo.
- Separe lojas sem movimento de lojas com desempenho baixo. Investigue mudança de composição da rede antes de atribuir a variação à operação.
- Decomponha receita em atendimentos e ticket; depois, quando os universos permitirem, em peças por atendimento e valor por peça. Calcule razões pelos totais compatíveis, nunca pela média simples dos tickets. Compradores distintos não são atendimentos e não se somam entre lojas ou períodos.
- Priorize contribuição absoluta e participação, além da variação percentual. Informe bases pequenas; com base zero, mostre a mudança absoluta sem inventar crescimento percentual.
- Diferencie receita, peças e frequência nas compras. Preserve a granularidade de produto ou variante; não interprete receita como margem, vendas como demanda total ou ausência de venda como falta de estoque.
- Nome vazio, genérico ou conflitante é sinal para investigar cadastro. Meça o impacto no universo consultado. Não exclua itens pelo nome ou pela ausência de foto; frete, embalagem e serviços podem ser registros legítimos. Toda classificação ou exclusão adicional deve ter critério explícito, preservando o total original.
- Preserve as regras da métrica para devoluções, preços e cancelamentos. Não remova quantidades negativas como limpeza padrão. Evite multiplicar valores ao juntar itens, compras, cadastros e imagens.
- Em cestas, conte compras distintas com os produtos, deduplicando compra e produto antes dos cruzamentos. Mesmo cliente não significa mesma compra. Participação, confiança ou lift exigem denominadores do mesmo universo; coocorrência não prova efeito de uma oferta.
- Não transforme ausências em zero nem um top N em total da rede. Preserve produtos sem foto e explicite resultados parciais.

## Responder e aprofundar

Apresente o achado principal, empresa, período, recorte e fonte clicável retornada pelo MCP. Separe evidência de hipótese. Use o visual suportado quando ajudar e complemente com interpretação, sem repetir todo o ranking.

Faça a decomposição necessária para responder. Quando houver um sinal útil, sugira um próximo recorte e diga o que ele ajudará a decidir. Por exemplo: ticket menor → peças por atendimento e valor por peça; queda concentrada → mix das lojas afetadas; combinação frequente → distribuição entre lojas. Não trans

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 1 — file references are metadata, not package contents.