Obiettivi di apprendimento

Al termine dell'esercitazione, imparerai a:

• Crea un progetto di richiamo documento in Discovery.
• Carica documenti PDF nel tuo progetto e applica un modello di Smart Document Understanding preparato dall'utente ai tuoi PDF.
• Collega il tuo progetto Discovery a un'istanza del servizio NeuralSeek. NeuralSeek è un motore di generazione di risposte basato su AI.
• Crea un assistente in watsonx Assistant e applica ad esso un'integrazione NeuralSeek.
• Aggiungi un'azione al tuo watsonx Assistant che si collega a NeuralSeek per le risposte.
• Utilizza il tuo assistente per rispondere a domande su Discovery.

NeuralSeek è un prodotto di terze parti fornito da un fornitore esterno a IBM ed è soggetto a un accordo separato tra l'utente e la terza parte, se si accettano le condizioni di quest'ultima. IBM non è responsabile del prodotto e non si assume alcun impegno in materia di privacy, sicurezza, prestazioni o altro per quanto riguarda il prodotto.

Ottenere la documentazione del prodotto

Per utilizzare la documentazione del prodotto Discovery come knowledge base, la documentazione del prodotto verrà scaricata come file PDF.

1. Da un browser Web, andare al sito della documentazione del prodotto.

   https://cloud.ibm.com/docs/discovery-data
   

2. Dal pannello dell'indice, fare clic sull'icona del menu di overflow nella sezione Guida del prodotto, quindi scegliere Visualizza come PDF.

3. Salvare il file PDF sul sistema facendo clic su Salva dall'intestazione della pagina.

4. Utilizzare un editor di file PDF per dividere il documento PDF in due file PDF separati di dimensioni simili.

   Suddividere il PDF crea due file più piccoli che possono essere arricchiti più velocemente in Discovery.

Crea un progetto di richiamo documenti

Ora che hai l'ultima copia della documentazione del prodotto, aggiungiti a un progetto Discovery come tua origine dati.

In Discovery, creerai un tipo di progetto Document Retrieval. I documenti che aggiungi a un progetto di questo tipo vengono automaticamente arricchiti nei seguenti modi:

• Le entità, come i nomi appropriati, vengono identificate e contrassegnate.
• Le parti del discorso sono identificate e contrassegnate.

Queste informazioni con tag vengono utilizzate in seguito quando una frase in linguaggio naturale viene inoltrata come una query di ricerca per restituire una risposta accurata.

1. Aprire una nuova pagina del browser Web.

2. Dalla pagina del servizio del piano Discovery Plus in IBM Cloud, fai clic su Launch Discovery.

3. Dalla pagina Progetti personali, fare clic su Nuovo progetto.

4. Denominare il progetto Discovery documentation e fare clic sul riquadro Richiamo documento.

   

   del tipo di progetto*

5. Fai clic su Next.

Si configurerà l'origine dati per il progetto nel passo successivo.

Carica dati nel progetto

Aggiungi i PDF della documentazione al tuo progetto Discovery.

1. Dalla pagina Seleziona origine dati, fare clic sul riquadro Carica dati, quindi fare clic su Avanti.

   {: caption="delle fonti di datiCreazione di una raccolta dai " caption-side="bottom"} caricati

2. Denominare la raccolta Discovery docs part 1, quindi fare clic su Avanti.

3. Fare clic su Trascina e rilascia file qui o carica, quindi sfogliare per aggiungere il primo file PDF creato in precedenza.

4. Fai clic su Finish.

   Il file viene elaborato man mano che viene aggiunto alla raccolta.

5. Dal riquadro di navigazione, fare clic su Gestisci raccolte, quindi fare clic su Nuova raccolta.

   

6. Ripetere i passi precedenti per aggiungere il secondo file PDF come una raccolta denominata Discovery docs part 2.

Una volta caricati, i dati vengono elaborati e indicizzati da Discovery. Mentre i dati vengono elaborati, creiamo il nostro assistente virtuale.

Crea un assistente

Per questa esercitazione, creerai un assistente con una singola azione. Per prima cosa, devi creare un'istanza del servizio watsonx Assistant.

Le istanze del servizio watsonx Assistant del piano Lite e di prova sono disponibili gratuitamente. Verrà creato un piano di prova.

1. Da una nuova scheda del browser web, torna al catalogo IBM Cloud.

   Tieni aperta la pagina Discovery in una scheda separata, in modo da poter passare tra le due applicazioni.

2. Dalla pagina della risorsa watsonx Assistant nel catalogo IBM Cloud, crea un'istanza del servizio watsonx Assistant del piano di prova nell'ubicazione di Dallas.

3. Dalla pagina del servizio del piano watsonx Assistant in IBM Cloud, fai clic su Launch watsonx Assistant.

   Viene visualizzata l'interfaccia utente del prodotto watsonx Assistant in cui puoi creare il tuo primo assistente.

4. Aggiungere Discovery expert come nome dell'assistente e fare clic su Avanti.

5. Se ti viene richiesto di condividere le informazioni su di te e sul tuo assistente, completa i campi obbligatori e fai clic su Avanti.

   Quando crei un assistente, un'applicazione di chat web viene creata automaticamente per te.

6. Fai clic su Crea per creare l'assistente e l'applicazione di chat web corrispondente.

Dopo un messaggio di congratulazioni, viene visualizzata la home page per il tuo nuovo assistente.

Prima di aggiungere qualcosa al nostro nuovo assistente, controlliamo lo stato dei nostri dati.

Preparare i propri dati per il richiamo

Per migliorare il recupero delle informazioni nei file PDF, è possibile suddividere i file PDF in molti documenti più piccoli. Per farlo, insegnerai prima a Discovery la struttura dei file PDF, in modo che comprenda come vengono formattate le sottosezioni e possa suddividere il documento per sottosezione.

1. Torna alla scheda del browser web dove viene visualizzato il progetto Discovery.

   Viene visualizzata la pagina Migliora e personalizza per l'ultimo file PDF caricato.

2. Dal riquadro Strumenti di miglioramento, espandere Definisci strutturae fare clic su Nuovi campi.

   

3. Scegliere la raccolta Discovery docs part 1.

   Viene visualizzata la scheda Identifica campi, in cui è possibile scegliere il tipo di modello Smart Document Understanding che si desidera utilizzare.

4. Fai clic su Modelli addestrati dall'utente e fai quindi clic su Submit.

   

   addestrato dall'utente*

5. Fai clic su Apply changes and reprocess.

   Dopo aver eseguito alcune elaborazioni, viene visualizzata una rappresentazione del documento nello strumento Smart Document Understanding. Lo strumento mostra una vista del documento originale insieme ad una rappresentazione del documento, in cui il testo viene sostituito da blocchi. I blocchi rappresentano i tipi di campo.

   Inizialmente, i blocchi sono etichettati come text perché tutto il contenuto del documento è considerato come testo standard per impostazione predefinita e viene indicizzato nel campo text.

   Vogliamo etichettare tutte le intestazioni di primo e secondo livello come sottotitoli invece che come testo.

6. Dalla vista miniature, fare clic sulla miniatura per la prima pagina di testo completo dal documento per aprire la prima pagina con contenuto reale.

   

7. Per annotare il documento, fare clic sull'etichetta subtitle dall'elenco Etichette campo. Fare quindi clic su ogni blocco nella rappresentazione della pagina PDF che rappresenta un'intestazione per modificarne l'etichetta da text a subtitle.

   

8. Dopo che ogni sottotitolo nella pagina corrente è etichettato, fare clic su Inoltra pagina.

   Viene visualizzata la pagina successiva del file PDF.

   

9. Ripetere questo processo fino a quando lo strumento non è in grado di etichettare correttamente le intestazioni in modo coerente quando vengono caricate nuove pagine nello strumento. A questo punto, fare clic su Applica modifiche e rielabora.

   Congratulazioni! Hai addestrato con successo un modello SDU (Smart Document Understanding) che può riconoscere i sottotitoli nei tuoi documenti. Applichiamo lo stesso modello all'altro file PDF che hai aggiunto al progetto.

10. Dalla barra degli strumenti dell'editor SDU, fare clic sull'icona del menu di overflow dall'intestazione della pagina e scegliere Esporta modello.

11. Salvare il file .sdumodel nel sistema in una posizione in cui è possibile accedervi nuovamente a breve.

12. Dal pannello di navigazione, fare clic su Gestisci raccolte, quindi aprire la raccolta Documentazione di rilevamento parte 2.

13. Aprire la scheda Identificare i campi.

14. Fai clic su Modelli addestrati dall'utente e fai quindi clic su Submit.

15. Fai clic su Apply changes and reprocess.

16. Dalla barra degli strumenti dell'editor SDU, fare clic sull'icona del menu di overflow e scegliere Importa modello, quindi fare clic su Seleziona modello.

17. Ricercare il file .sdumodel scaricato in precedenza, quindi fare clic su Apri.

18. Fare clic su Applica modifiche e rielabora per applicare lo stesso modello SDU alla prima raccolta.

Discovery rielabora i dati nel relativo indice per identificare i sottotitoli nei documenti. Mentre i dati vengono rielaborati, creiamo il nostro generatore di risposte.

Creare un'istanza del servizio NeuralSeek

Puoi utilizzare un'estensione di ricerca in watsonx Assistant per collegare il tuo assistente direttamente a Discovery e restituire i passaggi direttamente dall'origine dati. Tuttavia, aggiungeremo il servizio NeuralSeek tra watsonx Assistant e Discovery in questa esercitazione. NeuralSeek richiama i passaggi da Discovery e li converte in risposte che suonano più colloquiali.

1. Da una nuova scheda del browser web, torna al catalogo IBM Cloud.

   Tieni aperte le pagine degli altri servizi in schede separate, in modo da poter passare da un'istanza del servizio all'altra.

2. Dalla pagina delle risorse NeuralSeek nel catalogo IBM Cloud, crea un'istanza del servizio del piano Lite.

3. Nella pagina Configure, aggiungi i dettagli della tua istanza del servizio Discovery e personalizza la connessione.

   • È possibile ottenere l' URL del servizio e la chiave API dalla pagina dei dettagli dell'istanza del servizio Discovery in IBM Cloud.
   • L'ID progetto è disponibile dall'interfaccia utente IBM Cloud. Per ottenerlo, fare clic su Integra e distribuisci dal pannello di navigazione. Aprire la pagina Informazioni API, quindi copiare l'ID progetto.
   • Impostare l'intervallo di punteggio del documento su 50%.
   • Modificare la dimensione del carattere del frammento in 400.
   • Specificare la società come nome di visualizzazione della società.
   • Modificare la percentuale di confidenza minima in 50.

   Fare clic su Salva.

Dividi i documenti PDF

Ora che i sottotitoli sono indicizzati correttamente in Discovery, utilizzali come base per suddividere i file PDF in molti documenti più piccoli.

1. Torna alla scheda del browser web dove viene visualizzato il progetto Discovery.

2. Aprire la scheda Gestisci campi per la raccolta corrente.

3. Nel campo Suddividi documento a ogni ricorrenza di, scegliere sottotitolo, quindi fare clic su Applica modifiche e rielabora.

   

4. Nel pannello di esplorazione, fare clic su Gestisci raccolte, quindi aprire l'altra raccolta.

5. Andare sulla pagina Gestisci campi e scegliere sottotitolo nel campo Suddividi documento su ogni ricorrenza di.

6. Fai clic su Apply changes and reprocess.

Le raccolte iniziano ad essere rielaborate. Una volta terminata la reindicizzazione, invece di contenere un documento ciascuno, le raccolte conterranno diverse centinaia di documenti ciascuno.

Mentre l'indice è in fase di ricostruzione, prepariamo il nostro assistente.

Aggiungi un'estensione al tuo assistente

Collega il tuo assistente alla tua istanza del servizio NeuralSeek.

1. Riapri il servizio NeuralSeek da IBM Cloud. Puoi trovare l'istanza nella sezione AI e Machine Learning del tuo elenco di risorse.

2. Fai clic sulla scheda Integra e segui le istruzioni per configurare l'estensione personalizzata NeuralSeek per il tuo assistente. Torna a questa procedura quando sei pronto a creare l'azione.

   

   dell'NeuralSeek istanza*

3. Dal pannello di navigazione watsonx Assistant, fai clic su Azioni e fai quindi clic su Nuova azione.

4. Scegli Quick start from templates, quindi scorri per trovare e fare clic su NeuralSeek Starter kit.

   

5. Fai clic su Select this starter kit e fai quindi su Add templates.

6. Fai clic per aprire l'azione di ricerca NeuralSeek che hai appena aggiunto all'assistente.

7. Aggiungi le seguenti query di esempio utente al primo passo dell'azione:

   What Watson Discovery project types are available and what do they do?
   

   What external data sources are supported by Watson Discovery?
   

   Can I add a custom dictionary to Watson Discovery?
   

   How do I use the Content Mining application?
   

   When should I add query expansions to my project?
   

   Which file types support Smart Document Understanding models?
   

   Can I enable optical character recognition for all file types?
   

   Does my data have to be written in English?
   

   watsonx Assistant utilizza le domande di esempio per riconoscere i tipi di domande utente che devono essere instradati a questa azione.

8. Fare clic per aprire il passo 3 per la modifica.

   Nella sezione E poi, fare clic su Modifica estensione.

   Scegliere NeuralSeek e fare clic su Applica.

   

9. Fare clic per aprire il passo 6 per la modifica.

   Questo passo mostra un link su cui gli utenti possono fare clic per ottenere ulteriori informazioni. Si desidera che questo link vada direttamente alla documentazione del prodotto sul sito Docs IBM Cloud.

   Modificate il riferimento ipertestuale nell'elemento HTML di ancoraggio in modo che contenga il seguente URL:

   <a href="https://cloud.ibm.com/docs/discovery-data?topic=discovery-data-about" target="_blank">
   

   : caption="Modifica l' URL per il link Maggiori informazioni " caption-side="bottom"}

10. Salvare le modifiche e fare clic sulla X per chiudere il passo.

Congratulazioni! Hai creato correttamente un'azione che riconosce le domande su Discoverye ottiene le sue risposte dall'estensione NeuralSeek connessa.

Configura la chat web per il tuo assistente

Per visualizzare l'anteprima del tuo assistente, utilizzerai la chat web integrata come interfaccia utente di chat per interagire con l'assistente.

1. Dal pannello di navigazione in watsonx Assistant, fare clic su Ambienti.

   Viene visualizzato l'ambiente di sformo. Mostra che una chat web è connessa al tuo assistente. Puoi anche vedere che la chat web è connessa all'estensione NeuralSeek.

   

2. Fare clic sul riquadro Chat web per modificare la chat web.

   Non vogliamo aggiungere più domande starter, quindi spegneremo la schermata iniziale per la chat web. Fare clic sulla scheda schermata Home. Impostare lo switcher su Off, quindi fare clic su Salva e esci.

   

Sei pronto per visualizzare l'anteprima del tuo assistente!

Anteprima dell'assistente

Per visualizzare in anteprima un assistente che si connette ai dati archiviati in Discovery, devi visualizzare in anteprima l'assistente dalla pagina Ambienti. Quando visualizzi l'anteprima della chat web indipendentemente, l'assistente non è in grado di recuperare dati da Discovery; ha bisogno delle risorse dell'ambiente per potersi connettere a Discovery.

1. Dalla pagina Ambienti, fare clic su Anteprima di questo ambiente.

   Viene visualizzata una pagina Web di esempio che include un'icona di conversazione .

2. Fare clic sull'icona di conversazione per aprire la finestra di conversazione Web.

   

3. Immettere la seguente domanda di testo:

   What project types are available?
   

   Viene restituita la risposta corretta e include un collegamento alla documentazione del prodotto.

   

   della ricerca*

4. Invia una domanda che non è stata utilizzata come esempio di query quando hai creato l'azione.

   How do you define synonyms in Watson Discovery?
   

   Viene restituita una risposta dettagliata.

   

5. Facoltativamente, fai altre domande all'assistente.

   Se l'assistente non conosce la risposta, riformulare la domanda in modo che includa "in Watson Discovery" per rendere più chiaro che stai chiedendo come funziona qualcosa in Discovery in modo specifico.

Congratulazioni! Hai creato correttamente un assistente che può rispondere alle domande su Discovery richiamando informazioni dalla documentazione del prodotto tramite il servizio NeuralSeek.