71 lines
1.6 KiB
Markdown
71 lines
1.6 KiB
Markdown
# 📝 AI Agents Log
|
|
|
|
## Propósito
|
|
|
|
Este ficheiro regista toda a atividade do agente de recomendação.
|
|
Cada execução gera uma entrada neste log.
|
|
|
|
---
|
|
|
|
## Formato de Entrada
|
|
|
|
### Data:
|
|
YYYY-MM-DD
|
|
|
|
### Agente:
|
|
Recommender-MVP
|
|
|
|
### Tipo:
|
|
- recomendacao
|
|
- erro
|
|
- melhoria
|
|
|
|
### Descrição:
|
|
O que foi feito
|
|
|
|
### Itens afetados:
|
|
Lista de itens usados
|
|
|
|
### Ação tomada:
|
|
O que se decidiu
|
|
|
|
### Notas:
|
|
Observações úteis
|
|
|
|
---
|
|
|
|
## Regras de Logging
|
|
|
|
1. **SEMPRE** registar após cada execução
|
|
2. Tipo `recomendacao` → quando sugestões são geradas com sucesso
|
|
3. Tipo `erro` → quando lista vazia, pedido ambíguo ou dados incompletos
|
|
4. Tipo `melhoria` → quando se detetam problemas no sistema
|
|
5. Nunca omitir entradas de erro — são tão importantes como sucessos
|
|
|
|
---
|
|
|
|
## Histórico
|
|
|
|
### Data:
|
|
2026-04-24
|
|
|
|
### Agente:
|
|
Recommender-MVP
|
|
|
|
### Tipo:
|
|
recomendacao
|
|
|
|
### Descrição:
|
|
Implementação inicial do motor de recomendações MVP. Sistema de regras estáticas com 6 contextos, parser por palavras-chave, logging e deteção de melhorias.
|
|
|
|
### Itens afetados:
|
|
T-shirt preta, Portátil, Nintendo Switch, Fones de ouvido, Passaporte, Carregador USB-C, Jeans azul, Sapatilhas brancas, Mochila, Fato de treino
|
|
|
|
### Ação tomada:
|
|
Criado APPprojetoLP.dart com modelo de dados alinhado com 02_ARCHITECTURE.md, contextos de 05_RECOMMENDATION_ENGINE.md, e tags de 04_CATEGORIES_AND_TAGS.md
|
|
|
|
### Notas:
|
|
- Parser de pedidos é básico (palavras-chave). Fase 2 usará OpenAI API.
|
|
- Clima e formalidade são detetados mas não filtram itens no MVP.
|
|
- Duração "medium" (ex: 4 horas) não tem regras específicas ainda.
|