Documentazione e knowledge base

Mantieni le risposte IA sincronizzate con la tua documentazione

Una release della documentazione che passa per una nuova acquisizione fino a una risposta verificata
Una release della documentazione che passa per una nuova acquisizione fino a una risposta verificata

Pubblicare una modifica alla documentazione e aggiornare un assistente sono due eventi distinti. Un job di acquisizione ricorrente li collega, rivisitando la documentazione selezionata ed elaborando il testo attuale nel dataset.

La pianificazione deve seguire il processo di rilascio della documentazione, non un obiettivo SEO arbitrario.

Allinea i job alle versioni della documentazione

Se la documentazione attuale e quella legacy si trovano in percorsi diversi, acquisiscile in dataset separati oppure escludi le versioni che non devono rispondere alle domande pubbliche.

Ad esempio, includi il percorso della documentazione attuale ed escludi i percorsi di archivio o versionati che non sono più validi. Rivedi gli hostname consentiti quando la documentazione usa sottodomini.

Scegli la pianificazione

Modello di pubblicazioneApproccio iniziale
Piccole modifiche continueAcquisizione giornaliera
Diverse release al giornoAcquisizione ogni poche ore, se l’aggiornamento lo richiede
Ciclo di release settimanaleAcquisizione dopo la release o ogni sette giorni
Documentazione di compliance controllataAcquisizione manuale dopo l’approvazione

Seekdown offre intervalli da ogni ora fino a ogni sette giorni, più l’opzione Never.

Selettore di pianificazione di Seekdown per l’acquisizione della documentazione con dati di esempio
Selettore di pianificazione di Seekdown per l’acquisizione della documentazione con dati di esempio

Aggiungi controlli di aggiornamento alla release

Per ogni modifica sostanziale alla documentazione:

  1. indica la pagina modificata;
  2. registra una domanda interessata dalla modifica;
  3. verifica che l’acquisizione successiva termini;
  4. trova la nuova formulazione nel dataset;
  5. fai la domanda registrata; e
  6. apri la citazione.

È più affidabile che controllare solo la data dell’acquisizione. Un job terminato può comunque aver saltato un URL a causa delle regole sui percorsi, della profondità o di un errore della pagina.

Gestisci rimozioni e contraddizioni

Quando un workaround o una vecchia opzione viene rimossa, cerca la vecchia formulazione nel resto del dataset. Note di rilascio, pagine tradotte e copie in cache possono continuare a sostenere la risposta obsoleta.

Non chiedere all’assistente di scegliere in silenzio tra documenti in conflitto. Designa una sola fonte attuale, rimuovi la pagina obsoleta o indica esplicitamente il confine tra le versioni.

La scansione ricorrente mantiene aggiornata la copia delle fonti. Le domande di regressione mostrano se anche la risposta si è aggiornata.