Manuela 2.0: L'IA rivoluziona la documentazione tecnica

Manuela 2.0: L'IA rivoluziona la documentazione tecnica

Immagina di dover cercare un'informazione specifica in oltre 130 pagine di documentazione tecnica. Quanto tempo impiegheresti? E se potessi semplicemente chiedere e ottenere una risposta immediata?

In Memori abbiamo affrontato questa sfida sviluppando Manuela 2.0, un sistema rivoluzionario che trasforma la documentazione statica in un assistente virtuale intelligente.

Grazie all'integrazione con AIsuru, Manuela 2.0 non si limita a cercare informazioni: comprende le domande degli utenti e fornisce risposte precise e contestualizzate.

L'architettura che fa la differenza

Manuela 2.0 non è un semplice motore di ricerca documentale. È un sistema sofisticato che combina quattro componenti chiave per garantire risposte precise e contestualizzate:

  1. Documentazione Gitbook:
    1. Una documentazione completa organizzata in capitoli tematici strutturati e i contenuti aggiornati. LINK.
  2. Sistema di scraping intelligente:
    1. Un sistema di elaborazione automatica della documentazione che pulisce i dati e li divide in file sulla base dei capitoli;
  3. Servizio web per esporre i capitoli:
    1. Un servizio web utile a rendere disponibili i capitoli tramite un URL accessibile dalle function di AIsuru.
  4. Piattaforma AIsuru:
    1. Un sistema di IA che gestisce la base di conoscenza, recupera dinamicamente i contenuti necessari e genera risposte contestuali per gli utenti.
Architettura di Manuela 2.0: 1. Documentazione Gitbook, 2. Scraping Intelligente, 3. Servizio Web, 4. Piattaforma AIsuru
Architettura di Manuela 2.0: 1. Documentazione Gitbook, 2. Scraping Intelligente, 3. Servizio Web, 4. Piattaforma AIsuru

I nostri risultati parlano da soli

I test preliminari di Manuela 2.0 hanno mostrato miglioramenti significativi rispetto alla versione precedente:

Accuratezza migliorata

  • Aumento del 36.37% nelle risposte completamente corrette;
  • Riduzione del 24.24% nelle risposte parzialmente corrette;
  • Diminuzione del 12.12% nelle risposte errate.

Impatto sull'esperienza utente

  • Risposte immediate invece di lunghe ricerche manuali;
  • Maggiore precisione nelle informazioni fornite;
  • Interazione naturale e conversazionale con la documentazione.

Questi numeri si traducono in un'accuratezza complessiva vicina all'80% di risposte pienamente corrette, un risultato straordinario considerando che i primi test hanno evidenziato delle aree per ottimizzare ulteriormente questo risultato.

Oltre i test: perfezionare l'esperienza utente

Durante i test interni preliminari di Manuela 2.0, abbiamo identificato e risolto diverse criticità che sono tipiche quando si implementa una documentazione interrogabile tramite IA.

Nel corso dei test interni, il team ha identificato tre aree principali che richiedevano attenzione. L'esperienza ci ha insegnato che queste aree sono spesso le sfide più comuni quando si trasforma una documentazione tradizionale in un sistema interrogabile tramite IA.

Esperienza utente
La prima versione di Manuela 2.0 tendeva a fornire risposte troppo verbose e generiche. È un problema comune: l'IA cerca di essere esaustiva ma rischia di sovraccaricare l'utente di informazioni. Abbiamo quindi lavorato per rendere le risposte più concise e dirette, premttendo a Manuela 2.0 di porre domande all’utente nel caso in cui la richiesta non fosse sufficientemente chiara.

Contestualizzazioe delle risposte
Un'IA documentale deve comprendere esattamente cosa cerca l'utente, senza ripetere solo ciò che dice la documentazione. Abbiamo identificato e corretto questo comportamento, implementando un maggiore focus sugli obiettivi delle domande ed eliminando le informazioni superflue. La contestualizzazione delle risposte è diventata una priorità per assicurare che gli utenti ricevessero informazioni pertinenti al loro caso specifico.

Lati tecnici
Manuela 2.0 faticava a localizzare alcune parti specifiche della documentazione, specialmente quando i contenuti non erano strutturati in modo ottimale. Inoltre, l'IA tendeva a dare spiegazioni imprecise quando le informazioni di base non erano sufficientemente chiare o quando mancavano esempi concreti. In alcuni casi, il sistema non riusciva a collegare efficacemente concetti correlati ma presenti in sezioni diverse della documentazione. Queste sfide richiedono un'attenta ottimizzazione della struttura dei contenuti e dell'architettura del sistema.

Le lezioni apprese in questa fase ci hanno permesso di preparare un sistema più robusto e efficace prima del rilascio in beta testing a un pubblico selezionato.

Ottimizzazione Manuela 2.0: 1. Identificare Problemi, 2. Migliorare la Concisione, 3. Migliorare la Contestualizzazione, 4. Ottimizzare gli Aspetti Tecnici, 5. Prepararsi per il Beta Testing
Ottimizzazione Manuela 2.0: 1. Identificare Problemi, 2. Migliorare la Concisione, 3. Migliorare la Contestualizzazione, 4. Ottimizzare gli Aspetti Tecnici, 5. Prepararsi per il Beta Testing

Il percorso verso il rilascio

Il rilascio di un sistema di IA come Manuela 2.0 richiede un approccio strutturato: dopo i test interni che ci hanno permesso di raggiungere un'accuratezza vicina all'80%, abbiamo iniziato la fase di beta testing con un gruppo selezionato di utenti interni. 

Questa fase è fondamentale per verificare come gli utenti reali interagiscono con il sistema e per assicurarci che le risposte mantengano un alto livello di affidabilità prima del rilascio pubblico sulla piattaforma AIsuru.

Solo dopo aver validato le performance con questo gruppo di utenti e aver implementato gli ultimi perfezionamenti necessari, procederemo con il rilascio pubblico del sistema. Questo approccio graduale ci permetterà di perfezionare ulteriormente il sistema basandoci su feedback reali e casi d'uso concreti.

Percorso verso il rilascio pubblico: 1. Test interni, 2. Beta Testing, 3. Rilascio esterno
Percorso verso il rilascio pubblico: 1. Test interni, 2. Beta Testing, 3. Rilascio esterno

Trasforma la tua documentazione con Manuela 2.0

Manuela 2.0 rappresenta il futuro della documentazione tecnica: un sistema che non solo fornisce informazioni, ma comprende e soddisfa le esigenze degli utenti.

Hai una documentazione complessa che vorresti rendere più accessibile ai tuoi utenti?

Inizia oggi stesso

  1. Richiedi una chiamata con Memori per esplorare la tua documentazione;
  2. Sperimenta la potenza di una documentazione intelligente; 
  3. Trasforma in maniera definitiva l'esperienza dei tuoi utenti.

Clicca qui per contattarci: link.

Read more