analyze_creative_visual
ChatGPTQuando usar: - Usuário pede análise visual de um criativo, análise do anúncio (imagem ou vídeo), ou feedback sobre o criativo. - Quer que a IA 'veja' a mídia do anúncio e responda com base nela.
create_artifact
ChatGPTCria um novo dashboard (artifact) com gráficos, tabelas e métricas. Use para salvar visualizações de dados como um dashboard compartilhável. Cada widget deve ter um ID único, tipo, dados e posição no grid. Em gráficos de quebra (dispositivo, navegador, canal etc.), inclua TODAS as categorias retornadas pela tool de dados; se omitir alguma por ser desprezível, registre a omissão em um widget de texto. Números vão como número (não texto formatado) com format; funil vai como widget funnel.
create_kanban_card
ChatGPTCria um novo card em uma coluna do Kanban da company. O Kanban tem 4 colunas FIXAS (Backlog, A Fazer, Em Progresso, Concluído) — use os UUIDs listados no schema de column_id. Default razoável quando o usuário não especifica: 'A Fazer' (00000000-0000-4000-a000-000000000002). assigned_to é OPCIONAL — não pergunte ao usuário sobre responsável; só atribua se ele pedir explicitamente. SEMPRE classifique o card em uma ou mais áreas via labels — escolha entre as opções fixas listadas no schema.…
create_kanban_column
ChatGPTCria uma nova coluna no Kanban da empresa (compartilhada entre todos os users da company). A coluna é adicionada no final do board.
cube_dashboard_create
ChatGPTQuando usar: - Criar um dashboard novo (vazio ou já com consultas salvas). - Fazer uma cópia editável de um dashboard compartilhado com o usuário (copy_from_dashboard_id). Antes de chamar, confirme: - Fluxo para 'monta um dashboard com X, Y e Z': 1) rode cada card com cube_query; 2) cube_dashboard_create com rows na ordem do plano e cada card direto nelas ({ from_ref, title }, viz só para mudar o gráfico sugerido): cada card vira uma consulta salva, editável depois. Se mostra o plano antes ou não, quem diz são as instruções da conversa. - rows decide o layout. Ordem: resumo (KPIs juntos) → tendência no tempo (série longa numa linha só dela) → quebras em pares (canal, pagamento, dia da semana) → detalhe (tabela grande). Pizza ao lado de um gráfico com weight 2 no gráfico. - Com imagem ou layout de referência, rows reproduz as linhas dela. Só diga que seguiu o layout (ou a imagem) se passou rows com ele. - Sem rows, o servidor monta pelo conteúdo (largura e altura pelo resultado salvo), sem buraco. Definições: - O dashboard pertence ao usuário e à empresa; compartilhar é só pela tela. Exemplo: {"title":"Vendas","rows":[[{"from_ref":"3f9a2c1d","title":"Receita"},{"from_ref":"7b1e09aa","title":"Pedidos"}],[{"from_ref":"c41d5e02","title":"Receita por dia"}],[{"from_ref":"9e2f7a10","title":"ROAS por canal","weight":2},{"id":"q_pizza_pagamento"}]]}
cube_dashboard_edit
ChatGPTQuando usar: - Mudar o dashboard em si: adicionar/remover card, mudar posição ou tamanho, período de um card, nome, período padrão, desfazer. Antes de chamar, confirme: - Leia com cube_dashboard_get antes (ids dos cards e posições atuais). - remove_card tira o card do dashboard; a consulta continua salva. - undo sozinho numa chamada: desfaz a última mudança do dashboard (inclusive arrastar na tela). - Para mudar O QUE um card mostra (métrica, gráfico, filtro), use cube_query_update na consulta dele. - Não compartilha nem exclui: isso o usuário faz na tela do dashboard. Definições: - Layout por linhas (a coluna linha do cube_dashboard_get): add_card/move_card com row (entra naquela linha), new_row (linha só dele) ou after (ao lado de um card); a linha se redivide e a de onde o card saiu também. Sem nada disso, o add_card põe KPI na linha de KPIs e card de meia largura ao lado de quem está sozinho. - move_card só com w muda a largura do card na linha (w=40: ele fica com 40 e os vizinhos dividem os outros 20); com h, a altura. A altura sai do conteúdo quando não vem h. - Grade de 60 colunas: x = coluna (0-59), y = linha da grade, w = largura (60 = largura toda), h = altura (~80px por linha). - period_mode: follow = segue o período do topo; fixed = sempre o período salvo na consulta. Exemplo: {"dashboard_id":"…","operations":[{"action":"add_card","query_id":"…","after":"<card_id do gráfico de receita>"},{"action":"move_card","card_id":"…","new_row":true,"row":1},{"action":"set_default_period","period":{"preset":"last_7_days"}}]}
cube_dashboard_from_template
ChatGPTQuando usar: - Recriar uma tela da plataforma que tem modelo ("recria a tela de Pedidos", "quero a Visão Geral como dashboard"): cria o dashboard com os cards da tela, sem supor como ela é. - Pedido de um modelo pronto pelo nome ("crie o dashboard da Black Friday usando o modelo pronto"; é o que o botão "Criar dashboard" da campanha manda). Antes de chamar, confirme: - Modelos: black-friday = Black Friday; dashboard-geral = Dashboard Geral; dashboard-ecommerce = Dashboard Ecommerce; web-analytics = Web Analytics; influenciadores = Influenciadores; jornada-do-cliente = Jornada do Cliente; pedidos = Pedidos; visao-geral = Visão Geral; produtos = Produtos; marketing = Marketing; clientes = Clientes. Definições: - Cada card é conferido contra o catálogo da loja; o que não estiver disponível fica de fora, com o motivo. Exemplo: {"template":"black-friday"}
cube_dashboard_get
ChatGPTQuando usar: - Antes de editar um dashboard: traz os cards (ids, consultas, posições) e as últimas mudanças. - Com query_id: lê uma consulta salva (spec + gráfico) para alterar ou copiar. Antes de chamar, confirme: - Mensagem com [Dashboard: <id>] vem da tela desse dashboard; [Consulta: <id>] vem da tela de uma consulta: comece por aqui. - Cada card mostra a consulta completa (JSON), para você alterar com cube_query_update. Definições: - O layout é por linhas (0 = a de cima): cada linha divide a largura toda entre os seus cards. Use row/after/new_row para pôr ou mover card. - Grade de 60 colunas (12 por KPI quando são 5): x = coluna (0-59), y = linha da grade, w = largura, h = altura (~80px por linha). Exemplo: cube_dashboard_get({ dashboard_id: "..." })
cube_dashboard_list
ChatGPTQuando usar: - O usuário fala de 'meus dashboards', de um dashboard pelo nome, ou quer montar/editar um e você precisa dos ids. - Antes de adicionar ao dashboard uma consulta que já foi salva (evita duplicar). Antes de chamar, confirme: - Lista dashboards e consultas salvas do usuário e os compartilhados com ele (só leitura). Definições: - Consulta salva = uma pergunta ao Cube + o gráfico; vira card em um ou mais dashboards. Exemplo: cube_dashboard_list({})
cube_describe
ChatGPTQuando usar: - Antes de montar um cube_query: descobrir qual view responde a pergunta e os nomes EXATOS dos campos. - Sem argumentos lista as views; com view traz a descrição completa (regras de negócio) e os campos. - Com search procura um termo em inglês (ex: "roas", "coupon", "stock") em views e campos. Antes de chamar, confirme: - Leia a descrição da view antes de usar uma measure: ela traz as regras de status, o que entra no cálculo e as armadilhas. O padrão de status, gasto e lucro das respostas é o da descrição do cube_query. - Descreva no mesmo passo todas as views que a resposta vai usar: escolha pela lista antes da primeira consulta e chame cube_describe para todas em paralelo (uma chamada por view). - Não chame de novo para uma view que já descreveu nesta conversa. Definições: - measure: número agregado (ex: spend_with_meta_tax, approved_revenue). dimension: campo para agrupar ou filtrar (ex: campaign_id, day). - Os tipos entre parênteses dizem se a measure soma (sum/count) ou não (countDistinct, number = razão/taxa). Exemplo: cube_describe({ view: "attribution_view" })
cube_export
ChatGPTQuando usar: - O usuário quer a lista inteira, um arquivo, CSV ou planilha de um resultado do cube_query que passa das linhas mostradas (todos os pedidos, a base de clientes, todos os produtos). Antes de chamar, confirme: - Rode o cube_query antes, com as colunas da lista, e passe o ref dele. A exportação roda a mesma consulta sem o corte de linhas, até 50.000. - Não transcreva centenas de linhas no texto: mande o link que esta tool devolve e mostre só as primeiras linhas como amostra. Definições: - O link baixa um CSV (separador ;, decimal com vírgula) e vale 7 dias. Exemplo: cube_export({ from_ref: "a1b2c3d4", file_name: "pedidos-pix-julho" })
cube_query
ChatGPTQuando usar: - Perguntas sobre dados da loja cobertos pela camada semântica: pedidos, receita, produtos e estoque, gasto e resultados de marketing (canal, campanha, anúncio), atribuição (5 modelos oficiais e modelos customizados), funil e eventos do site, clientes/RFM/cohort, influenciadores e custos do dashboard. - É a única fonte de dados da loja nesta conversa: toda pergunta sobre números passa por aqui. Antes de chamar, confirme: - Rode cube_describe da view antes e use os nomes exatos dos campos (nome curto, sem o prefixo da view). company_id é automático. - STATUS PADRÃO (o do chat antigo): vendas, pedidos, receita e ticket sem status pedido = só APROVADOS (approved_ ou a medida de aprovados que a descrição da view indica); todos os status (measures total_ ou sem prefixo) só quando o usuário pedir. Vale no lugar do STATUS DEFAULT das descrições das views. Diga o status usado. Lucro, custos e taxas só existem para aprovados. Card de dashboard segue a barra de Status da tela (medidas de todos os status), salvo pedido de travar. - ATRIBUIÇÃO: attribution_view usa um modelo por consulta (padrão paid_last_click = Last Click Pago, o das telas); nunca some modelos. Impacto Total por canal: measures distinct_, e o total do período é distinct_ sem quebra, nunca a soma das linhas. Pergunta ESPECÍFICA de influenciador (vendas, pedidos, receita, ranking ou hora a hora) segue a regra da tela de Influenciadores: orders_view agrupando ou filtrando por influencer_name / influencer_key (cupom primeiro, depois link; influencer_attribution diz qual); custo e comissão em influencer_costs_view. Influenciador como um canal entre outros, outros canais ou visão geral: attribution_view. - Venda por canal/campanha/anúncio vem da attribution_view (Google Shopping/sag_organic conta em orgânico, como no Tracking). orders_view é para listar/filtrar pedidos. - LUCRO E GASTO PADRÃO (no lugar dos padrões das descrições das views): gasto, custo de marketing e as razões de gasto (ROAS, CPA, CAC, ROI, CPC, CPM) vêm com o imposto da Meta (spend_with_meta_tax, marketing_cost_with_meta_tax e as _with_meta_tax). No dashboard_daily_view, lucro, margem e custo total já descontam o frete pela regra da empresa e o imposto sobre venda (net_profit_with_shipping_and_tax, net_margin_with_shipping_and_tax, total_cost_with_shipping_and_tax). Sem frete e imposto (net_profit, net_margin, total_cost) ou sem o imposto da Meta (spend, marketing_cost, roas, cpa...) só quando o usuário pedir. O imposto sobre venda usa a regra e a alíquota ATUAIS da empresa no período inteiro. Fora do lucro: taxa fixa mensal de checkout e taxas de marketplace. - LUCRO POR CANAL, CAMPANHA OU ANÚNCIO (padrão: com frete pela regra, imposto sobre venda e gasto com o imposto da Meta): id vendas = attribution_view (approved_revenue, net_profit_before_spend, sales_tax_before_spend, sales_tax_spend_rate) junto com o gasto, e computed lucro com total "sum" e margem = "lucro / vendas.approved_revenue 100". Por canal: join_type full em channel com id gasto = marketing_channels_view (spend e spend_with_meta_tax, com filtro channel notEquals influencer: esse channel é só o fixo de influenciador, sem a categoria) e id influ = influencer_costs_view (cost = fixo + comissão de influenciador, por channel, que é a categoria cadastrada ou Influenciador, igual à atribuição e ao chat antigo); lucro = "coalesce(vendas.net_profit_before_spend, 0) - coalesce(gasto.spend_with_meta_tax, 0) - coalesce(influ.cost, 0) + min((coalesce(gasto.spend, 0) + coalesce(influ.cost, 0)) coalesce(vendas.sales_tax_spend_rate, 0), coalesce(vendas.sales_tax_before_spend, 0))". Por campanha ou anúncio: join_type full em campaign_id / ad_id com id gasto = marketing_view (spend e spend_with_meta_tax), como o chat antigo: campanha ou anúncio com venda e sem gasto no período também entra; lucro = "coalesce(vendas.net_profit_before_spend, 0) - coalesce(gasto.spend_with_meta_tax, 0) + min(coalesce(gasto.spend, 0) coalesce(vendas.sales_tax_spend_rate, 0), coalesce(vendas.sales_tax_before_spend, 0))". O coalesce põe 0 no lado que …
cube_query_save
ChatGPTQuando usar: - O usuário quer guardar um gráfico/tabela ('salva isso', 'coloca no meu dashboard'). Dashboard novo: cube_dashboard_create com os cards nas rows. - Com dashboard_id, salva E coloca como card no dashboard numa chamada só. Antes de chamar, confirme: - Rode a consulta com cube_query ANTES e salve com o from_ref que ele devolveu: grava a mesma consulta, sem você reescrever a spec. A spec inteira só para salvar algo diferente do que rodou. - viz.x e viz.y usam os nomes de coluna do resultado do cube_query (ex.: period, source, gasto.spend, roas). - Série no tempo: granularity (hour/day/week/month; hour só até 7 dias) na spec, viz line/area com x = period. - Funil: viz {"kind":"funnel","y":["sessions_count","content_views_count","add_to_cart_count","initiate_checkout_count"]} sem x, numa consulta de uma linha (sem granularity nem dimensão), com as etapas na ordem do funil. Com a etapa numa dimensão: x = a etapa e uma medida em y. - No dashboard o período vem do topo (period_mode follow): a spec pode manter um preset como padrão. - Variação contra o período anterior: o card de número (kpi) já mostra sozinho, a partir do período do topo. Salve só a métrica, com preset e period_mode follow; nunca com datas travadas (start/end), duas subconsultas ou computed de variação. - Não salve duas vezes a mesma consulta: veja cube_dashboard_list. Definições: - Consulta salva pertence ao usuário e à empresa; pode aparecer em vários dashboards. Exemplo: {"title":"Receita por dia","from_ref":"3f9a2c1d","viz":{"kind":"line","x":"period","y":["revenue"]},"dashboard_id":"…"}
cube_query_update
ChatGPTQuando usar: - Mudar o que um card mostra: trocar para linha por semana, top 5, outra métrica, outro título. - Desfazer a última mudança de uma consulta (undo: true). Antes de chamar, confirme: - A mudança vale em TODOS os dashboards onde a consulta aparece (a resposta lista quais). - Só consultas do próprio usuário; as compartilhadas são só leitura (salve uma cópia com cube_query_save). - Mudou a consulta? Rode a nova com cube_query antes e mande o from_ref que ele devolveu; ajuste viz.x/viz.y aos nomes novos das colunas. Definições: - from_ref (ou spec) e viz, quando enviados, substituem os atuais por inteiro. Exemplo: {"query_id":"…","viz":{"kind":"bar","x":"source","y":["spend"],"horizontal":true}}
delete_artifact
ChatGPTDeleta um dashboard (artifact).
delete_kanban_card
ChatGPTDeleta um card do Kanban.
delete_kanban_column
ChatGPTDeleta uma coluna do Kanban (e todos os cards dentro dela).
get_artifact
ChatGPTBusca um dashboard (artifact) pelo ID. Retorna todos os widgets e dados.
get_creative_patterns
ChatGPTQuando usar: - Usuário quer saber O QUE OS CRIATIVOS BONS TÊM EM COMUM, não qual anúncio é o melhor: 'que padrão está funcionando', 'vídeo ou estático rende mais', 'qual ângulo converte', 'o que devo produzir', 'análise comparativa de criativos'. - Perguntas sobre ATRIBUTO do criativo: 'qual tática de hook funciona melhor', 'UGC ou estúdio', 'depoimento ou demonstração', 'frete grátis converte mais que desconto', 'que tema de mensagem rende', 'pra qual público os anúncios falam'. A seção AI Tags responde isso mesmo em conta sem convenção de nome. - Listar os anúncios de uma tag ('quais criativos usam hook de prova social'): passe ai_tag. - Comparar COORTES de criativo (formato, etapa de funil, objetivo, praça, tática, versão de teste) em vez de peças individuais. - Ver o que foi LANÇADO na janela e como esses criativos novos estão performando. - Depois de get_creative_scores, quando a pergunta virar 'e agora, o que eu faço com isso'.
get_creative_scores
ChatGPTQuando usar: - Usuário quer SCORES/NOTAS de criativos Meta: 'score dos criativos', 'nota dos anúncios', 'quais criativos estão bem', 'ranking de qualidade dos criativos', 'hook score', 'creative score'. - Análise de hook rate × hold rate × clique × conversão por criativo — esta tool devolve os 4 scores 0-100 PRONTOS e determinísticos. NÃO recalcule scores na mão a partir de get_ad_performance: cada recálculo manual dá um número diferente. - Detecção de fadiga criativa e tendência: a tool compara com o snapshot anterior gravado e devolve Δ do score geral + badge de Fadiga. - AI TAGS / classificação de um anúncio específico: 'quais as tags do anúncio X', 'esse anúncio é UGC?', 'que hook esse criativo usa'. Passe ad com o id ou um trecho do nome.
get_google_activity_log
ChatGPTQuando usar: - Usuário pergunta o que mudou nas campanhas, grupos de anúncios ou anúncios do Google Ads em um período. - Quer saber quem pausou, criou, ativou ou editou uma campanha/grupo/anúncio do Google e quando. - Quer investigar por que métricas do Google caíram ou subiram — verificando se houve alterações manuais na conta. - Quer auditoria ou rastreabilidade de mudanças na conta Google Ads (histórico de alterações / change history). - Pergunta tipo: 'alguém mexeu nas campanhas do Google ontem?', 'o que mudou no Google esta semana?', 'quem pausou os anúncios?', 'mudaram algum orçamento no Google Ads?', 'por que o custo mudou de repente?' - Quer correlacionar uma queda/pico de performance com uma mudança operacional na conta Google.
get_kanban_board
ChatGPTRetorna o quadro Kanban completo da empresa ativa — colunas e cards compartilhados por todos os usuários da company. Use antes de criar/mover/deletar cards.
get_meta_activity_log
ChatGPTQuando usar: - Usuário pergunta o que mudou nas campanhas, adsets ou ads do Meta em um período. - Quer saber quem pausou, criou, ativou ou editou uma campanha/adset/ad e quando. - Quer investigar por que métricas caíram ou subiram — verificando se houve alterações manuais na conta. - Quer auditoria ou rastreabilidade de mudanças na conta de anúncios Meta. - Pergunta tipo: 'alguém mexeu nas campanhas ontem?', 'o que mudou esta semana?', 'quem pausou os anúncios?', 'houve alguma edição de orçamento?', 'por que o spend mudou de repente?' - Quer correlacionar uma queda/pico de performance com uma mudança operacional na conta.
list_artifacts
ChatGPTLista todos os dashboards (artifacts) da empresa. Retorna título, quantidade de widgets e status de compartilhamento.
move_kanban_card
ChatGPTMove um card para outra coluna e/ou reordena dentro da mesma coluna. Usado pelo drag-and-drop do Kanban.
search_ads_library
ChatGPTQuando usar: - Usuário quer ver anúncios ativos de concorrentes no Facebook ou Instagram. - Quer mapear criativos, mensagens, ofertas, formatos usados por marcas específicas. - Quer identificar 'criativos vencedores' (ads que rodam há muito tempo). - Perguntas tipo: 'quais anúncios a Lenny Niemeyer está rodando?', 'me mostra os criativos atuais da Havaianas', 'o que [marca] anuncia em moda praia?'. - Funciona pra QUALQUER marca com presença na Meta Ads Library web (incluindo marcas BR regionais pequenas).
solomon_google_login_start
ChatGPTInicia o login com Google. Devolve {url, state}: o cliente deve abrir url numa nova janela e fazer polling em solomon_google_login_status({state}) ate completar. Use APENAS quando o usuario clicar em 'Entrar com Google' no widget de login. Para funcionarios do dominio @solomon.com.br, passe intent: 'internal'.
solomon_google_login_status
ChatGPTVerifica o resultado do Google OAuth iniciado por solomon_google_login_start. Devolve {status:'pending'} enquanto o usuario nao completou o flow ou {status:'authenticated', ...} quando o callback gravou as credenciais.
solomon_login
ChatGPTLogin na empresa: define em qual empresa da conta Solomon a conversa está logada. Sem 'company', lista as empresas a que a conta tem acesso e mostra a ativa (ex.: 'quais empresas tenho?', 'qual minha empresa ativa?'). Com 'company', entra na empresa pedida (nome ou ID, busca parcial; ex.: 'trocar para Ollie'), quando o usuário pedir. A conta já foi autenticada ao conectar (OAuth), então a ferramenta não pede e-mail nem senha; erro de outra ferramenta não se resolve aqui: informe o erro ao usuário.
submit_feedback
ChatGPTEnvia feedback do usuario sobre a qualidade da resposta. Use SEMPRE que o usuario indicar satisfacao ou insatisfacao com uma resposta (ex: 'obrigado', 'isso esta errado', 'perfeito', 'nao era isso'). score=1 para feedback positivo, score=0 para negativo. tool_name deve ser o nome da ultima ferramenta cujo resultado gerou o feedback (ex: 'get_financial_summary'). comment e opcional — inclua se o usuario deu detalhes sobre o que estava errado ou certo.
update_artifact
ChatGPTAtualiza um dashboard — título, descrição ou widgets.
update_kanban_card
ChatGPTAtualiza um card do Kanban — título, descrição, responsável, compartilhamento, ou move para outra coluna.