Risoluzione dei problemi di QnA Maker

L'elenco delle domande più frequenti relative al servizio QnA Maker aiuta ad accelerare l'adozione del servizio e ottenere risultati migliori.

Nota

Il servizio QnA Maker sarà ritirato il 31 marzo 2025. Una versione più recente della funzionalità di domande e risposte è ora disponibile come parte di Lingua di Azure AI. Per le funzionalità di risposta alla domanda all'interno del servizio di linguaggio vedere Risposta alla domanda. A partire dal 1° ottobre 2022 non è più possibile creare nuove risorse di QnA Maker. Per informazioni sulla migrazione delle knowledge base di QnA Maker esistenti alla funzionalità di risposta alla domanda vedere la guida alla migrazione.

Gestione delle previsioni

Come è possibile migliorare le prestazioni di velocità effettiva per le previsioni delle query?

Risposta: i problemi di prestazioni della velocità effettiva indicano che è necessario aumentare le prestazioni sia del servizio App che di Ricerca cognitiva. Prendi in considerazione l'aggiunta di una replica a Ricerca cognitiva di Azure per migliorare le prestazioni.

Altre informazioni sui piani tariffari.

Come ottenere l'endpoint del servizio QnA Maker

Risposta: l'endpoint del servizio QnA Maker è utile per eseguire il debug quando si contatta il supporto di QnA Maker o UserVoice. L'endpoint è un URL in questo formato: https://your-resource-name.azurewebsites.net.

  1. Passare al servizio QnA Maker (gruppo di risorse) nel portale di Azure

    Gruppo di risorse Azure per QnA Maker nel portale di Azure

  2. Selezionare il servizio app associato alla risorsa QnA Maker. In genere, i nomi sono gli stessi.

    Selezionare il servizio app QnA Maker

  3. L'URL dell'endpoint è disponibile nella sezione Panoramica

    Endpoint QnAMaker

Gestione della knowledge base

Ho accidentalmente eliminato una parte di QnA Maker, cosa devo fare?

Risposta: Non eliminare nessuno dei servizi di Azure creati insieme alla risorsa QnA Maker, ad esempio Ricerca o App Web. Sono necessari per il funzionamento di QnA Maker e, se se ne elimina uno, QnA Maker smetterà di funzionare correttamente.

Tutte le eliminazioni sono permanenti, incluse le coppie di domande e risposte, i file, gli URL, le domande e risposte personalizzate, le knowledge base e le risorse di Azure. Prima di eliminare qualsiasi parte della knowledge base, quindi, assicurarsi di esportare le knowledge base dalla pagina Impostazioni.

Perché i miei URL/file non estraggono coppie di domanda/risposta?

Risposta: è possibile che QnA Maker non possa estrarre automaticamente alcune coppie di domanda/riposta (QnA) da URL di domande frequenti validi. In questi casi è possibile incollare il contenuto di domande/risposte in un file TXT e verificare se lo strumento è in grado di inglobarlo. In alternativa è possibile aggiungere contenuti alla Knowledge Base in modo editoriale tramite il portale QnA Maker.

Quali sono le dimensioni massime consentite per la creazione di Knowledge Base?

Risposta: le dimensioni della Knowledge Base dipendono dallo SKU di Ricerca di Azure scelto durante la creazione del servizio QnA Maker. Vedere qui per altri dettagli.

Perché non vedo nulla nell'elenco a discesa quando cerco di creare una nuova Knowledge Base?

Risposta: non è stato ancora creato alcun servizio QnA Maker in Azure. Per altre informazioni su come eseguire questa operazione, leggere qui.

Come si condivide una Knowledge Base?

Risposta: la condivisione funziona a livello di servizio QnA Maker, in altre parole vengono condivise tutte le knowledge base all'interno di un servizio. Vedere qui per informazioni su come collaborare a una Knowledge Base.

È possibile condividere una knowledge base con un collaboratore che non è nello stesso tenant di AAD per modificare una knowledge base?

Risposta: la condivisione è basata sul controllo degli accessi in base al ruolo di Azure. Se è possibile condividere qualsiasi risorsa in Azure con un altro utente, è anche possibile condividere QnA Maker.

Se si dispone di un piano di servizio app con 5 knowledge base QnAMaker. È possibile assegnare diritti di lettura/scrittura per 5 utenti diversi in modo che ognuno di essi possa accedere solo a 1 knowledge base QnAMaker?

Risposta: è possibile condividere un intero servizio QnAMaker, non le singole knowledge base.

Come si modifica il messaggio predefinito visualizzato se non viene trovata alcuna corrispondenza?

Risposta: il messaggio predefinito fa parte delle impostazioni del servizio app.

  • Passare alla risorsa del servizio app nel portale di Azure

Servizio app QnA Maker

  • Selezionare l'opzione Impostazioni

Impostazioni del servizio app QnA Maker

  • Modificare il valore dell'impostazione DefaultAnswer
  • Riavviare il servizio app

Riavvio del servizio app QnA Maker

Perché il collegamento SharePoint non viene estratto?

Risposta: per altre informazioni, fare riferimento a Posizioni della origine dati.

Gli aggiornamenti apportati alla knowledge base non sono riflessi nella pubblicazione. Perché?

Risposta: ogni operazione di modifica, che sia l'aggiornamento di tabelle, nel test o impostazioni, deve essere salvata prima di poter essere pubblicata. Selezionare il pulsante Salva ed esegui training dopo ogni operazione di modifica.

La Knowledge Base supporta i dati avanzati o i contenuti multimediali?

Risposta:

Estrazione automatica multimediale per file e URL

  • URL: funzionalità di conversione da HTML a Markdown limitata.
  • File - non supportato

Testo della risposta in markdown

Una volta che le coppie di domanda e risposta si trovano nella knowledge base, è possibile modificare il testo markdown di una risposta per includere collegamenti ai file multimediali disponibili dagli URL pubblici.

QnA Maker supporta lingue diverse dall'inglese?

Risposta: vedere altri dettagli sulle lingue supportate.

Se sono presenti contenuti in più lingue, assicurarsi di creare un servizio separato per ciascuna lingua.

Gestire il servizio

Quando è consigliabile riavviare un servizio app?

Risposta: Aggiornare il servizio app quando viene visualizzata l'icona di avviso accanto al valore di versione della knowledge base nella tabella Chiavi endpoint della pagina Impostazioni utente.

Ho eliminato il servizio di ricerca esistente. Come si risolve questo problema?

Risposta: Se si elimina un indice di Azure AI Search, l'operazione è definitiva e l'indice non può essere recuperato.

È stato eliminato l'indice "testkb" nel servizio di ricerca. Come si risolve questo problema?

Risposta: nel caso in cui l'indice testkb sia stato eliminato nel servizio di ricerca, è possibile ripristinare i dati dall'ultimo KB pubblicato. Usare lo strumento di ripristino RestoreTestKBIndex disponibile in GitHub.

Si verifica il seguente problema: "Verificare se le impostazioni CORS del servizio app QnA Maker consentono https://www.qnamaker.ai o se sono presenti restrizioni di rete specifiche per l'organizzazione". Come è possibile risolvere questo problema?

Risposta: nella sezione API del riquadro Servizio app, aggiornare l'impostazione CORS su * o "https://www.qnamaker.ai". Se il problema persiste, verificare la presenza di eventuali restrizioni specifiche per l'organizzazione.

Quando è necessario aggiornare le chiavi endpoint?

Risposta: aggiornare le chiavi endpoint se si sospetta che siano state compromesse.

È possibile usare la stessa risorsa di Azure AI Search per le knowledge base con più lingue?

Risposta: per usare più lingue e knowledge base, l'utente deve creare una risorsa di QnA Maker per ciascuna lingua. In questo modo, verrà creato un servizio di ricerca di Azure separato per ogni lingua. La combinazione di knowledge base in lingue diverse in un singolo servizio di Ricerca di Azure comporterà una ridotta pertinenza dei risultati.

Come è possibile modificare il nome della risorsa di Azure AI Search usato da QnA Maker?

Risposta: Il nome della risorsa di Azure AI Search è il nome della risorsa QnA Maker a cui vengono aggiunte alcune lettere casuali alla fine del nome. La distinzione tra più risorse di ricerca per QnA Maker risulta quindi più difficile. Creare un servizio separato di Ricerca (assegnandogli un nome nel modo desiderato) e collegarlo al servizio QnA. I passaggi sono simili ai passaggi per eseguire l'aggiornamento di Ricerca di Azure.

Quando QnA Maker restituisce “Il core di runtime non viene inizializzato”, come è possibile correggerlo?

Risposta: lo spazio su disco per il servizio app potrebbe essere pieno. Procedura per correggere lo spazio su disco:

  1. Nel portale di Azure, selezionare il servizio app di QnA Maker, quindi interromperlo.

  2. Sempre nel servizio app selezionare Strumenti di sviluppo, quindi Strumenti avanzati, quindi Vai. Si aprirà una nuova finestra del browser.

  3. Selezionare Console di debug, quindi CMD per aprire uno strumento da riga di comando.

  4. Passare alla directory site/wwwroot/Data/QnAMaker/.

  5. Rimuovere tutte le cartelle il cui nome inizia con rd.

    Non eliminare quanto segue:

    • File KbIdToRankerMappings.txt
    • File EndpointSettings.json
    • Cartella EndpointKeys
  6. Avviare il servizio app.

  7. Accedere alla knowledge base per verificarne il funzionamento.

Perché Application Insights non funziona?

Risposta: verificare e aggiornare seguendo i passaggi seguenti per risolvere il problema:

  1. Nella sezione Servizio app - > Gruppo impostazioni -> Sezione configurazione -> Impostazioni applicazione -> Nome "UserAppInsightsKey" verificare che i parametri siano configurati correttamente e impostati sulla rispettiva Guid scheda Panoramica di Application Insights ("Chiave di strumentazione").

  2. In Servizio app -> gruppo Impostazioni -> Sezione "Application Insights" -> Assicurarsi che Application Insights sia abilitato e connesso alla rispettiva risorsa di Application Insights.

Application Insights è abilitato, ma perché non funziona correttamente?

Risposta: seguire la procedura seguente:

  1. Copiare il valore del nome "APPINSIGHTS_INSTRUMENTATIONKEY" in "UserAppInsightsKey" eseguendo sovrascrivendo il valore se è già presente.

  2. Se la chiave 'UserAppInsightsKey' non esiste nelle impostazioni dell'app, aggiungere una nuova chiave con tale nome e copiare il valore.

  3. Salvare; il servizio app verrà riavviato automaticamente. Questo dovrebbe risolvere il problema.

Integrazione con altri servizi, inclusi Bot

È necessario usare Bot Framework per usare QnA Maker?

Risposta: no, non è necessario usare Bot Framework con QnA Maker. QnA Maker viene tuttavia offerto come uno dei diversi modelli del Servizio di Azure AI Bot. Il servizio Bot consente di sviluppare rapidamente bot intelligenti con Microsoft Bot Framework e viene eseguito in un ambiente senza server.

Come si crea un bot con QnA Maker?

Risposta: Seguire le istruzioni riportate in questa documentazione per creare un bot con il Servizio di Azure AI Bot.

Come si usa una knowledge base diversa con un Servizio di Azure AI Bot esistente?

Risposta: è necessario avere le seguenti informazioni sulla knowledge base:

  • ID della knowledge base.
  • Nome del sottodominio personalizzato dell'endpoint pubblicato della knowledge base, noto come host, disponibile nella pagina Impostazioni dopo la pubblicazione.
  • Chiave dell'endpoint pubblicato della knowledge base: disponibile nella pagina Impostazioni dopo la pubblicazione.

Con queste informazioni, passare al servizio app del bot nel portale di Azure. In Impostazioni -> Configurazione -> Impostazioni applicazione, modificare tali valori.

La chiave dell'endpoint della Knowledge Base viene etichettata QnAAuthkey nel servizio ABS.

Due o più applicazioni client possono condividere una knowledge base?

Risposta: sì, è possibile eseguire query sulla knowledge base da un numero qualsiasi di client. Se la risposta della Knowledge Base sembra essere lenta o scaduta, prendere in considerazione l'aggiornamento del livello di servizio per il servizio app associato alla knowledge base.

Come si incorpora il servizio QnA Maker nel proprio sito Web?

Risposta: seguire questa procedura per incorporare il servizio QnA Maker come controllo di chat nel sito Web:

  1. Creare il bot di domande frequenti seguendo queste istruzioni.
  2. Abilitare la chat Web seguendo questi passaggi

Archiviazione di dati

Quali dati vengono archiviati e dove?

Risposta:

Quando si crea un servizio QnA Maker, si seleziona un'area di Azure. Le knowledge base e i file di log vengono archiviati in questa area.