Caso di studio · Atravesar Services · atravesar.ca
Un livello di assistente IA sopra una vera operazione di riparazione e logistica inversa
Per Atravesar Services — azienda canadese di riparazione, ricondizionamento e logistica inversa di elettronica — SolvoSync ha costruito il sito web pubblico, la piattaforma aziendale sottostante e un assistente IA che risponde ai clienti in nove lingue tramite generazione aumentata dal recupero e strumenti del Model Context Protocol. Presentato dal vivo a NATEA Toronto il 21 ottobre 2026.
- servizi interni
- 9
- righe di Python
- ~175K
- lingue, una sola base di conoscenza
- 9
- strumenti dell'assistente in allow-list
- 10
- per risposta IA a prezzo di listino
- US$0.004
- del codice è il livello IA
- ≈3%
Il cliente
Dai resi dei clienti al ritorno al cliente
Atravesar Services è un'azienda canadese di riparazione, ricondizionamento e logistica inversa di elettronica, con un ufficio a Richmond Hill e un laboratorio di riparazione con magazzino a Markham, che serve tutto il Paese tramite corriere. Gestisce programmi B2B di riparazione e resi per produttori e rivenditori, offre la riparazione per posta ai consumatori ed è il fornitore esclusivo autorizzato del post-vendita Narwal in Canada, con supporto per ECOVACS e Segway/Ninebot.
Ogni giorno il team rispondeva alle stesse domande: dov'è il mio pacco? Cosa significa l'errore E12? Quanto costa la riparazione con le imposte in Québec? Il mio ordine di lavoro è già in riparazione? Ogni risposta esisteva già — in un documento, in un database o nell'API di un corriere. L'incarico: lasciare che sia il software a rispondere, in sicurezza, 24 ore su 24, nella lingua del cliente.
-
Ufficio a Richmond Hill · Laboratorio di riparazione e magazzino a Markham · Servizio in tutto il Canada tramite corriere
-
Fornitore esclusivo autorizzato del post-vendita Narwal in Canada · Supporto ECOVACS e Segway/Ninebot
-
Robot aspirapolvere · monopattini elettrici · smartphone · tablet · laptop · console · piccoli elettrodomestici
-
EN简体繁體日本語한국어Tiếng ViệtESITFR
Principio di progettazione
L'IA legge, comprende e dialoga. Il software decide, registra e paga.
L'architettura traccia una linea esplicita. Un livello di assistente si colloca sopra il flusso di lavoro quotidiano e raggiunge l'azienda solo attraverso porte strette, con un nome e registrate — strumenti e API. Sotto, software ordinario con autenticazione, autorizzazione e tracciabilità decide i prezzi, registra gli ordini di lavoro e muove il denaro.
-
Livello di assistente IA
Legge, comprende, cerca e risponde alle persone — nella loro lingua, a qualsiasi ora.
-
Porte strette, con un nome e registrate
Ordini, pagamenti, magazzino, spedizioni, tracciamento e assistenza sono raggiungibili solo tramite strumenti in allow-list con schemi JSON. Il modello non tocca mai un database.
-
Sicurezza e controllo
Autenticazione (chi sei?), autorizzazione (cosa puoi vedere o fare?) e tracciabilità (cosa è successo — registrato e verificabile).
Ciò che già faceva funzionare l'azienda
Nove servizi, circa 175.000 righe di Python
Il sito web è la parte visibile. Dietro di esso, SolvoSync ha progettato e gestisce la piattaforma che fa funzionare l'azienda — gestione magazzino e RMA, spedizioni multi-corriere, pagamenti e imposte, identità, ispezioni e integrazioni con i produttori. Il livello IA è circa il 3% del codice; tutto il resto è la disciplina che eredita.
-
7.7K LOC
www · Sito web pubblico
9 lingue · pagine dei servizi e guide · modulo fuori garanzia · widget chatbot · caricamento conoscenza per l'amministratore · llms.txt
-
59.5K LOC
Flow · WMS / RMA
Ricezione · inventario · ricambi · RMA · ordini di consegna · pallet · ECOVACS ESB · Mammotion FS Cloud · LSS · 31 file di test
-
50.6K LOC
Fulfill · Spedizioni
UPS · Canpar · Canada Post · Purolator (ShipEngine) · Freightcom · tariffe, etichette, ritiri, manifesti, tracciamento · audit di fatturazione EDI 210
-
5.2K LOC
Payment · Pagamenti e imposte
Stripe Checkout + webhook · imposte canadesi per codice postale (GST/HST/PST/QST) · fatture su S3 · report settimanale
-
2.6K LOC
SSO · Identità
Account · OAuth2 client-credentials · ruoli ADMIN, CUSTOMER, DEALER, RECEIVER, REPAIR, TECH, SHIPPER · ambiti per fornitore
-
35.4K LOC
Track · Sistema digitale
Sistema precedente di inventario / RMA · front end React + TypeScript
-
10.0K LOC
Maintain · Ispezione attrezzature
Liste di controllo, foto, firme, report pianificati
-
2.8K LOC
Mammotion · Script del produttore
Riparazione in deposito FS Cloud, ricambi, RMA ed esportazioni delle spedizioni in sospeso
-
0.6K LOC
Inventario fisico
Scansione etichette AVS ↔ EAN, segnalazione unità mancanti, esportazione Excel
- AWS EC2 (Ubuntu)
- RDS MySQL
- S3
- Redis
- nginx + gunicorn
- Flask
- React + TypeScript
- Qdrant
- Gemini API
- Stripe
- Google Places
LOC = righe di Python escludendo ambienti virtuali, migrazioni e pacchetti di terze parti, conteggiate a ottobre 2026.
Il livello di assistente IA
Gemini + RAG + MCP: dove si innesta l'assistente
L'assistente AVS vive su www.atravesar.ca, protetto da un token legato alla sessione e da limiti di frequenza. Funziona con Gemini Flash e function calling — al massimo quattro round di strumenti per risposta — recupera la conoscenza da un database vettoriale Qdrant e raggiunge spedizioni, imposte e identità tramite endpoint MCP e di funzione, ognuno con la propria autenticazione, i propri limiti e i propri log.
-
1
Assistente di conoscenza (RAG)
Il personale carica PDF, Markdown o testo da una pagina di amministrazione. I documenti vengono suddivisi in blocchi (≈1.000 caratteri, 150 di sovrapposizione), vettorizzati con gemini-embedding-001 in vettori a 768 dimensioni e salvati in Qdrant. Ogni domanda recupera i cinque passaggi migliori per similarità del coseno e il modello risponde a partire da essi, citando la fonte. Documenti in inglese rispondono a domande in nove lingue.
-
2
Assistente con strumenti (function calling e MCP)
Uno strumento è un nome, una descrizione e uno schema JSON. Il modello sceglie lo strumento e gli argomenti, il nostro codice lo esegue con un token di servizio OAuth2 e il modello spiega il risultato. Il server MCP delle spedizioni parla MCP su Streamable HTTP (JSON-RPC 2.0), così una sola integrazione serve oggi il chatbot del sito, domani un assistente desktop per il personale e in seguito agenti dei partner con chiavi ad ambito limitato.
-
3
Automazione dei flussi (senza modello)
Pagamento confermato → crea etichetta → crea ordine di lavoro → email. Le regole per prezzo, imposte, numerazione e transizioni di fase vivono in codice deterministico e testato — è qui che si muovono denaro e registrazioni.
Il catalogo degli strumenti, come distribuito
Regola di progettazione n. 1: il modello non tocca mai il database — chiede strumenti.
| Strumento | Viene eseguito in | Cosa fa | Guardrail |
|---|---|---|---|
| search_knowledge_base | www → Qdrant | Ricerca semantica; restituisce i cinque passaggi migliori con fonte e titolo. | Sola lettura; al modello è richiesto di citare e di non inventare mai. |
| share_oow_webform | www | Restituisce l'URL del modulo fuori garanzia nella lingua dell'utente. | Il modello non può raccogliere i campi del modulo in chat. |
| list_provincial_tax_rates calculate_tax |
Payment | GST/HST/PST/QST per provincia o codice postale; beni vs servizi. | Calcolo Decimal deterministico; il modello non calcola mai le imposte. |
| rate_shipment track_shipment |
Shipment MCP (fulfillapi) | Tariffe dei corrieri; tracciamento tramite UPS 1Z / Canpar D / PIN Canada Post o riferimento cliente. | Token di servizio OAuth2; sola lettura. |
| email_waybill validate_address |
Shipment MCP (fulfillapi) | Reinvia un'etichetta all'indirizzo registrato; corrispondenza dell'indirizzo verificata da Google. | Email solo al contatto della spedizione; solo Canada/USA. |
| get_account_info get_account_access |
SSO MCP | Profilo dell'account e quali dati dei fornitori un utente può vedere. | Token lato server; limitato al fornitore. |
| clear_chat_history | www | Cancella la conversazione di questo browser. | Limitato alla sessione. |
Limiti: al massimo 4 round di strumenti per risposta · ogni risultato di strumento ≤ 12.000 caratteri · 5 passaggi per ricerca · nessuno strumento scrive nel database · nessuno strumento muove denaro.
Un flusso di lavoro, end-to-end
Il percorso di riparazione fuori garanzia
IA all'inizio e alla fine — la conversazione. In mezzo, software ordinario e testabile. Costruito da un piccolo team su sistemi che l'azienda già possedeva.
-
Un cliente chiede all'assistente: «Il mio Narwal è fuori garanzia — potete ripararlo?». Lo strumento share_oow_webform restituisce il link del modulo nella lingua del cliente; nessun dato personale viene raccolto in chat.
-
Il modulo in quattro passaggi raccoglie dispositivo, problema e indirizzo — validato con Google Places — con opzione di consegna a mano o spedizione.
-
Il preventivo è calcolato dal codice: una tariffa di ispezione di 40 $, le imposte del codice postale dal servizio pagamenti e la tariffa corriere in tempo reale più bassa (corrieri interrogati in parallelo) con un ricarico fisso.
-
Stripe Checkout incassa ispezione e spedizione; una fattura PDF con termini a 15 giorni viene inviata via email.
-
Un webhook verificato crea l'ordine di lavoro AVSOOW{AAMMGG}#### e lo apre in Flow nella fase «Receiving»; un'etichetta di spedizione con il corriere più economico e un codice QR vengono inviati al cliente via email.
-
Il dispositivo viene ricevuto e ispezionato, viene emesso un preventivo di riparazione pagato con un secondo pagamento Stripe e l'ordine di lavoro passa a «Repair».
-
Il dispositivo riparato viene rispedito con il tracciamento via email — e l'assistente risponde a «Dov'è la mia spedizione?» per tutto il tempo tramite l'MCP delle spedizioni.
L'automazione semplice porta la maggior parte del valore
Dove deliberatamente non usiamo l'IA
- Prezzi e imposte
- Calcolo Decimal con arrotondamento bancario e regole provinciali per prefisso postale, nel servizio pagamenti.
- Scelta del corriere
- Regole: casella postale → Canada Post; produttori preferiti → Canpar; limite di frequenza UPS → alternativa; altrimenti la tariffa in tempo reale più economica.
- Ordini di lavoro e fasi
- Numeri univoci e una macchina a fasi (Receiving → Repair → …) in Flow, coperta da 31 file di test.
- Audit di fatturazione
- Analisi notturna delle fatture EDI 210 (UPS, Canpar) rispetto alla tariffa preventivata, con report automatici di sovrafatturazione.
- Pagamenti e identità
- Stripe Checkout con webhook verificati, fatture e ricevute su S3; SSO con ruoli, OAuth2 client-credentials tra servizi e MFA per il personale.
- Attività pianificate e integrazioni con i produttori
- Tracciamento due volte ogni giorno lavorativo, email di avviso settimanale, importazioni dai produttori tre volte al giorno; ECOVACS SEEBURGER ESB, Mammotion FS Cloud e LSS — contratti, non conversazioni.
Regola pratica: se il risultato deve essere esatto, ripetibile e spiegabile a un commercialista o a un avvocato, è codice. L'IA gli sta accanto, spiegando e indirizzando.
Sicurezza e controllo sottostanti
Autenticazione, autorizzazione, tracciabilità
Autenticazione — chi sei?
- SSO per personale e partner; MFA sugli accessi al sistema di spedizione.
- Token OAuth2 client-credentials tra i servizi (Fulfill, Payment, SSO).
- Sessione del chatbot: JWT HttpOnly legato a IP e browser per 30 minuti; controllo same-origin e blacklist Redis contro gli abusi.
Autorizzazione — cosa puoi vedere o fare?
- Ruoli ADMIN, CUSTOMER, DEALER, RECEIVER, REPAIR, TECH, SHIPPER; i partner vedono solo i dati del proprio fornitore.
- Il modello non possiede credenziali — solo strumenti in allow-list.
- Gli strumenti sono in sola lettura, tranne l'invio di un'etichetta al contatto della spedizione e la cancellazione della propria chat.
Tracciabilità — cosa è successo?
- Ogni turno di chat registrato: sessione, domanda, risposta, strumenti usati, versione del modello; esportazione CSV.
- Webhook Stripe verificati; eventi di pagamento e fatture archiviati su S3.
- Riconciliazione notturna EDI 210 delle fatture dei corrieri con i preventivi; report automatici settimanali.
Niente di tutto questo è specifico dell'IA. È la disciplina che si vuole comunque — il livello IA semplicemente la eredita.
Risultati
Cosa offre
-
I clienti ottengono risposte su garanzie, codici di errore, imposte, spedizioni e processo di riparazione in nove lingue, 24 ore su 24, con le fonti citate.
-
L'accettazione fuori garanzia va dalla prima domanda all'ordine di lavoro pagato senza che il personale digiti un preventivo, un'etichetta o un'email.
-
Una sola integrazione MCP serve oggi l'assistente del sito ed è pronta per gli assistenti di personale e partner — senza una seconda integrazione.
-
Il costo per risposta si misura in centesimi: circa 0,004 US$ a prezzo di listino, circa 45 US$ per 10.000 risposte al mese.
-
Ogni turno di chat è registrato con gli strumenti usati e la versione del modello — la qualità migliora leggendo i log e correggendo i documenti, non riaddestrando.
Ingegneria onesta: le modalità di guasto previste — e cosa è successo davvero
- Allucinazione
- Ancoraggio ai passaggi recuperati, ricerche obbligatorie per i fatti, temperatura 0,4, passaggio all'email. Cosa è successo: le prime risposte su orari e indirizzo venivano dalla conoscenza generale — corretto con la regola di ricerca.
- Prompt injection
- Un prompt-policy e strumenti vincolati da schema; nulla di sensibile da sbloccare — nessun elenco telefonico, nessuno strumento di pagamento. Cosa è successo: la gente ci prova; i rifiuti reggono perché le capacità sono ristrette.
- Interruzione
- Gli errori degli strumenti vengono restituiti come dati e il bot continua a rispondere dalla conoscenza; i corrieri sono interrogati in parallelo con alternative basate su regole. Cosa è successo: limite di frequenza dell'API di un corriere → corriere alternativo.
- Deriva del modello
- Un alias di modello fluttuante cambia tono, verbosità e uso degli strumenti senza che te ne accorga. La versione del modello è registrata a ogni turno e un set di regressione di domande reali viene rieseguito a ogni cambiamento.
Cosa diremmo a noi stessi un anno fa
Nove lezioni di ingegneria
-
01
Parti dalle domande già presenti nella tua casella di posta — non dalla tecnologia.
-
02
Strumenti prima dei prompt: quando il modello deve conoscere qualcosa di dinamico, aggiungi uno strumento, non un paragrafo.
-
03
Mantieni la base di conoscenza noiosa: PDF e Markdown che il tuo personale già gestisce.
-
04
Blocca il modello e registra la versione — gli alias fluttuanti cambiano il comportamento a tua insaputa.
-
05
Degrada con grazia: gli errori degli strumenti sono dati; il bot continua a funzionare quando una dipendenza è giù.
-
06
Metti un tetto a tutto — round, caratteri, token, frequenza. Il consumo illimitato è una fattura reale.
-
07
Il denaro dietro Stripe e i moduli, mai dietro una finestra di chat.
-
08
Usa gli standard: MCP + OAuth2 hanno reso l'integrazione riutilizzabile per client non ancora costruiti.
-
09
Costruisci prima la pagina di amministrazione: caricare documenti, leggere i log — è da lì che nasce la qualità.
Decima, in omaggio: scrivi il prompt di sistema come una policy — versionalo, revisionalo, testalo come codice.
Presentato dal vivo
NATEA Toronto · IA per le piccole e medie imprese
- 60 min · intervento e demo dal vivo · online
Relatore: Nelson Lai — SolvoSync · CTO, Atravesar Services
Un intervento di 60 minuti con demo dal vivo il 21 ottobre 2026 (online), che mostra come un'attività retail funziona su atravesar.ca e dove l'IA si guadagna davvero il suo posto: cosa dicono i dati 2026 di Statistics Canada sull'adozione dell'IA nelle PMI, i tre modelli — conoscenza, strumenti, automazione — due demo in produzione, la checklist di sicurezza e privacy per il Canada e un piano di avvio in quattro settimane.
Il 19% delle aziende canadesi usa l'IA, il 25% pianifica di farlo e il 40% pensa che non sia rilevante. La rilevanza è nella tua casella di posta.
Le domande che ci fanno su questo progetto
Come impedite all'assistente di inventare le risposte?
I fatti provengono dai passaggi recuperati o dagli strumenti, mai dalla memoria del modello: il prompt di sistema impone una ricerca nella base di conoscenza per indirizzi, orari e policy, la temperatura è 0,4 e l'assistente passa all'email quando gli strumenti non possono rispondere. Le prime risposte sugli orari di apertura venivano dalla conoscenza generale; la regola di ricerca ha risolto il problema.
Quanto costa una risposta IA?
Ai prezzi di listino di ottobre 2026 una risposta — circa 12.000 token in ingresso più 300 in uscita — costa circa 0,004 US$, quindi 10.000 risposte al mese sono circa 45 US$. Il costo reale è l'ingegneria e la manutenzione dei contenuti, non i token.
La mia azienda potrebbe riutilizzare questo approccio o i server MCP?
Sì. Il livello degli strumenti è costruito su standard aperti — MCP su Streamable HTTP con OAuth2 client-credentials — quindi gli stessi server possono servire qualsiasi assistente. SolvoSync costruisce lo stesso modello per altre piccole e medie imprese: partire dalle domande già nella casella di posta, rilasciare un canale in quattro settimane, misurare prima di affermare.
Come vengono gestiti i dati personali?
I dati personali restano fuori dalla finestra di chat. L'assistente indirizza le persone a moduli con consenso, validazione e Stripe; i segreti restano lato server; le sessioni sono token HttpOnly legati a IP e browser; e ogni turno è registrato con la versione del modello. La progettazione segue i principi del PIPEDA e della Legge 25 del Québec: il modello non decide — decidono il codice e le persone.
Vuoi lo stesso per la tua azienda?
SolvoSync progetta, costruisce e gestisce il sito web, le integrazioni e il livello di assistente IA — partendo dalle domande già nella tua casella di posta, con un canale online in quattro settimane.