Contesto prima dell’azione
Struttura, periodo, ruolo e fonti definiscono il perimetro del lavoro. Memoria e recupero dello storico mantengono continuità anche nelle conversazioni lunghe.
AI / AGENTI / PRODOTTO
AI che passa
dalle parole
alle azioni.
Sono Edoardo Caldari. Costruisco agenti AI e i sistemi che li fanno lavorare. In Brainy ho sviluppato Eddie, dall’agente alla sua orchestrazione.
Dal problema al prodotto, un’iterazione alla volta.
FIG. 01IL SISTEMA, IN SINTESI
IL MIO PUNTO DI PARTENZA
Un modello è una possibilità.
Un sistema la porta nel mondo.
01 / IL PROGETTO IN EVIDENZA
brainy
Eddie. Un agente.
Un intero sistema.
Costruiti da me.
Ho costruito da solo Eddie e tutta la sua orchestrazione agentica. Dentro Brainy, l’assistente collega i dati degli hotel alle decisioni e alle operazioni di revenue management.
Scopri BrainyDALLA RICHIESTA ALL’AZIONE
ESEMPIO DI RICHIESTA
“Come possiamo adattare
la strategia tariffaria?”
EddieL’assistente AI di Brainy
AI01Dati realiContesto della struttura
02SimulazioneValutazione della proposta
03ApprovazioneLa decisione resta umana
Un esempio del flusso di pricing. Le simulazioni producono stime da valutare.
DALL’AGENTE AL PRODOTTO
Il mio lavoro, dentro un sistema reale.
Ho progettato e implementato l’agente, i suoi strumenti e la loro orchestrazione: accesso ai dati, delega a specialisti, memoria e flussi operativi. Il lavoro di Eddie prende forma dentro il prodotto Brainy e le sue integrazioni.
DENTRO EDDIE
Quello che Eddie
può fare.
Dalla conversazione agli strumenti del lavoro alberghiero. Sei prospettive sul sistema che ho costruito.Apri una voce per esplorarla.
01Leggere dati e mercatoKPI, tariffe, domanda e reputazione
Eddie interroga KPI, prenotazioni e occupazione, confronta tariffe dei canali e del booking engine e analizza recensioni e feedback. Ricercatori dedicati esplorano competitor ed eventi locali con le relative fonti.
Le letture rispettano le strutture autorizzate e le fonti disponibili. Recensioni pubbliche e questionari privati restano distinti.
02Simulare decisioni di prezzoScenari, tattiche e seconda opinione
Simula una diversa strategia tariffaria senza modificare i prezzi. Nei flussi dedicati verifica gli alert sui dati correnti e propone priorità dal riepilogo disponibile del portafoglio, anche quando l’analisi suggerisce di non intervenire.
Una simulazione è una stima. Una proposta non equivale a un aggiornamento applicato.
03Agire sui sistemi collegatiPricing, restrizioni e onboarding
Gli strumenti operativi aggiornano prezzi e strategie su date e tipologie di camera. Per le restrizioni, il flusso prevede anteprima, conferma e verifica dell’esito. L’onboarding carica strumenti specifici per il gestionale collegato.
Permessi, contesto e compatibilità dell’integrazione definiscono quali azioni sono disponibili.
04Ricordare senza perdere il filoMemoria, storico e contesto
Memoria persistente per fatti e direttive, recupero delle conversazioni precedenti e compattazione dei dialoghi lunghi. Il contesto utile segue il lavoro e le informazioni superate possono essere corrette.
Il recupero dello storico rispetta l’ambito autorizzato. Una vecchia conversazione non concede nuovi permessi.
05Produrre output utilizzabiliGrafici, report, email e offerte
Genera grafici, report HTML e contenuti interattivi che si possono aggiornare nella conversazione. Nei percorsi dedicati prepara bozze email e offerte, riconciliando le tariffe con le fonti disponibili, dando priorità ai prezzi live del booking engine.
I percorsi di generazione, revisione e invio dipendono dal tipo di contenuto e dalle integrazioni abilitate.
06Tornare sui dati nel tempoControlli programmati e follow-up
I controlli programmati rileggono i dati alla scadenza, formulano un verdetto e consegnano il risultato. Frequenza, fuso orario e struttura fanno parte del compito; l’autorizzazione viene ricontrollata all’esecuzione.
Questi controlli autonomi usano strumenti di sola lettura: non modificano le tariffe in assenza dell’utente.
Le capacità descritte fanno parte dell’implementazione di Eddie. La disponibilità dipende da ruolo, contesto, integrazioni e funzionalità abilitate.
02 / COME PENSO I SISTEMI
L’intelligenza
è anche nelle
connessioni.
Il mio interesse è nel lavoro tra i componenti: cosa sa un agente, cosa può fare e come capiamo se lo ha fatto bene.
Strumenti e deleghe mirate
Un agente centrale usa strumenti strutturati e delega ricerche specialistiche quando servono. Letture, simulazioni e scritture hanno scopi e controlli diversi.
Risultati da verificare
Schemi validati, test ed eval, anteprime e verifica degli esiti. Se una scrittura ha un risultato incerto, il passo successivo è rileggere lo stato prima di riprovare.
IL PERCORSO / DAL DOMINIO AL CODICE
Prima degli agenti,
i problemi reali.
Il mio percorso parte dalla gestione alberghiera e dallo studio di come dati, forecasting e tecnologia cambiano le decisioni quotidiane degli hotel.
A Ca’ Foscari ho lavorato sull’impatto di Internet nell’industria alberghiera e sul confronto tra modelli di forecasting per il revenue management. Con Brainy ed Eddie, questo interesse prende forma nell’AI agentica applicata all’ospitalità.
HOSPITALITYREVENUE & FORECASTINGAGENTIC AI
Il mio percorso su LinkedIn 03 / ARCHITETTURA & SCELTE TECNICHE
Dietro una risposta,
un’architettura.
Ho costruito Eddie attorno a un agente centrale: seleziona gli strumenti, recupera il contesto e delega compiti specifici. Qui puoi esplorare le scelte che danno struttura al suo lavoro.
EDDIE / SYSTEM MAP
CONVERSAZIONERichiesta + contestoUtente · struttura · obiettivo
EddieAgente centrale · tool orchestration
CONTESTOMemoriaFatti, direttive,
storico
storico
STRUMENTIToolDati, simulazioni,
azioni
azioni
DELEGASpecialistiRicerca e flussi
dedicati
dedicati
Ambito e controlliPermessi · validazione · verifica degli esiti
01 / CONTEXT ENGINEERING
Memoria che
tiene il filo.
Il contesto corrente e la memoria persistente lavorano insieme. Fatti, direttive e conversazioni precedenti aiutano Eddie a riprendere un compito nel suo ambito.
- Persistenza
- Fatti e direttive aggiornabili quando cambiano le informazioni.
- Recupero
- Storico pertinente alla conversazione e alla struttura autorizzata.
- Compattazione
- Sintesi dei dialoghi lunghi per conservare il contesto utile.
LA SCELTAContinuare il lavoro senza trascinare l’intero storico nel prompt.
02 / TOOL ORCHESTRATION
Ogni azione ha
un contratto.
Eddie accede al prodotto attraverso strumenti strutturati. Lo schema descrive gli input; il contesto determina quali strumenti può usare e su quali strutture.
- Schema
- Parametri tipizzati e validati all’ingresso del tool.
- Ambito
- Strumenti selezionati in base a ruolo, struttura e integrazioni.
- Semantica
- Letture, simulazioni e modifiche hanno scopi ed esiti distinti.
LA SCELTARendere esplicito cosa il modello può chiedere al sistema e come interpretarne la risposta.
03 / SPECIALIST AGENTS
La delega segue
il compito.
Eddie mantiene il punto di contatto con l’utente e può delegare la ricerca web. Altri agenti specializzati operano nei percorsi dedicati del prodotto.
- Ricerca web
- Raccolta di informazioni esterne nel contesto della struttura.
- Mercato
- Ricercatori dedicati per competitor ed eventi locali.
- Valutazione
- Una seconda opinione sugli alert, con fatti e confidenza.
LA SCELTADelimitare obiettivo, strumenti e output di ogni specialista in base al problema.
04 / RELIABILITY
Verificare anche
dopo l’azione.
Nel flusso delle restrizioni, anteprima e conferma precedono l’applicazione. L’esito viene restituito al sistema per capire cosa è successo davvero.
- Prima
- Anteprima collegata alle modifiche proposte e conferma esplicita.
- Dopo
- Ricevute di esecuzione e rilettura dello stato in caso di incertezza.
- Nel tempo
- Test ed eval per verificare strumenti, memoria e gestione del contesto.
LA SCELTATrattare un risultato incerto come qualcosa da verificare prima di ritentare una scrittura.
LE TECNOLOGIE DI EDDIE
Lo stack,
con una ragione.
Ogni componente ha una responsabilità precisa: esporre il prodotto, dare strumenti al modello, conservare il contesto e rendere verificabile il lavoro.
01 / API & STREAMING
Python + FastAPI
ASYNCIO · PYDANTIC · SSEIL SUO RUOLOAPI asincrone e invio progressivo di risposte e avanzamento dei tool al client.
PERCHÉGestire l’attesa di modelli e servizi esterni, mantenendo streaming e contratti tipizzati nello stesso backend Python.
02 / AGENT FRAMEWORK
PydanticAI
CONTEXT · TYPED TOOLS · MCPIL SUO RUOLODefinizione dell’agente, dipendenze, strumenti e output strutturati. Toolset MCP nelle integrazioni abilitate.
PERCHÉTipizzazione, validazione e dependency injection rendono esplicito il passaggio fra il modello e il codice applicativo.
03 / INFERENZA
API Anthropic
RUNTIME ADAPTERSIL SUO RUOLOAccesso ai modelli tramite API e adapter che collegano l’inferenza a istruzioni, schemi e strumenti applicativi.
PERCHÉFar evolvere il runtime mantenendo condivisa l’implementazione degli strumenti e i relativi controlli.
04 / STATO & MEMORIA
Firestore
DOCUMENTI · TRANSAZIONIIL SUO RUOLOConversazioni, memoria persistente, stato operativo e checkpoint delle elaborazioni.
PERCHÉUna struttura a documenti vicina al dominio alberghiero, con transazioni per gestire aggiornamenti concorrenti e stato condiviso.
05 / ANALISI
BigQuery
SQL · DATI ANALITICIIL SUO RUOLOQuery sui dati analitici che alimentano confronti, KPI e letture del revenue management.
PERCHÉTenere separate le analisi SQL dallo stato della conversazione e interrogare i dati pertinenti alla domanda.
06 / ESECUZIONE & JOB
Google Cloud
CLOUD RUN · TASKS · PUB/SUBIL SUO RUOLOServizi applicativi, code durevoli per i controlli programmati e avvio dei flussi di onboarding.
PERCHÉSeparare richiesta interattiva e lavoro differito; usare code, checkpoint e chiavi d’idempotenza per recuperare elaborazioni interrotte.
07 / OSSERVABILITÀ & QUALITÀ
Logfire + pytest
TRACING · PYDANTIC-EVALSIL SUO RUOLOTracciamento dei run, metriche dei turni, test deterministici e valutazione delle risposte.
PERCHÉIndagare latenze ed errori e verificare sia l’uso corretto dei tool sia la qualità della risposta, con valutazioni distinte.
UNA SCELTA TRASVERSALE
Il catalogo dei tool resta patrimonio del prodotto. Gli strumenti applicativi vengono preparati e validati attraverso PydanticAI. Gli adapter collegano runtime e applicazione riutilizzando gli stessi contratti.
Tecnologie e ruoli verificati nell’implementazione. I percorsi attivi dipendono dalla configurazione del prodotto.
04 / CONNESSIONI UMANE
Il prossimo sistema
inizia con una
buona conversazione.
Agenti, prodotti, idee da mettere alla prova.
Il punto di incontro è qui.