📄️ Introduzione
Questa sezione documenta il Node Agent basato su LangGraph che espone un server HTTP/Socket.IO per chat in tempo reale, caricamento documenti/prodotti e integrazione con servizi esterni (Laravel app, Hatchet worker, Qdrant).
📄️ Chat e Streaming (Socket.IO)
Questa sezione descrive come il Node Agent gestisce la chat in tempo reale e lo streaming delle risposte tramite Socket.IO, inclusa la creazione dei thread e la validazione JWT.
📄️ HTTP API
Endpoint principali esposti dal Node Agent (Express) per gestione chat, caricamenti, coda e monitoraggio.
📄️ Documenti & RAG
Come gestiamo caricamento, indicizzazione e ricerca semantica dei documenti.
📄️ Ricerca Prodotti & Product Cards
Ricerca semantica, recupero dettagli dallo store WooCommerce e generazione di card HTML.
📄️ Embeddings & Vector Store
Come vengono generati e utilizzati gli embeddings, e come interagiamo con Qdrant.
📄️ Monitoraggio & Health
Controlli di salute, logging e monitor della coda.
📄️ Sicurezza & Autenticazione
Validazione JWT su HTTP e Socket, gestione errori e endpoint pubblici.
📄️ Configurazione
Variabili d’ambiente, configurazioni LangGraph e TypeScript.
📄️ Contact Form HITL (LangGraph Interrupt)
Il Node Agent gestisce il modulo di contatto in chat tramite il tool requestContactForm e gli handler Socket.IO dedicati.
📄️ Tool Feedback (messaggi intermedi)
Durante l'esecuzione dei tool LangGraph, l'agente invia messaggi di feedback brevi all'utente per comunicare cosa sta facendo (es. "Sto cercando i prodotti...").