Gerar refeição e cardápio com IA

Como usar o gerador de refeição com IA no cardápio, o que informar em metas, restrições e preferências, e quais são os limites reais do que a IA monta.

Comece pelo que o recurso não é: ele não monta o cardápio inteiro de uma vez. O gerador trabalha uma refeição por vez, e o que ele devolve é uma opção nova dentro daquela refeição — nunca uma substituição do que você já montou. Um plano de cinco refeições são cinco gerações, cada uma com a sua fatia de calorias.

Dito isso, é o atalho mais direto para sair da folha em branco. Você define as metas daquela refeição, a IA volta com uma lista de alimentos e quantidades usando a base do sistema, e o seu trabalho passa a ser corrigir em vez de criar.

Onde fica o botão

Na tela do cardápio, expanda a refeição. Ao lado das abas Opção 1, Opção 2 e do botão +, existe um botão com ícone de estrelinha, com a dica Gerar opção com IA. Ele abre a janela Gerar Refeição com IA, com a descrição Configure as metas nutricionais e deixe a IA criar uma refeição balanceada para você.

Como a refeição precisa existir antes, o gerador não serve para começar do zero absoluto: crie primeiro as refeições do dia, conforme adicionar e editar refeições, e depois gere uma a uma.

As metas: calorias e a soma de 100%

São quatro campos numéricos e uma regra que não perdoa.

Campo	Faixa	Começa em
`Meta de Calorias (kcal)`	50 a 2000	500
`Carboidratos (%)`	0 a 100	50
`Proteínas (%)`	0 a 100	30
`Gorduras (%)`	0 a 100	20

As calorias andam de 50 em 50 e os percentuais de 5 em 5. Dentro do bloco Distribuição de Macronutrientes há um contador Total que atualiza enquanto você digita e acrescenta o alerta em vermelho (deve somar 100%) quando a conta não fecha. Clicar em Gerar Refeição com a soma errada devolve o aviso A soma das porcentagens de macronutrientes deve ser 100% e nada é gerado.

A meta de calorias é por refeição. Se o plano do dia é de 2.200 kcal, não peça 2.200 aqui: distribua, algo como 450 no café, 700 no almoço, 300 no lanche, 600 no jantar e 150 na ceia.

Restrições e preferências

Dois campos de texto livre, ambos opcionais e ambos separados por vírgula:

Restrições Alimentares (opcional) — o que não pode entrar. Exemplo: sem lactose, sem glúten, vegetariano.
Preferências (opcional) — o que o paciente gosta. Exemplo: frutas cítricas, carnes magras, grãos integrais.

Não existe lista fechada: é texto interpretado, então objetividade vale mais que capricho de redação. “sem lactose” funciona melhor que “paciente relata desconforto com laticínios em geral”.

O que a IA pode e o que ela não pode

Os limites são estreitos de propósito, e conhecê-los explica quase todo resultado estranho:

Só usa alimentos que já existem na base, incluindo os seus alimentos personalizados. Não inventa alimento nem valor nutricional.
De 3 a 7 alimentos por refeição. Não espera um prato de doze componentes.
Quantidades em múltiplos de 5 g, entre 5 g e 500 g por item.
Tolerância de cerca de 10% para mais ou para menos em relação à meta de calorias.
Usa o nome e o horário da refeição como contexto. Ele reconhece café, desjejum, lanche, colação, almoço, jantar, ceia, pré-treino e pós-treino, e monta algo coerente com aquele momento do dia. Uma refeição batizada de Refeição 1 recebe uma sugestão genérica; uma batizada de Pós-treino recebe proteína de rápida absorção e carboidrato.
O resultado varia a cada geração, mesmo com os mesmos parâmetros. É o que permite pedir três almoços diferentes sem mudar um campo sequer.

Depois de gerar

Durante o processamento todos os campos ficam bloqueados e o botão mostra Gerando.... Ao terminar, aparece Refeição gerada com sucesso! e uma aba de opção nova surge na refeição, já com os alimentos e as quantidades lançados.

A partir daí é cardápio comum. Você ajusta quantidade clicando na coluna Qtd (g), remove o que não serve pelo × vermelho da linha, acrescenta o que faltou por Adicionar alimento e escreve uma descrição amigável clicando no nome do alimento. Se a sugestão inteira não presta, selecione a aba dela e clique no × com a dica Remover esta opção.

Fechar a janela por Cancelar ou pelo × devolve todos os campos aos valores iniciais: 500 kcal, 50/30/20 e os dois campos de texto vazios. Não há memória entre uma geração e a seguinte.

Quando dá erro

Duas mensagens, com causas bem diferentes:

Serviço de IA não está disponível. Configure ANTHROPIC_API_KEY nas variáveis de ambiente. — o gerador está fora do ar na instalação. Não há nada a ajustar do seu lado: monte a refeição manualmente e tente mais tarde.

Erro ao gerar refeição com IA — falha genérica. Tente de novo em alguns segundos e confira os dois limites que o campo aceita mas o sistema recusa: calorias fora da faixa de 50 a 2000 e percentuais que não somam 100.

O uso que realmente economiza tempo

Gerar uma refeição para substituir o seu trabalho rende pouco — você vai revisar tudo de qualquer forma. O ganho aparece em outro lugar: gerar as alternativas.

Monte o almoço padrão do jeito que você prescreveria, com calma. Depois clique duas vezes na estrelinha com a mesma meta calórica e deixe a IA produzir Opção 2 e Opção 3. Em poucos minutos o paciente tem três almoços equivalentes em vez de um, que é justamente o que mais derruba adesão em cardápio de consultório: o prato único repetido por trinta dias.

Perguntas frequentes

A refeição gerada pela IA substitui a que eu já tinha montado?

Não. A geração cria sempre uma opção nova dentro da refeição, com o nome Opção 2, Opção 3 e assim por diante. Os alimentos que já estavam na opção atual continuam intactos. Se a sugestão não servir, selecione a aba dela e clique no X, com a dica Remover esta opção, para descartar.

Por que aparece "A soma das porcentagens de macronutrientes deve ser 100%"?

Porque Carboidratos (%), Proteínas (%) e Gorduras (%) não fecham em 100. O contador dentro da janela mostra o total em tempo real e acrescenta o alerta em vermelho "deve somar 100%" enquanto a conta não bate. Ao clicar em Gerar Refeição nessa situação, o aviso aparece e nada é gerado. Ajuste um dos três campos e tente de novo.

A IA pode inventar alimentos que não existem na base?

Não. O gerador só usa alimentos que já estão cadastrados na base do sistema, incluindo os seus alimentos personalizados. Ele não cria alimentos novos nem inventa valores nutricionais. Se um ingrediente que você esperava não apareceu na sugestão, provavelmente ele não existe na base ou não pertence às categorias típicas daquele momento do dia.

Qual é a meta máxima de calorias que posso pedir para a IA?

2000 kcal por refeição, com mínimo de 50 kcal. O campo Meta de Calorias (kcal) começa em 500 e anda de 50 em 50. A meta é por refeição, não pelo dia inteiro. Para um plano de 2200 kcal distribuído em cinco refeições, você gera cada refeição separadamente com a fatia de calorias que cabe a ela.

A IA entende que estou montando um café da manhã ou um pré-treino?

Entende. O nome e o horário da refeição são enviados como contexto, e o gerador reconhece café, desjejum, lanche, colação, almoço, jantar, ceia, pré-treino e pós-treino, montando algo coerente com aquele momento — não coloca arroz e feijão no café da manhã. Uma refeição chamada apenas Refeição 1 recebe uma sugestão genérica.

Preciso do plano Pro para usar a geração de refeição com IA?

A geração de refeição com IA faz parte do plano Pro. O restante da tela de cardápio não depende de plano: criar refeições, adicionar alimentos, montar opções manualmente, exportar o PDF e entregar o cardápio ao paciente funcionam igual no plano gratuito.

Posso gerar várias opções de refeição para o mesmo horário?

Pode, e é um dos melhores usos do recurso. Cada clique em Gerar Refeição cria mais uma opção na mesma refeição, então você consegue três almoços alternativos com a mesma meta calórica em poucos minutos. O paciente escolhe qual segue no dia. Lembre que o Total do Dia soma apenas a opção selecionada em cada refeição.

As quantidades geradas pela IA são confiáveis? Preciso revisar?

Precisa revisar sempre. A tolerância de calorias trabalhada pelo gerador é de aproximadamente 10% para mais ou para menos em relação à meta, as quantidades saem arredondadas em múltiplos de 5 g e cada item fica entre 5 g e 500 g. Nada disso substitui conferência clínica — a prescrição continua sendo sua, e as quantidades são editáveis direto na tabela.

O que faço se aparecer "Erro ao gerar refeição com IA"?

É a mensagem genérica de falha. Tente novamente em alguns segundos, e confira se as porcentagens somam 100 e se a meta de calorias está entre 50 e 2000. Se a mensagem for outra, citando ANTHROPIC_API_KEY, o serviço de IA está indisponível na instalação e o problema não é seu — monte a refeição manualmente e tente mais tarde.

Por que a IA gerou uma refeição diferente da anterior com os mesmos dados?

Porque o resultado varia entre uma geração e outra, mesmo com parâmetros idênticos. Isso é característica do recurso, não defeito: é o que permite gerar três opções distintas para o mesmo almoço sem mudar nada nos campos. Se você gostou de uma sugestão, mantenha a opção; ela não é regenerada sozinha.

Continue por aqui

Cardápios e alimentos