La funzionalità Commenti AI è un sistema di generazione automatica di commenti analitici basati su intelligenza artificiale, integrato nella piattaforma di monitoraggio 3Bee. Il sistema analizza layer cartografici (NDVI, LST, CLC, aree protette, ecc.), dati di qualità dell'aria e dati provenienti dai dispositivi IoT (PollyX e Spectrum), producendo interpretazioni tecniche multilingue.
Il processo utilizza modelli LLM di ultima generazione: Gemini 3 Pro per l'analisi visiva delle mappe (vision model) e Gemini 3 Flash per la generazione dei commenti testuali. I commenti vengono generati in italiano e tradotti automaticamente nelle lingue supportate dalla piattaforma.
L'automazione è orchestrata tramite una Step Function AWS che quotidianamente: identifica i siti elegibili (con feature automation_ai_comments attiva), accoda le richieste su coda SQS FIFO, monitora lo stato di completamento con polling a intervalli di 10 minuti (timeout massimo 24 ore) e invia email di riepilogo ai proprietari dei siti.
Il sistema di billing prevede un costo di 3 crediti per ogni commento generato, con verifica preventiva della disponibilità di crediti e addebito post-generazione.
| Componente | Dettaglio |
|---|---|
| Modello analisi mappe | Gemini 3 Pro (vision) |
| Modello commenti | Gemini 3 Flash |
| Orchestrazione | AWS Step Function (STANDARD) |
| Coda messaggi | Amazon SQS FIFO |
| Concorrenza max | 10 siti in parallelo |
| Polling status | 10 minuti, max 144 iterazioni (24h) |
| Costo | 3 crediti per commento |
| Retry | 3 tentativi con backoff esponenziale 2× |
| Endpoint | Metodo | Descrizione |
|---|---|---|
/{user_slug}/sites/{site_id}/ai_map_comment | POST | Genera commento AI per un singolo layer |
/{user_slug}/sites/{site_id}/ai_map_comments | POST | Genera commenti AI per più layer |
Rate limit: 1 richiesta ogni 10 minuti, 6 per ora, 12 per giorno.
| Codice | Nome | Provider | Tipo | Copertura | Disponibilità |
|---|---|---|---|---|---|
3BE_OASAI_99 | 3Bee Oasi AI Comments | 3Bee / Google AI | api | Globale | Continua |
automation_ai_comments nella tabella featuresResponsabile: Claudio Barbieri
Generazione automatica di commenti analitici tramite modelli LLM. Fase 1: analisi visiva delle mappe con Gemini 3 Pro (vision model). Fase 2: generazione commento testuale con Gemini 3 Flash. Fase 3: traduzione multilingue automatica. Orchestrazione: AWS Step Function con coda SQS FIFO e polling a 10 minuti. Input: immagini layer cartografici, dati qualità dell'aria, dati dispositivi IoT. Output: commento testuale multilingue. Costo: 3 crediti/commento. Fonte: piattaforma lambda-oasi.