1 line
6.9 KiB
JSON
1 line
6.9 KiB
JSON
{"repo": "ballales1984-wq/newsflow", "files": {"backend/INTEGRAZIONE_AI.md": {"a6b4ff74a7e7c5ddd3ee768e0f4e42b36822f89a": {"t": 1785746615.5879948, "n": 3210, "h": "d87d449eb15bedba", "c": "# 🤖 Integrazione AI per Approfondimenti\n\n## ✅ Cosa è stato implementato\n\n### 1. Servizio AI (`backend/app/ai_explainer.py`)\n- **ChatGPT (OpenAI)**: Supporto completo per spiegazioni AI\n- **DeepSeek**: Alternativa economica con buona qualità\n- **Fallback automatico**: Se le API non sono disponibili, usa spiegazioni statiche migliorate\n\n### 2. Endpoint API (`/api/v1/articles/explain`)\n- **POST** `/api/v1/articles/explain`\n- Genera spiegazioni AI per articoli\n- Supporta 3 tipi: `quick`, `standard`, `deep`\n\n### 3. Frontend aggiornato\n- Chiamate API per spiegazioni AI\n- Indicatori di caricamento\n- Badge \"Powered by AI\"\n- Cache delle spiegazioni (non ricarica se già generate)\n\n---\n\n## 🔧 Configurazione API Keys\n\n### Opzione 1: Variabili d'ambiente (consigliato)\n\nNel file `backend/AVVIA_TUTTO_AUTO.bat` o script di avvio, aggiungi:\n\n```batch\nset OPENAI_API_KEY=sk-tua-chiave-openai\nset DEEPSEEK_API_KEY=sk-tua-chiave-deepseek\n```\n\n### Opzione 2: File `.env` (se supportato)\n\nCrea `backend/.env`:\n```\nOPENAI_API_KEY=sk-tua-chiave-openai\nDEEPSEEK_API_KEY=sk-tua-chiave-deepseek\n```\n\n### Opzione 3: PowerShell (temporaneo)\n\n```powershell\n$env:OPENAI_API_KEY = \"sk-tua-chiave-openai\"\n$env:DEEPSEEK_API_KEY = \"sk-tua-chiave-deepseek\"\n```\n\n---\n\n## 📝 Come ottenere le API Keys\n\n### OpenAI (ChatGPT)\n1. Vai su: https://platform.openai.com/api-keys\n2. Crea un account o accedi\n3. Clicca \"Create new secret key\"\n4. Copia la chiave (inizia con `sk-`)\n\n**Costi**: ~$0.15 per 1M token (modello `gpt-4o-mini`)\n\n### DeepSeek\n1. Vai su: https://platform.deepseek.com/api_keys\n2. Crea un account o accedi\n3. Clicca \"Create API Key\"\n4. Copia la chiave (inizia con `sk-`)\n\n**Costi**: ~$0.14 per 1M token (modello `deepseek-chat`)\n\n---\n\n## 🎯 Come funziona\n\n1. **Utente clicca \"Spiegami questa notizia\"**\n2. **Frontend chiama API** `/api/v1/articles/explain`\n3. **Backend prova ChatGPT** (se API key disponibile)\n4. **Se fallisce, prova DeepSeek** (se API key disponibile)\n5. **Se entrambi falliscono, usa spiegazione statica migliorata**\n\n### Tipi di spiegazione:\n- **Quick (30s)**: Breve, max 150 parole\n- **Standard (3min)**: Dettagliata, max 400 parole\n- **Deep (approfondito)**: Analisi completa, max 800 parole\n\n---\n\n## 💡 Vantaggi\n\n✅ **Spiegazioni uniche**: Ogni articolo ha spiegazioni diverse generate dall'AI\n✅ **Più approfondite**: Le spiegazioni AI sono più dettagliate e contestualizzate\n✅ **Fallback sicuro**: Se le API non sono disponibili, funziona comunque\n✅ **Cache intelligente**: Le spiegazioni vengono cachate per evitare chiamate duplicate\n\n---\n\n## 🚀 Test\n\n1. Avvia il backend\n2. Apri il sito\n3. Clicca \"Spiegami questa notizia\" su un articolo\n4. Vedi l'indicatore di caricamento\n5. La spiegazione AI appare con badge \"Powered by ChatGPT\" o \"Powered by DeepSeek\"\n\n---\n\n## ⚠️ Note importanti\n\n- **Costi**: Ogni spiegazione costa pochi centesimi. Monitora l'uso!\n- **Rate limits**: Le API hanno limiti di chiamate al minuto\n- **Privacy**: Le API keys devono essere mantenute segrete\n- **Fallback**: Se non configuri le API keys, funziona comunque con spiegazioni statiche\n\n---\n\n## 🔒 Sicurezza\n\n**NON COMMITTARE LE API KEYS NEL CODICE!**\n\nUsa sempre variabili d'ambiente o file `.env` (non tracciato da git).\n\n"}, "b0fec24cda4c33d4e9a4b0b9725a0e11e9130990": {"t": 1785766298.8628345, "n": 3210, "h": "d87d449eb15bedba", "c": "# 🤖 Integrazione AI per Approfondimenti\n\n## ✅ Cosa è stato implementato\n\n### 1. Servizio AI (`backend/app/ai_explainer.py`)\n- **ChatGPT (OpenAI)**: Supporto completo per spiegazioni AI\n- **DeepSeek**: Alternativa economica con buona qualità\n- **Fallback automatico**: Se le API non sono disponibili, usa spiegazioni statiche migliorate\n\n### 2. Endpoint API (`/api/v1/articles/explain`)\n- **POST** `/api/v1/articles/explain`\n- Genera spiegazioni AI per articoli\n- Supporta 3 tipi: `quick`, `standard`, `deep`\n\n### 3. Frontend aggiornato\n- Chiamate API per spiegazioni AI\n- Indicatori di caricamento\n- Badge \"Powered by AI\"\n- Cache delle spiegazioni (non ricarica se già generate)\n\n---\n\n## 🔧 Configurazione API Keys\n\n### Opzione 1: Variabili d'ambiente (consigliato)\n\nNel file `backend/AVVIA_TUTTO_AUTO.bat` o script di avvio, aggiungi:\n\n```batch\nset OPENAI_API_KEY=sk-tua-chiave-openai\nset DEEPSEEK_API_KEY=sk-tua-chiave-deepseek\n```\n\n### Opzione 2: File `.env` (se supportato)\n\nCrea `backend/.env`:\n```\nOPENAI_API_KEY=sk-tua-chiave-openai\nDEEPSEEK_API_KEY=sk-tua-chiave-deepseek\n```\n\n### Opzione 3: PowerShell (temporaneo)\n\n```powershell\n$env:OPENAI_API_KEY = \"sk-tua-chiave-openai\"\n$env:DEEPSEEK_API_KEY = \"sk-tua-chiave-deepseek\"\n```\n\n---\n\n## 📝 Come ottenere le API Keys\n\n### OpenAI (ChatGPT)\n1. Vai su: https://platform.openai.com/api-keys\n2. Crea un account o accedi\n3. Clicca \"Create new secret key\"\n4. Copia la chiave (inizia con `sk-`)\n\n**Costi**: ~$0.15 per 1M token (modello `gpt-4o-mini`)\n\n### DeepSeek\n1. Vai su: https://platform.deepseek.com/api_keys\n2. Crea un account o accedi\n3. Clicca \"Create API Key\"\n4. Copia la chiave (inizia con `sk-`)\n\n**Costi**: ~$0.14 per 1M token (modello `deepseek-chat`)\n\n---\n\n## 🎯 Come funziona\n\n1. **Utente clicca \"Spiegami questa notizia\"**\n2. **Frontend chiama API** `/api/v1/articles/explain`\n3. **Backend prova ChatGPT** (se API key disponibile)\n4. **Se fallisce, prova DeepSeek** (se API key disponibile)\n5. **Se entrambi falliscono, usa spiegazione statica migliorata**\n\n### Tipi di spiegazione:\n- **Quick (30s)**: Breve, max 150 parole\n- **Standard (3min)**: Dettagliata, max 400 parole\n- **Deep (approfondito)**: Analisi completa, max 800 parole\n\n---\n\n## 💡 Vantaggi\n\n✅ **Spiegazioni uniche**: Ogni articolo ha spiegazioni diverse generate dall'AI\n✅ **Più approfondite**: Le spiegazioni AI sono più dettagliate e contestualizzate\n✅ **Fallback sicuro**: Se le API non sono disponibili, funziona comunque\n✅ **Cache intelligente**: Le spiegazioni vengono cachate per evitare chiamate duplicate\n\n---\n\n## 🚀 Test\n\n1. Avvia il backend\n2. Apri il sito\n3. Clicca \"Spiegami questa notizia\" su un articolo\n4. Vedi l'indicatore di caricamento\n5. La spiegazione AI appare con badge \"Powered by ChatGPT\" o \"Powered by DeepSeek\"\n\n---\n\n## ⚠️ Note importanti\n\n- **Costi**: Ogni spiegazione costa pochi centesimi. Monitora l'uso!\n- **Rate limits**: Le API hanno limiti di chiamate al minuto\n- **Privacy**: Le API keys devono essere mantenute segrete\n- **Fallback**: Se non configuri le API keys, funziona comunque con spiegazioni statiche\n\n---\n\n## 🔒 Sicurezza\n\n**NON COMMITTARE LE API KEYS NEL CODICE!**\n\nUsa sempre variabili d'ambiente o file `.env` (non tracciato da git).\n\n"}}}} |