Menu Integrado

View saved version →

---
name: analise-operacional
description: Analise a operação de uma unidade usando as tools MCP do Menu Integrado para pedidos, vendas, canais, clientes, avaliações, estoque, iFood, repasses e documentos fiscais. Use quando o usuário pedir métricas, retenção de clientes, avaliações, comparações, alertas de estoque ou investigação operacional de uma ou mais unidades.
---

# Análise operacional

Use as tools MCP para consultar dados reais e combine os resultados apenas quando isso ajudar a responder à pergunta.

## Escopo da unidade

1. Identifique exatamente uma unidade antes de consultar qualquer métrica.
2. Se o usuário não informar a unidade, chame `list_restaurants` e pare para pedir que ele escolha.
3. Se o nome corresponder a mais de uma unidade, mostre as opções e peça confirmação. Não escolha por semelhança.
4. Nunca chame uma tool analítica sem o `restaurant_slug` da unidade escolhida.
5. Cada chamada analítica deve consultar uma única unidade. Para comparar unidades, repita a mesma tool com um slug por vez.
6. Consulte todas as unidades somente quando o usuário pedir isso explicitamente, fazendo chamadas separadas.

Não descubra a unidade chamando métricas em todas as unidades. Não trate a primeira unidade retornada como escolha do usuário.

## Escolha das tools

- Use `get_order_metrics` para um resumo do período sem agrupamento.
- Use `get_order_metrics_grouped` para evolução por dia, semana, mês, trimestre ou ano, podendo também agrupar por dimensões disponíveis.
- Use `sales_by_channel` para comparar canais de venda.
- Use `order_status_summary` para o resumo atual dos pedidos por status.
- Use `get_stock_alerts` para identificar produtos e insumos sem estoque ou abaixo do estoque mínimo cadastrado. Não use esta tool para inferir consumo ou estimar uma data de reposição.
- Use `get_customer_retention_metrics` para medir clientes únicos, novos e recorrentes em um período. Não use esta tool para listar clientes ou obter dados pessoais.
- Use `get_review_metrics` para consultar volume e média das avaliações, distribuição das notas, evolução e comentários recentes. A ferramenta não retorna campos de identificação do cliente; sintetize temas recorrentes sem atribuir falas a pessoas nem repetir dados pessoais que apareçam no comentário.
- Use `get_ifood_metrics` para movimentações financeiras conciliadas e pagamentos do iFood. Para pedidos e descontos do iFood, use também `get_order_metrics`.
- Use `get_repass_metrics` para eventos que impactam o repasse do iFood.
- Use `get_fiscal_metrics` para documentos fiscais e sua relação com pedidos.
- Use `get_products_metrics` quando a pergunta envolver o desempenho agregado dos produtos.

Consulte somente as tools necessárias. Para investigar uma queda, comece pela métrica geral e aprofunde em canais, produtos, avaliações, cancelamentos, iFood, repasses ou fiscal conforme a evidência disponível. Não chame todas as tools por padrão.

## Períodos e resposta

- Use `from` e `to` no formato `YYYY-MM-DD`.
- Para comparar períodos, repita a mesma tool para cada período.
- Informe sempre a unidade e o período consultados.
- Preserve os valores retornados pelo servidor; não estime dados ausentes.
- Diferencie faturamento, quantidade de pedidos, quantidade de itens, cancelamentos, taxas e repasses.
- Apresente primeiro um resumo curto e depois os detalhes relevantes das tools utilizadas.

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

View saved version →

---
name: analise-produtos-catalogo
description: Analise produtos e catálogo de uma unidade usando as tools MCP do Menu Integrado para detalhes, variações, fichas técnicas, métricas, histórico de vendas e imagens. Use quando o usuário pedir informações, desempenho ou atualização explícita do cadastro de um produto.
---

# Análise de produtos e catálogo

Use as tools MCP para consultar o catálogo e o desempenho dos produtos da unidade escolhida. Separe informações cadastrais, ficha técnica e histórico de vendas.

## Escopo e identificação

1. Identifique a unidade antes de consultar o catálogo.
2. Se a unidade não estiver clara, siga a skill `analise-operacional`: use `list_restaurants` e peça a escolha.
3. Use `list_menu_products` uma vez para localizar produtos e filtre o resultado em memória.
4. Se houver mais de um produto compatível, peça confirmação. Não escolha pelo primeiro resultado.
5. Depois de identificar o produto, use o `product_slug` retornado pelo catálogo.

## Escolha das tools

- Use `list_menu_products` para listar ou pesquisar produtos do catálogo.
- Use `list_menu_categories` somente quando precisar escolher uma categoria para atualizar um produto.
- Use `get_product_details` para informações cadastrais do produto.
- Use `get_product_variations` quando o usuário perguntar por variações e seus itens.
- Use `get_product_recipe` quando o usuário pedir a ficha técnica, insumos ou composição.
- Use `get_products_metrics` para desempenho agregado de vários produtos em um período.
- Use `get_product_sales_history` para o histórico de um produto específico, agrupado por dia, semana, mês, trimestre ou ano.

Não chame detalhes, variações ou ficha técnica para todos os produtos quando o usuário pediu apenas uma listagem ou uma busca. Não faça uma chamada de histórico para cada produto quando uma métrica agregada resolver a pergunta.

## Atualização do produto

- Altere o cadastro somente quando o usuário pedir explicitamente a atualização. Atualize apenas os campos solicitados; não infira mudanças em preços ou disponibilidade.
- Identifique a unidade e o produto com as tools de catálogo. Se houver mais de um produto compatível, peça que o usuário escolha antes de alterar o cadastro.
- Se o usuário pedir uma imagem, gere-a com a capacidade disponível no cliente. Se ela não estiver disponível, peça ao usuário que forneça a imagem; não afirme que gerou uma imagem.
- Chame `update_product` com a unidade, o `product_slug` e somente os campos a alterar. Para mudar a categoria, consulte `list_menu_categories` e use o `category_slug` retornado para a mesma unidade. A tool também aceita canais de venda (`platform`, `marketplace`, `establishment`, `internal`), nome, descrição, preços, disponibilidade, informações dietéticas e imagem. Envie imagem como data URL Base64 PNG, JPEG ou WebP, com menos de 5 MB.
- A tool exige o escopo `mcp:write`. Se não estiver disponível, explique que a conexão precisa ser autorizada com permissão para atualizar produtos.
- Só confirme a atualização depois que a tool retornar sucesso.

## Análise e limites

- Para saber quanto um produto vendeu, quando vendeu ou como evoluiu, use `get_product_sales_history` com uma unidade, um produto e um período.
- Para comparar produtos, use `get_products_metrics` uma vez e compare os resultados retornados.
- Para comparar períodos de um produto, repita `get_product_sales_history` para cada período quando necessário.
- Combine detalhes, variações e ficha técnica somente quando a pergunta exigir uma análise do cadastro.
- Não afirme que códigos fiscais, descrições, macros ou custos estão corretos sem dados suficientes.
- Não invente ingredientes, valores nutricionais, margens ou informações que não estejam no retorno das tools.
- Diferencie quantidade de itens vendidos, quantidade de pedidos e faturamento.
- Informe a unidade, o produto e o período usados na resposta.

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

View saved version →

---
name: marketing-anuncios
description: Crie anúncios no Menu Integrado para ativação posterior. Use quando o usuário pedir explicitamente para criar um anúncio.
---

# Criar anúncios

A tool `create_ad` salva o anúncio e o orçamento no Menu Integrado e enfileira `Ads::AfterCreateJob`. O MI replica o anúncio e ativa a campanha no Meta Ads quando processa o job; isso poderá gerar gastos conforme o orçamento diário.

1. Identifique a unidade. Se não estiver clara, use `list_restaurants` e peça que o usuário escolha.
2. Peça as informações que faltarem: nome interno, texto, título, link de destino e orçamento diário na moeda da conta Meta.
3. Não estime nem invente o orçamento diário. O usuário precisa informar o valor.
4. Gere uma imagem PNG ou JPEG com a ferramenta de imagem disponível, ou peça ao usuário que forneça a imagem. Envie como data URL Base64, com menos de 30 MB.
5. A tool exige o escopo `mcp:write` e um plano com acesso a marketing.
6. Após sucesso, confirme que o anúncio foi salvo e que a ativação foi enfileirada. Explique que o MI ativará a campanha ao processar o job e que isso poderá gerar gastos conforme o orçamento diário. Não diga que a campanha já está ativa.

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

View saved version →

---
name: marketing-instagram
description: Crie e publique posts no Instagram de uma unidade pelo MCP do Menu Integrado. Use quando o usuário pedir explicitamente para criar ou publicar um post.
---

# Posts no Instagram

A tool `create_instagram_post` cria o post e coloca sua publicação na fila no Instagram conectado à unidade. Ela não cria um rascunho.

1. Identifique a unidade. Se ela não estiver clara, use `list_restaurants` e peça que o usuário escolha.
2. Use a capacidade de geração de imagem disponível para criar de uma a dez imagens JPEG. Se não houver geração disponível, peça que o usuário forneça as imagens.
3. Envie para a tool o `restaurant_slug`, um `subject`, a legenda opcional e as imagens como data URLs JPEG Base64 (`data:image/jpeg;base64,...`).
4. A tool requer `mcp:write` e um plano com acesso a marketing. Se não estiver disponível, explique o que falta.
5. Confirme que o post foi criado e que a publicação foi colocada na fila apenas após sucesso da tool. Não diga que já foi publicado: a publicação é processada em segundo plano.

Chame a tool somente quando o usuário pedir para criar/publicar o post. Um pedido para escrever uma legenda ou preparar uma ideia não autoriza a publicação.

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

View saved version →

---
name: redigir-mensagens-liquid
description: Ajude a criar ou revisar mensagens e templates Liquid usados no Menu Integrado, consultando as variáveis disponíveis para o contexto correto. Use quando o usuário pedir uma mensagem com personalização Liquid para clientes, pedidos, conversas do chatbot ou promoções.
---

# Redigir mensagens com Liquid

Use `get_liquid_variables` antes de escrever ou revisar um template Liquid do Menu Integrado. A ferramenta é a fonte das variáveis, filtros, exemplos e observações disponíveis em cada contexto.

1. Se o contexto estiver claro, consulte a ferramenta com o contexto correspondente: `customer_message` para mensagens a clientes e ativações; `order_notification` para notificações de pedido; `conversation_message` para respostas e mensagens de conversa do chatbot; `promotion_message` para mensagens de promoções por meta de pedidos.
2. Se o contexto não estiver claro, chame a ferramenta sem contexto, apresente as opções retornadas e pergunte onde a mensagem será usada antes de redigir.
3. Use somente nomes de variáveis e filtros retornados para aquele contexto. Preserve a grafia exata. Não presuma que uma variável de outro contexto esteja disponível.
4. Entregue um template pronto para copiar e explique brevemente as variáveis ou condições usadas quando isso ajudar. Respeite as notas e os exemplos retornados, inclusive condições de disponibilidade.
5. Informe que o resultado é um rascunho para copiar: essa ferramenta não salva nem altera as configurações do chatbot.

Não chame ferramentas de escrita para um pedido de redação ou revisão de mensagem. Só faça alterações no sistema se o usuário pedir explicitamente uma ação de escrita suportada por outra ferramenta.