Eseguire il debug dei problemi di ricerca usando il portale di Azure
Quando si crea un servizio di ricerca, si devono fare alcune ipotesi sui dati da indicizzare. Si fanno scelte sull'indice e sul modo in cui inserire i dati. Tuttavia, finché non si esegue l'indicizzatore creato, non si può essere certi di aver fatto tutte le scelte corrette.
In questa unità verrà illustrato come usare lo strumento Sessione di debug all'interno di Azure AI Search, si analizzeranno il debug e quindi la correzione di una competenza specifica e si analizzerà un approccio al debug locale delle proprie competenze personalizzate.
Esplorare come usare lo strumento Sessione di debug in Azure AI Search
Lo strumento Sessione di debug è un editor visivo interattivo che consente di seguire la pipeline di arricchimento di un documento mentre viene arricchito. È possibile eseguire l'istruzione per ogni singola competenza, apportare modifiche e correzioni e quindi rieseguire l'indicizzatore in tempo reale. Una volta risolti i problemi, è possibile aggiornare e ripubblicare l'indicizzatore, in modo che possa essere rieseguito per arricchire tutti i documenti dell'indice.
Dopo aver dato un nome alla sessione di debug e aver scelto l'indice di cui si vuole eseguire il debug, il servizio di ricerca copia tutti gli elementi necessari in un account di Archiviazione di Azure. La copia include il set di competenze, l'indicizzatore, i dati di origine e una versione arricchita del documento presente nell'indice finale.
La sessione è costituita da un grafo delle competenze, un'origine dati arricchita, un riquadro dei dettagli delle competenze, un riquadro delle esecuzioni e un riquadro degli errori/avvisi.
Il riquadro dei dettagli delle competenze consente di espandere un analizzatore di espressioni per controllare il valore e testare gli input e gli output.
Eseguire il debug di un set di competenze con la sessione di debug
Per creare una sessione di debug, passare al servizio di ricerca nel portale di Azure e seguire questa procedura:
Creare una sessione di debug
Selezionare Sessioni di debug nel riquadro di panoramica di gestione della ricerca.
Selezionare + Aggiungi sessione di debug.
In Nome della sessione di debug specificare un nome che consenta di ricordare il set di competenze, l'indicizzatore e l'origine dati interessati dalla sessione di debug.
In Stringa di connessione di archiviazione individuare un account di archiviazione per utilizzo generico per la memorizzazione nella cache della sessione di debug.
Nel modello Indicizzatore selezionare l'indicizzatore su cui si basa il set di competenze di cui si vuole eseguire il debug. Le copie dell'indicizzatore e del set di competenze vengono usate per inizializzare la sessione.
In Documento di cui eseguire il debug scegliere il primo documento nell'indice o selezionare un documento specifico.
Selezionare Salva sessione per iniziare.
Esplorare e modificare una competenza
La sessione di debug consente di esplorare il modo in cui un documento viene arricchito passando attraverso ognuna delle competenze di intelligenza artificiale. È possibile selezionare una competenza, esaminare gli input e gli output e persino visualizzare la definizione JSON per la competenza.
Nel grafo delle dipendenze selezionare una competenza.
Nel riquadro dei dettagli a destra selezionare la scheda Esecuzioni, quindi in OUTPUT aprire l'analizzatore di espressioni selezionando </> accanto a organizzazioni.
Per modificare la competenza, selezionare la scheda Impostazioni delle competenze.
Apportare le modifiche al codice JSON della competenza e quindi selezionare Salva.
Per verificare che le modifiche abbiano risolto il problema, selezionare Esegui.
Se il problema è stato risolto e si vogliono pubblicare le modifiche, nella parte superiore del riquadro selezionare Commit delle modifiche.
Per completare la sessione di debug, selezionare Salva sessione.
Convalidare i mapping dei campi
Gli indicizzatori possono essere modificati se i dati di input non corrispondono allo schema dell'indice di destinazione. Usare i mapping dei campi per rimodellare e correggere questa mancata corrispondenza nei dati durante il processo di indicizzazione.
Selezionare Grafo delle competenze e controllare che sia selezionato Grafo delle dipendenze.
Selezionare il secondo passaggio nella pipeline di arricchimento, Mapping dei campi.
Apportare eventuali modifiche al mapping dei dati.
Seleziona Salva.
Selezionare l'ultimo passaggio, Mapping dei campi di output.
I mapping dei campi di output delle competenze possono essere corretti nel riquadro dei dettagli.
Seleziona Salva.
Per verificare che le modifiche abbiano risolto il problema, selezionare Esegui.
Se il problema è stato risolto e si vogliono pubblicare le modifiche, nella parte superiore del riquadro selezionare Commit delle modifiche.
