Takeat
Versão da documentação
Prompts

Documentação

Consultar dados com o MCP

Perguntas prontas por assunto para usar com a IA conectada ao MCP: vendas, cardápio, estoque, financeiro, clientes, avaliações e cozinha.

Com o MCP conectado, você pode fazer perguntas sobre o restaurante em linguagem natural. Os prompts abaixo são pontos de partida: troque os trechos entre colchetes e ajuste o período. Todos são somente leitura.

Peça sempre a resposta completa

As ferramentas devolvem os dados em páginas. Para totais e rankings, peça que a IA percorra pagination.next até has_more=false e diga quantas páginas leu. Se ela analisar só parte dos dados, deve avisar.

Prompt base

Cole este bloco no início da conversa para que as próximas perguntas sigam as mesmas regras.

Prompt pronto para usar

Regras para consultar os dados do restaurante

Copie e adapte
Vou fazer perguntas sobre o meu restaurante usando o MCP da Takeat. Regras
para esta conversa:

- Comece com get_restaurant_context e use somente o restaurante e as marcas
  autorizados. Se houver mais de uma loja, use list_restaurants e me pergunte
  qual consultar.
- Não altere nenhum dado, mesmo que eu peça algo parecido com uma alteração;
  nesse caso, me mostre o que mudaria e espere minha confirmação explícita.
- Para totais, médias e rankings, percorra todas as páginas
  (pagination.next até has_more=false). Diga quantos registros e páginas leu.
- Valores monetários vêm em reais; datas de período usam AAAA-MM-DD. Diga
  qual período e fuso você considerou.
- Se um dado não existir na resposta da ferramenta, diga que não existe. Não
  estime nem invente.
- Responda em português, com uma tabela curta quando houver números.
Revise o contexto antes de enviar e nunca inclua credenciais reais.

Vendas e faturamento

Qual foi o faturamento de [MÊS/ANO] por forma de pagamento e por canal?
Compare com o mês anterior. Use get_payments_report.
Quais foram os 10 produtos mais vendidos em [PERÍODO], em quantidade e em
valor? Mostre também a curva ABC. Use get_products_report.
Liste as comandas de [DATA] que usaram o cupom "[CÓDIGO]" e o total de
desconto concedido. Use get_table_sessions com coupon_code.
Quais produtos estão indisponíveis no delivery agora, por marca e categoria?
Use get_menu com channel=delivery.
Quais produtos do catálogo não aparecem publicados em nenhum canal? Compare
get_products com get_menu para in_store e delivery.
Quais grupos de complementos são obrigatórios (mínimo maior que zero) e qual
o limite de escolhas de cada um? Use get_complement_categories.

Estoque e fichas técnicas

Qual é o custo da ficha técnica do produto "[NOME]" e qual ingrediente pesa
mais nesse custo? Use get_products para achar o ID e depois
get_product_technical_sheet.
Liste os insumos com valor total em estoque acima de R$ [VALOR], ordenados do
maior para o menor. Use get_inventory_inputs_registrations e percorra todas as
páginas.

Financeiro

Quais despesas vencem nos próximos 15 dias e ainda não foram pagas? Agrupe
por categoria. Use get_financial_cash_flows.
Quanto entrou e quanto saiu em [MÊS/ANO], considerando só o que já foi pago?
Use os totais de get_financial_cash_flows e explique o que eles incluem.

Clientes, Clube e avaliações

Quantos clientes compraram em [PERÍODO] e quantos deles têm cadastro no
Clube? Use get_customers_report e get_clients com registered_in_clube.
Qual foi a nota média das avaliações em [PERÍODO] e quais comentários
negativos se repetem? Use get_ratings e cite trechos curtos.

Cozinha (KDS)

Qual foi o tempo médio de preparo por estação em [PERÍODO] e quais produtos
mais atrasaram em relação à meta? Use get_kds_report.

Os relatórios do KDS exigem start_date e end_date, cobrem até 92 dias e trazem os tempos em segundos (campos terminados em _s).

Quando a resposta parecer errada

  1. Peça à IA o nome da ferramenta, os argumentos enviados e quantas páginas leu.
  2. Confira o período e o fuso: datas em AAAA-MM-DD são interpretadas no fuso local do restaurante nas ferramentas que aceitam fuso.
  3. Confira as marcas: sem brand_ids, a consulta cobre todas as marcas autorizadas, não as demais.
  4. Compare com o significado do campo na referência. Cada campo de resposta tem uma descrição.

Veja também

On this page