Fonti dati WebChatAgent: spiegazione di ogni controllo

Seleziona Source Control Center nella barra laterale sinistra e apri Data Sources nel menu di navigazione dell'assistente. Il titolo della pagina, la selezione nella barra laterale e l'elenco delle fonti devono appartenere allo stesso assistente.

Leggi il banner informativo prima di aggiungere contenuti: le fonti vengono suddivise in passaggi ricercabili e incidono sul limite di caratteri del piano. Le modifiche apportate qui influiscono sulle risposte future, quindi evita di lavorare da schede del browser non chiaramente identificate.

Apri Add Data Source. Website esegue la scansione delle pagine pubbliche approvate; Documents consente di caricare file PDF, TXT, Markdown, Word o Excel; Text Input archivia direttamente una breve informazione gestita manualmente. Confluence e Notion collegano contenuti approvati dai rispettivi spazi di lavoro.

Ad esempio, usa Website per un centro assistenza pubblico, Documents per un regolamento firmato in PDF, Text Input per un avviso di servizio temporaneo e un connettore quando il responsabile del contenuto lo aggiorna già all'interno di quello spazio di lavoro. Chiudi la finestra di dialogo senza creare duplicati.

La scheda di utilizzo confronta i caratteri indicizzati con il limite del piano. I contatori delle fonti distinguono siti web, documenti, testo e connettori, mentre la tabella mostra lo stato di indicizzazione di ogni elemento.

Considera Pending o Processing come uno stato di attesa. Failed o Error richiede un'analisi dei dettagli e una correzione. Re-index required indica che i vettori attuali non sono disponibili o non sono aggiornati, spesso a seguito di un cambio di provider. Completed o Indexed indica che il processo è terminato, ma è comunque necessario eseguire il test della risposta al passaggio dieci.

La funzione Search accetta il nome di una fonte o l'URL di un sito web. Usa il filtro per tipo per isolare siti web, file, testo o connettori, e il filtro per categoria per circoscrivere l'argomento o la responsabilità del contenuto. Reimposta entrambi i filtri prima di dedurre che una fonte sia mancante.

Source Control Center usa la categoria Support per il file PDF Northstar. In produzione è consigliabile usare etichette stabili come Support, Products o Legal. Non inserire stati temporanei come new o needs review all'interno di una categoria; lo stato del processo e la classificazione dei contenuti devono rimanere separati.

Apri l'azione di modifica sulla riga del sito web. Verifica l'URL di partenza canonico, la profondità di scansione (crawl depth) e l'intervallo di reindicizzazione automatica. Espandi Advanced solo quando sono necessari selettori o regole di esclusione.

Una profondità pari a zero indicizza esclusivamente la pagina inserita; una profondità maggiore segue i link interni. Escludi i percorsi di checkout, account e versioni duplicate in altre lingue prima di aumentare la profondità. Salva solo le modifiche intenzionali, quindi attendi il nuovo processo di indicizzazione anziché eseguire subito i test.

Apri Indexed URLs per il sito web. Cerca nell'elenco delle pagine, confronta i conteggi dei caratteri e usa View Content per individuare elementi di navigazione non necessari, testi sui cookie o pagine duplicate.

Delete rimuove solo la pagina indicizzata selezionata, ma la scansione successiva potrebbe rilevarla di nuovo. Exclude aggiunge un'esclusione permanente per le scansioni future. Conferma l'operazione nella finestra di dialogo, quindi verifica che il conteggio totale dei caratteri sia diminuito come previsto.

Apri Edit su Northstar Knowledge Base. L'editor mostra il testo estratto utilizzato per l'indicizzazione, oltre a Document Name, Category e Search Priority. Correggi piccoli errori di estrazione solo dopo aver confrontato il testo con l'originale approvato.

Search Priority influisce sul posizionamento nei risultati rispetto ad altre fonti; non rappresenta un punteggio di qualità del contenuto. Mantieni il valore su zero a meno che domande di test ricorrenti non giustifichino un aumento di priorità. In caso di modifiche a un regolamento o di revisioni estese, carica il nuovo file approvato, verificalo e rimuovi la vecchia fonte obsoleta, evitando di mantenere versioni disallineate all'interno del testo estratto.

Apri Content Search e inserisci il valore univoco NORDSTERN-42. Il risultato dovrebbe fare riferimento a Northstar Knowledge Base e mostrare il passaggio indicizzato corrispondente.

Questo è il metodo più rapido per distinguere un problema della fonte da un problema di generazione della risposta. Se non compare alcun risultato, l'informazione non è presente nell'indice attuale. Se compare un risultato pertinente ma la risposta del chatbot è inadeguata, analizza la formulazione della domanda, eventuali fonti sovrapposte, Search Priority e il comportamento del modello.

Usa l'azione sulla singola riga per reindicizzare una specifica fonte, oppure Re-index All solo dopo un cambio di provider o un aggiornamento pianificato su larga scala. I processi di massa richiedono tempo e possono complicare la diagnosi dei problemi: annota sempre le modifiche apportate prima di procedere.

Prima di usare Delete, identifica ogni informazione univoca presente esclusivamente in quella fonte. La finestra di conferma avvisa che la rimozione influirà sulle risposte future. Annulla l'operazione se sei in fase di revisione, oppure procedi con l'eliminazione solo dopo aver completato l'indicizzazione della fonte sostitutiva e verificato con successo le domande di regressione prestabilite.

Apri Conversations e seleziona la sessione di test Source Control Center. Input esatto: “What is the unique verification code in the uploaded tutorial PDF?” Risultato atteso: la risposta include NORDSTERN-42 e non inventa un codice differente.

Risultato ottenuto: l'assistente reale ha risposto “The unique verification code is NORDSTERN-42.” Questo esempio è verificato end-to-end. Mantieni una domanda a risposta nota per ogni fonte critica e ripetila dopo la sostituzione di un file, la reindicizzazione, la modifica del modello o l'eliminazione di una fonte.