AI Constructor
L'AI Constructor e una famiglia di agenti specializzati per settore che trasformano una domanda in linguaggio naturale in un piano di chiamate verso fonti dati pubbliche, open-data o servizi enterprise, e producono una risposta utile, sintetica e verificabile.
A differenza della chat documentale tradizionale - che cerca nei tuoi documenti - il Constructor attinge a fonti esterne specializzate per il settore della tua azienda: open-data turistici, banche dati fiscali, registri normativi, API meteo, mobilita pubblica, eventi, e cosi via.
Quando usarlo
Usa il Constructor quando la risposta dipende da dati esterni piu che dai tuoi documenti: pianificazione viaggi, scadenze fiscali aggiornate, conformita normativa internazionale, dati di mercato. Per analisi documentali interne resta la chat standard.
Come funziona
Il Constructor segue un flusso a sei passaggi, completamente automatico:
- Rilevamento intento -- riconosce se la domanda rientra nel dominio del settore (turistico, fiscale, etc.).
- Estrazione entita -- identifica luoghi, date, vincoli, preferenze.
- Pianificazione DSL -- traduce la richiesta in una sequenza di chiamate semantiche (es.
location.geocode,weather.forecast,events.search). - Selezione fornitori -- sceglie i provider migliori (gratuiti prima, a pagamento se configurati).
- Esecuzione -- chiama le API, normalizza i risultati, gestisce i fallback.
- Sintesi -- compone una risposta utile, con livello di confidenza e ipotesi esplicite.
L'utente vede solo la risposta finale: la complessita delle API resta nascosta.
Constructor disponibili
Ogni Constructor e configurato per uno specifico settore. La disponibilita dipende dal piano di abbonamento e dalle integrazioni attive sulla tua azienda.
Tourism Constructor
Il primo Constructor disponibile, pensato per chi opera nel turismo (operatori, agenzie, destination management, hotel).
Cosa puoi chiedere:
Cosa visitare a Firenze in 2 giorni con bambini, evitando le code?
Itinerario di una settimana in Sardegna costa orientale, agosto, viaggiatore solo.
Eventi gratuiti a Bologna nel weekend del 14 giugno.
Che tempo fa a Trapani la prossima settimana?
Moduli DSL coperti (estensione tipica - dipende dal piano):
| Modulo | Casi d'uso |
|---|---|
location.* | Geocoding, normalizzazione luoghi |
places.* | POI, attrazioni, musei, ristoranti per categoria |
route.* | Itinerari A->B, ottimizzazione visite multi-stop |
weather.* | Previsioni, rischio outdoor |
mobility.* | Trasporti pubblici, stazioni, aeroporti |
events.* | Eventi, festival, mostre |
culture.* | Wikipedia/Wikivoyage per contesto storico |
currency.* | Conversioni valute |
images.* | Foto libere Wikimedia Commons |
Fornitori gratuiti (sempre disponibili): OpenStreetMap Nominatim, Overpass, Open-Meteo, Wikipedia, Wikivoyage, Wikidata, Frankfurter, Wikimedia Commons.
Fornitori a chiave (opzionali, configurabili dall'admin): Ticketmaster Discovery (eventi), OpenRouteService (itinerari avanzati), Geoapify (POI extra), OpenWeather.
Booking
Il Tourism Constructor non simula disponibilita di hotel o prezzi voli in tempo reale. Restituisce aree di interesse e guide, mai prenotazioni inventate. Per le prenotazioni reali rinvia ai canali ufficiali.
Constructor settoriali (roadmap)
Ulteriori Constructor in pianificazione o sviluppo: Fiscale (Agenzia delle Entrate), Sanitario (FDA/EMA), Legale (Normattiva esteso), Logistico, Energetico. La configurazione dell'azienda determina quale Constructor e attivo.
Anatomia di una risposta
Ogni risposta del Constructor contiene quattro elementi standard:
1. Risposta diretta
Un blocco conciso che risponde alla domanda. Mai inventato: se i dati sono incompleti, il Constructor lo dichiara esplicitamente.
2. Ipotesi e vincoli
Box dedicato con le assunzioni fatte (es. "ho assunto periodo di alta stagione", "stima a piedi a 13 min/km", "previsione meteo a 7 giorni puo cambiare").
3. Livello di confidenza
| Livello | Significato |
|---|---|
| Alta | Dati ufficiali o open-data verificati, recenti, multipli concordi |
| Media | Dati open-data ragionevoli, fonti singole o stimate |
| Bassa | Dati indiretti (es. articoli enciclopedici), fallback applicato |
4. Fonti
Elenco delle API consultate con timestamp, badge colorato per tipo di fonte, link alle pagine ufficiali quando disponibili. Lo stesso meccanismo di citazione della chat documentale - ogni fatto e tracciabile.
Configurazione AI Constructor
L'amministratore configura quale Constructor e attivo per ogni topic o canvas. La configurazione vive nel canvas DSL della pipeline di chat: il Constructor non e una black-box, e una pipeline visibile e modificabile come ogni altro canvas.
Aspetti che l'admin puo personalizzare:
- Quali moduli DSL abilitare (es. nascondere
events.*se non rilevante). - Quali fornitori a chiave attivare (richiede API key configurata in OAuth e Service Canvas).
- Prompt di sintesi finale, tono, lingua, formato dell'output.
- Combinazione con la ricerca documentale interna (es. trovare prima pacchetti turistici nella KB, poi arricchire con dati esterni).
Per i dettagli operativi vedi Chat DSL (Canvas).
Limiti
- Nessuna prenotazione: il Constructor produce informazioni, non transazioni.
- Dipendenza dalla connettivita: se le API esterne sono lente o offline, applica fallback noti (es. visit time stimato senza routing) marcando confidenza piu bassa.
- Lingua delle fonti: alcune fonti open-data sono parziali in italiano. Il Constructor risponde nella lingua della domanda, eventualmente traducendo i dati origine.
- Rate limit: i provider gratuiti hanno limiti orari (es. Nominatim 1 req/s). Per uso intenso configura provider a pagamento.
Suggerimenti per domande efficaci
- Sii concreto sui vincoli: "in agosto, budget medio, con bambini" produce piani migliori di "in estate".
- Indica la lingua di output preferita se diversa da quella della domanda.
- Chiedi un solo intento per volta: domande multi-intento (es. "itinerario e previsione meteo e cambio valuta") vengono comunque eseguite, ma sequenzialmente. Spezzare aiuta la velocita.
- Fidati delle ipotesi: il box ipotesi esplicita cio che il Constructor ha assunto. Se un'ipotesi e sbagliata, riformula correggendola.
Queria v3.5.0 -- AI Constructor (Tourism reference)