# Agente de Planeamento de Receitas e Refeições de IA

> Um agente inteligente de planeamento de refeições construído com Agno que o ajuda a descobrir receitas, analisar nutrição, estimar custos e criar planos de refeições semanais com base nos seus ingredientes e preferências alimentares.

- Fonte: https://doutorai.pt/apps/ai-recipe-meal-planning-agent
- Categoria: Agentes Avançados
- Dificuldade: Médio
- Modelos: OpenAI
- Frameworks: Agno
- Corre local?: Precisa de APIs cloud
- Chaves necessárias: OPENAI_API_KEY, SPOONACULAR_API_KEY
- Licença: Apache-2.0
- Site: Doutor AI (https://doutorai.pt) - ferramentas de IA para pequenos negócios em português

## Tutorial completo

# 🍽️ AI Recipe & Meal Planning Agent

Um agente inteligente de planeamento de refeições construído com Agno que te ajuda a descobrir receitas, analisar nutrição, estimar custos e criar planos de refeições semanais com base nos teus ingredientes e preferências dietéticas.

## Funcionalidades

🔍 **Descoberta de Receitas**
- Encontra receitas com base nos ingredientes disponíveis
- Suporte para restrições dietéticas (vegetariano, vegano, keto, paleo, etc.)
- Sugestões de substituição de ingredientes
- Instruções de cozedura detalhadas e tempos

📊 **Análise Nutricional**
- Análise nutricional abrangente por porção
- Avaliações de saúde fáceis de entender
- Acompanhamento de calorias, proteínas, hidratos de carbono e gorduras
- Análise do conteúdo de sódio e fibra

💰 **Estimativa de Custos**
- Estimativa de custos de supermercado para ingredientes
- Sugestões de refeições económicas
- Cálculos de custo por porção

📅 **Planeamento Semanal de Refeições**
- Planos de refeições equilibrados para qualquer tamanho de agregado familiar
- Acomodação de preferências dietéticas
- Otimização da lista de compras
- Planeamento consciente do orçamento

🧠 **Conversas Baseadas em Sessões**
- Lembra-se do contexto durante a tua sessão atual no navegador
- Preferências não são mantidas após reinício (sem armazenamento a longo prazo)

### Como Começar?

1. Clona o repositório do GitHub

```bash
git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
cd advanced_ai_agents/single_agent_apps/ai_recipe_meal_planning_agent
```

```markdown
# 2. Instala as dependências necessárias:

```bash
npm install
```
```

```bash
pip install -r requirements.txt
```

```markdown
3. Obtém a tua chave de API da OpenAI

- Regista-te para uma [conta OpenAI](https://platform.openai.com/) e obtém a tua chave de API.

4. Obtém a tua chave de API da Spoonacular

- Regista-te para uma [conta Spoonacular](https://spoonacular.com/food-api) e obtém a tua chave de API (plano gratuito ~50 pedidos/dia).

5. Cria um ficheiro `.env` nesta pasta
```

```bash
# Required
OPENAI_API_KEY=your_openai_api_key_here

# Optional but recommended for full recipe & nutrition functionality
SPOONACULAR_API_KEY=your_spoonacular_api_key_here
```

```markdown
# 6. Executa a Aplicação Streamlit

Para executar a aplicação Streamlit, utiliza o seguinte comando no terminal:

```bash
streamlit run app.py
```

Depois de executar o comando, deves ver uma mensagem no terminal que indica que a aplicação está a ser executada. Abre o teu navegador e vai até a seguinte URL:

```
http://localhost:8501
```

Agora deves conseguir ver a aplicação em funcionamento. Explora as funcionalidades e interage com os elementos disponíveis.
```

```bash
streamlit run ai_recipe_meal_planning_agent.py
```

```markdown
7. Abre o teu navegador em `http://localhost:8501`

## Interacções Exemplares

**Descoberta de Receitas:**
- "Tenho frango, brócolos e arroz. O que posso fazer?"
- "Encontra-me receitas veganas com lentilhas"
- "Mostra-me ideias de jantares rápidos de 30 minutos"

**Análise Nutricional:**
- "Qual é o conteúdo nutricional desta receita?"
- "Esta refeição é rica em proteínas?"
- "Quantas calorias por porção?"

**Planeamento de Refeições:**
- "Cria um plano de refeições vegetarianas para 2 pessoas durante uma semana"
- "Preciso de um plano de refeições com baixo teor de sódio"
- "Planeia refeições económicas para uma família de 4"

**Estimativa de Custos:**
- "Quanto vão custar estes ingredientes?"
- "Qual é a opção mais económica?"
- "Estima os custos semanais de supermercado para este plano de refeições"

## Arquitetura da Aplicação

### Construído com o Agno Framework
- **Agente**: Agente de planeamento de refeições alimentado pelo OpenAI GPT-5 mini
- **Memória**: Memória de conversação para recomendações personalizadas
- **Ferramentas**: Ferramentas personalizadas para pesquisa e análise de receitas + pesquisa web DuckDuckGo
- **Interface**: Aplicação web Streamlit

### Ferramentas Personalizadas
1. `search_recipes(ingredients, diet_type=None)` - Descoberta de receitas via Spoonacular API com instruções detalhadas
2. `analyze_nutrition(recipe_name)` - Análise nutricional detalhada via Spoonacular
3. `estimate_costs(ingredients, servings=4)` - Planeamento orçamental e estimativa de custos
4. `create_meal_plan(dietary_preference="balanced", people=2, days=7, budget="moderate")` - Planeamento abrangente de refeições semanais com lista de compras
5. `DuckDuckGoTools` - Pesquisa web para contexto adicional

### Tecnologias Chave
- **Agno**: Framework de agente de IA
- **Streamlit**: Interface web e interação com o utilizador
- **Spoonacular API**: Dados de receitas e nutrição
- **OpenAI GPT-5 mini**: Compreensão e geração de linguagem natural

## Personalização

### Adicionando Novas Preferências Alimentares
Modifica a ferramenta `search_recipes` para incluir tipos de dieta adicionais suportados pela Spoonacular API.

### Extensão da Base de Dados de Custos
Atualiza o dicionário `ingredient_costs` em `estimate_grocery_costs()` com preços locais.

### Categorias de Refeições Personalizadas
Edita as `meal_categories` em `create_weekly_meal_plan()` para corresponder às tuas preferências.

## Resolução de Problemas

**Problemas com a Chave da API:**
- Assegura-te de que o teu ficheiro `.env` está no diretório correto
- Verifica se as chaves da API são válidas e têm créditos suficientes
- Confirma o formato da chave da API (sem espaços ou aspas extras)
 - Nota: Sem `SPOONACULAR_API_KEY`, a pesquisa de receitas e as ferramentas nutricionais irão retornar um erro; outras funcionalidades ainda irão carregar.

**Pesquisa de Receitas Não Funciona:**
- Verifica se a chave da API Spoonacular está configurada corretamente
- Confirma os teus limites de utilização da API (150 pedidos/dia para o nível gratuito)
- Tenta pesquisas de ingredientes mais simples

**Problemas de Memória:**
- O agente utiliza memória de conversação para recordar preferências
- Limpa o cache do navegador se estiveres a ter problemas persistentes
- Reinicia a aplicação para redefinir o histórico de conversação

## Contribuição

Sente-te à vontade para contribuir:
- Adicionando novas fontes de receitas ou APIs
- Melhorando algoritmos de análise nutricional
- Aumentando a precisão da estimativa de custos
- Adicionando novas funcionalidades de planeamento de refeições

## Licença

Este projeto é de código aberto. Por favor, verifica o repositório principal para detalhes da licença.

## Suporte

Para questões e problemas:
- Consulta a secção de resolução de problemas acima
- Revê a documentação do Agno
- Abre um problema no repositório principal
```

## Poupe horas todas as semanas com IA, sem complicações

O **Doutor AI** dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe. [Ver planos →](https://doutorai.pt/precos)

---
Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/apps/ai-recipe-meal-planning-agent