La tua documentazione è ottima, ma gli utenti pongono ancora le stesse domande. ChattyBox trasforma i tuoi documenti statici in un agente di supporto intelligente, disponibile 24 ore su 24, 7 giorni su 7, che risponde immediatamente.
I chatbot AI per scopi generici cercano di essere conversatori. Quando non conoscono una risposta, la inventano.
Usiamo la generazione aumentata dal recupero sui tuoi docs pubblicati e sui contenuti del sito, poi mostriamo i link alle fonti da cui provengono le risposte.
Per i team che richiedono prove visibili in ogni risposta, confronta il workflow di un chatbot IA con fonti citate che mantiene il traffico della documentazione collegato alle pagine di supporto.
Un chatbot con documentazione guadagna fiducia rispondendo alle domande ripetitive già visualizzate dai canali di supporto e della community e citando la pagina utilizzata. Questi sono esempi di handle ChattyBox da contenuti di documenti indicizzati.
Crea il set di test a partire da attività reali sulla documentazione, associa una fonte di riferimento e i fatti attesi a ogni domanda a cui è possibile rispondere e includi domande che l'assistente deve rifiutare. Valuta ogni categoria separatamente, affinché un buon risultato sulle API non nasconda indicazioni carenti sulla migrazione o sull'autenticazione.
Esegui nuovamente la suite prima del lancio, dopo modifiche sostanziali alla documentazione o al recupero e, dopo il lancio, su un campione mensile pianificato.
| Area della domanda | Fixture di test | Condizione di superamento |
|---|---|---|
| API | Endpoint, campi obbligatori, struttura della risposta e limite di frequenza. | Usa il metodo e il percorso documentati; i valori obbligatori e la citazione corrispondono al riferimento. |
| SDK | Installa e inizializza una versione supportata dell'SDK. | Pacchetto, importazione, inizializzazione e sintassi del codice corrispondono al linguaggio e alla versione. |
| CLI | Installa, esegui l'autenticazione, avvia un comando e interpretane l'output. | I flag e l'ordine sono validi; la risposta non inventa prompt interattivi. |
| Autenticazione | Posizione delle credenziali, formato dell'header, ambiti e un flusso vietato. | Non espone mai un segreto, distingue l'uso sul client da quello sul server e cita il requisito di sicurezza. |
| Impaginazione | Prima pagina, continuazione, pagina finale e dimensione massima della pagina. | Usa il modello documentato basato su cursore o offset e indica solo i limiti documentati. |
| Errori | Codice di errore noto, causa probabile, passaggio di ripristino e codice sconosciuto. | Associa correttamente gli errori noti e usa il fallback per le cause non documentate. |
| Migrazioni | Modifica incompatibile, prerequisito, passaggi ordinati e nota sul rollback. | Preserva la sequenza e gli avvisi senza mescolare procedure vecchie e nuove. |
| Documentazione con versioni | Poni la stessa domanda sul comportamento per la versione corrente, quella precedente e una versione non specificata. | Risponde per la versione indicata, chiede chiarimenti in caso di ambiguità e cita quella versione. |
Pubblica le regole prima dei test. I revisori devono giungere allo stesso risultato in base alla risposta, ai fatti attesi e alla fonte citata, senza basarsi su quanto la risposta sembri convincente.
| Dimensione | Accetta solo quando |
|---|---|
| Qualità della risposta | Tutti i fatti richiesti sono corretti, pertinenti, non contraddittori e usano la versione richiesta dell'API, dell'SDK, della CLI o della documentazione. |
| Accuratezza delle citazioni | Ogni affermazione sostanziale ha una citazione accessibile che la supporta direttamente nella pagina della versione corretta. |
| Comportamento di fallback | Evidenze mancanti, ambigue, contrastanti o non autorizzate producono una limitazione chiara e un passaggio successivo utile anziché un'ipotesi. |
| Criterio di lancio | Nessuna affermazione critica non supportata sull'autenticazione o sulla migrazione, superamento del 100% dei casi critici, almeno il 90% di accettazione complessiva e almeno il 95% di accuratezza delle citazioni. |
Metodo: scrivi 24 domande prima di eseguire l'assistente, tre per ogni area della matrice. Per ogni domanda, registra la versione prevista, la pagina di riferimento, i fatti richiesti, le affermazioni vietate e se è previsto il fallback. Due revisori valutano in modo indipendente le risposte congelate, risolvono le divergenze confrontandole con la fonte e conservano i prompt e gli output per i test di regressione.
I dati seguenti sono un risultato esemplificativo svolto per questa fixture di 24 domande, non una media misurata di ChattyBox in produzione né una promessa di prestazioni future.
| Risultato osservato | Interpretazione |
|---|---|
| 22 su 24 accettate (91,7%) | Include 20 risposte supportate e due fallback corretti. |
| 20 risposte sostanziali su 22 citavano pagine di supporto diretto (90,9%) | Al di sotto del criterio di lancio del 95%; il ranking delle versioni deve essere corretto. |
| 2 fallback previsti su 2 erano corretti (100%) | In questa piccola fixture, nessun caso a cui era possibile rispondere ha usato erroneamente il fallback. |
| 1 risposta su 24 conteneva un dettaglio non supportato sulla paginazione (4,2%) | Il lancio resta bloccato finché l'affermazione non supportata non viene rimossa e il test di regressione non viene superato. |
Flussi di lavoro mirati che mantengono le risposte precise, tracciabili e utili per gli utenti tecnici.
Basta inserire l'URL dei tuoi documenti. Effettuiamo la scansione, lo scraping e la vettorizzazione automaticamente di ogni pagina in pochi minuti.
Il flusso di risposta è configurato per usare il contesto recuperato ed evitare affermazioni non supportate su API, funzionalità, prezzi o policy.
Le risposte possono includere link alle pagine della documentazione dove si trovano le informazioni rilevanti.
Tratta il lancio come una release della documentazione, con responsabili, criteri, osservabilità e un percorso di rollback.
Segmenta ogni metrica per argomento, versione della documentazione, lingua e pubblico quando la dimensione del campione lo consente. Le tendenze e i campioni esaminati sono più utili di un singolo punteggio aggregato.
| Metrica | Definizione e azione |
|---|---|
| Tasso di risposta | Quota di domande che ricevono una risposta sostanziale. Esamina gli argomenti con un tasso basso per individuare contenuti mancanti; non migliorare il dato indebolendo il fallback. |
| Domande irrisolte | Domande con fallback, feedback negativo, riformulazioni ripetute o escalation. Esaminane un campione settimanale per rilevare difetti nelle risposte e nel recupero. |
| Lacune nei contenuti | Gruppi irrisolti per i quali non esiste una pagina autorevole. Inseriscili nel backlog della documentazione indicando frequenza e impatto sugli utenti. |
| Tasso di supporto delle citazioni | Affermazioni sostanziali esaminate con una citazione di supporto diretto. Analizza i cali per fonte e versione. |
| Riduzione dei ticket | Sessioni idonee risolte senza un ticket di assistenza, misurate in un intervallo definito e confrontate con un valore di riferimento. Indica una correlazione, a meno che un esperimento non dimostri la causalità. |
Usa la guida all'architettura e alla valutazione RAG per diagnosticare il recupero, il flusso di lavoro delle citazioni per esaminare le evidenze, la guida alla documentazione per sviluppatori per i casi d'uso specifici di ingegneria e la checklist tecnica di lancio per i passaggi di distribuzione.
Queste risposte riassumono il modo in cui ChattyBox legge il contenuto originale, cita le pagine della documentazione, gestisce le informazioni mancanti e si installa insieme a uno stack di documenti esistente.
ChattyBox esegue la scansione dei documenti pubblicati, del sito Web, della mappa del sito, del CMS o delle pagine del Centro assistenza, estrae testo leggibile e recupera passaggi pertinenti quando un visitatore pone una domanda.
SÌ. Quando il materiale sorgente è disponibile, ChattyBox può mostrare collegamenti alle pagine della documentazione utilizzate per la risposta in modo che gli utenti possano verificare i dettagli e continuare a leggere.
L'assistente è progettato per evitare affermazioni non supportate e può eseguire il fallback quando il contenuto indicizzato non include la risposta. Tali lacune possono informare futuri aggiornamenti della documentazione.
No. Puoi mantenere la pila di documenti corrente e incorporare il widget ChattyBox dopo aver scansionato e testato le risposte citate all'origine.
Unisciti a centinaia di sviluppatori che utilizzano ChattyBox per automatizzare il supporto della documentazione e ridurre i ticket ripetitivi.
