comparar_periodos_vendas
ChatGPTUse SEMPRE que o usuário pedir evolução diária comparada entre dois a quatro períodos de vendas, como as semanas das últimas Black Fridays, mesmo sem pedir gráfico. Também use no seguimento "por dia e com ticket médio". Resolva a empresa autorizada, informe os períodos reais nomeados e as métricas solicitadas. O servidor consulta os dados e apresenta gráficos separados por métrica com uma linha por período. Use dia_semana para semanas equivalentes; posicao para comparar dias desde o início. Limite: 31 dias por período. Não invente valores nem gere gráficos adicionais; tabelas solicitadas vão no chat; acompanhe o componente apenas de uma conclusão curta. Não calcula ticket médio do período.
consultar_dados_personalizados
ChatGPTUse para análises visuais personalizadas no catálogo MCP autorizado. Primeiro explore schemas e definições. Envie SQL DuckDB somente leitura com período e recortes pedidos; a Alpha impõe a política de colunas e lojas anunciada no catálogo. Prefira agregados, preserve regras oficiais e não confunda amostra com total. Não gera base, exportação ou alteração. Para tabela ou lista textual, use consultar_tabela_personalizada, sem widget. Para visualizações use linhas para datas ISO, barras para categorias, cards para uma linha numérica. Use aliases legíveis e nomes reais de colunas em dimensao/metrica. Mostre apenas a métrica solicitada. Produtos: inclua id_produto inteiro e nome_produto; use LEFT JOIN com dim_mercadoria_imagens quando disponível por mercadoria_id para retornar imagem_url, agregando imagens antes de joins para não multiplicar métricas. Nunca use geração de imagens para mostrar produtos do catálogo. Sem foto, indique foto indisponível. Não invente URLs nem exclua produtos sem foto. Auto mostra fotos, em grade desktop ou carrossel mobile. Preserve a seleção e ordem pedidas via WHERE, LIMIT e ORDER BY; não transforme lista em ranking sem ordenar. Cestas: explore schemas e use sufixos a até f com id_produto, nome_produto e imagem_url para 2 a 6 produtos; grupos menores têm NULL nos restantes. Use ocorrencias inteira e contexto_associacao=mesma_compra (mesmo_cliente somente se solicitado). Deduplicate compra+produto antes de autojoin id_a<id_b; conte compras, não peças. Até 10 combinações, podendo misturar tamanhos. Use visualizacao=cestas ou auto, nunca tabela dentro do app. Retorne somente os itens suficientes ao pedido, preferencialmente 3 a 8 produtos quando não houver quantidade definida. Resuma os achados e escreva fontes e complementos no chat.
consultar_definicoes_metricas
ChatGPTUse para obter SQL de referência das métricas da plataforma. Não executa SQL nem garante equivalência após adaptação. Vendas, CRM e atendimento usam relatórios CRM; envios usa seu serviço. Para campanhas informe relatorio: pontuais, email, sms, wpp_oficial ou wpp_vendedor. Clientes não possui referência disponível. A métrica pode ser nome ou slug; se houver ambiguidade, consulte sem metrica para listar slugs exatos.
consultar_tabela_personalizada
ChatGPTUse quando o usuário pedir tabela, lista textual ou dados sem necessidade de gráfico/fotos. Retorna os dados para resposta no próprio chat, sem widget. Explore schemas primeiro e preserve regras oficiais, autorização, recorte e política de acesso. Executa a mesma consulta somente leitura de consultar_dados_personalizados.
explorar_dados_empresa
ChatGPTUse antes de consultas personalizadas em qualquer domínio. Sem tabelas, lista o catálogo MCP autorizado; com tabelas, retorna seus schemas. Confira a política de colunas e lojas retornada pela fonte; WHERE restringe o recorte. O catálogo revisado não disponibiliza documentos, PINs ou contatos pessoais. Não invente nomes de tabelas, colunas ou vínculos.
filtros_valores_categoricos
ChatGPTUse para localizar lojas ou campanhas pelo nome antes de consultar seus indicadores. Em nomes ambíguos, peça esclarecimento ao usuário. Para buscar campanhas pelo nome, informe também o período. Envie id_empresa obtido de listar_empresas_disponiveis para a empresa pedida; use o nome na resposta. Datas no formato YYYY-MM-DD.
listar_empresas_disponiveis
ChatGPTUse para descobrir as empresas autorizadas da sessão. Retorna nome e ID; apresente nomes ao usuário e use IDs somente nas chamadas às ferramentas.
shortcutCRMAnalysis
ChatGPTUse para consultar indicadores consolidados de CRM, como retenção, churn e base ativa. Envie id_empresa obtido de listar_empresas_disponiveis para a empresa pedida; use o nome na resposta. Datas no formato YYYY-MM-DD.
shortcutCRMTimeline
ChatGPTUse para consultar a evolução temporal dos indicadores de CRM. Envie id_empresa obtido de listar_empresas_disponiveis para a empresa pedida; use o nome na resposta. Datas no formato YYYY-MM-DD.
shortcutCampaignMetrics
ChatGPTUse para consultar os indicadores do detalhe de uma campanha pontual com compras e eventos filtrados pelo período. O ranking usa outro recorte temporal; não trate os valores como equivalentes. Resolva o ID com shortcutCampaignRanking ou filtros_valores_categoricos antes de usar campaign_id. Envie id_empresa obtido de listar_empresas_disponiveis para a empresa pedida; use o nome na resposta. Datas no formato YYYY-MM-DD.
shortcutCampaignRanking
ChatGPTUse para ordenar campanhas pontuais com envio no período. Atenção: a receita do ranking é o histórico atribuído às campanhas selecionadas, não apenas compras no período. Para receita de uma campanha no mês, use shortcutCampaignMetrics. Envie id_empresa obtido de listar_empresas_disponiveis para a empresa pedida; use o nome na resposta. Datas no formato YYYY-MM-DD.
shortcutCampaignReport
ChatGPTUse para consultar o resumo da tela de campanhas: dashboard mensal ou campanhas pontuais. O dashboard aceita mês completo ou mês atual até ontem. Ao citar o dashboard mensal, diga que o usuário deve selecionar o mesmo mês na tela: a URL não carrega esse filtro. Envie id_empresa obtido de listar_empresas_disponiveis para a empresa pedida; use o nome na resposta. Datas no formato YYYY-MM-DD.
shortcutRankingProducts
ChatGPTUse para consultar em tabela o ranking de produtos da plataforma por receita ou quantidade. Preserva id_produto e url_imagem da fonte. Para ranking com fotos ou cartões, prefira visualizar_produtos: ela consulta o mesmo ranking oficial e abre o componente, sem SQL personalizado. Nunca use geração de imagens para representar produtos cadastrados; sem foto, mostre foto indisponível. Envie id_empresa obtido de listar_empresas_disponiveis para a empresa pedida; use o nome na resposta. Datas no formato YYYY-MM-DD.
shortcutSalesAnalysis
ChatGPTUse para consultar indicadores consolidados de vendas e comparar períodos. Envie id_empresa obtido de listar_empresas_disponiveis para a empresa pedida; use o nome na resposta. Datas no formato YYYY-MM-DD.
shortcutSalesRanking
ChatGPTUse para consultar o ranking de vendas por loja. Envie id_empresa obtido de listar_empresas_disponiveis para a empresa pedida; use o nome na resposta. Datas no formato YYYY-MM-DD.
visualizar_produtos
ChatGPTPrefira quando o usuário pedir produtos mais vendidos com fotos ou cartões. Consulta o ranking oficial por receita ou quantidade e abre o componente com nomes e fotos reais cadastradas, sem SQL personalizado ou descoberta de catálogo. Resolve a empresa com listar_empresas_disponiveis e valida suas lojas em cada chamada. Não aceita valores, imagens, URLs ou IDs de produtos fornecidos pelo modelo. Preserva o ranking da fonte e produtos sem foto. Use de 3 a 8 itens por padrão; limite máximo 10. Não consulte shortcutRankingProducts antes só para abrir o visual. Para pedido apenas de tabela, use shortcutRankingProducts e responda no chat.
visualizar_vendas
ChatGPTPrefira esta ferramenta quando o usuário pedir evolução ou ranking de vendas, mesmo sem pedir gráfico. Para evolução comparada entre vários períodos, use comparar_periodos_vendas. Escolha resumo para indicadores, evolucao para tendência diária, ranking para comparar lojas ou resumo_e_evolucao quando o pedido incluir indicadores e gráfico do mesmo período; esta última opção mostra as duas visões em um app. A ferramenta consulta dados reais com as permissões da sessão; não passe valores calculados ou dados copiados. Resolve a empresa com listar_empresas_disponiveis. Envie metricas com apenas os indicadores pedidos; não ofereça seletores de análises extras. Para pedido só de tabela ou número pontual, prefira as tools de dados e responda no chat. Retorna também os dados para resposta textual. Limite do ranking: 10 lojas por receita. O host compatível exibe o componente: não repita para renderizar o mesmo recorte e não produza um gráfico adicional.