Share via


Risoluzione dei problemi per QnA Maker

L'elenco curato delle domande più frequenti relative al servizio QnA Maker consente di adottare il servizio più velocemente e con risultati migliori.

Nota

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

Gestione delle previsioni

Come è possibile migliorare le prestazioni della velocità effettiva per le stime delle query?

Risposta: I problemi di prestazioni della velocità effettiva indicano che è necessario aumentare le prestazioni sia per il servizio app che per la ricerca cognitiva. Prendere in considerazione l'aggiunta di una replica a Ricerca cognitiva per migliorare le prestazioni.

Altre informazioni sui piani tariffari.

Come ottenere l'endpoint del servizio QnAMaker

Risposta: L'endpoint del servizio QnAMaker è utile per scopi di debug quando si contatta il supporto QnAMaker 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

    QnAMaker Azure resource group in Azure portal

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

    Select QnAMaker App Service

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

    QnAMaker endpoint

Gestione della knowledge base

Ho eliminato accidentalmente una parte del mio 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. Questi sono necessari per il funzionamento di QnA Maker, se si 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é gli URL o i file non estraggono coppie di domande/risposte?

Risposta: È possibile che QnA Maker non possa estrarre automaticamente alcuni contenuti di domande e risposte (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 sono ancora stati creati servizi 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 un servizio QnA Maker, ovvero tutte le knowledge base nel servizio verranno condivise. Vedere qui per informazioni su come collaborare a una Knowledge Base.

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

Risposta: La condivisione si basa 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 servizio app con 5 knowledge base QnAMaker. È possibile assegnare diritti di lettura/scrittura a 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 singole knowledge base.

Come è possibile modificare il messaggio predefinito quando non viene trovata alcuna corrispondenza valida?

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

  • Passare alla risorsa del servizio app nel portale di Azure

qnamaker appservice

  • Selezionare l'opzione Impostazioni

qnamaker appservice settings

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

qnamaker appservice restart

Perché il collegamento di SharePoint non viene estratto?

Risposta: per altre informazioni, vedere Percorsi origine dati.

Gli aggiornamenti apportati alla knowledge base non si riflettono sulla pubblicazione. Perché no?

Risposta: ogni operazione di modifica, che si tratti di un aggiornamento della tabella, di un test o di un'impostazione, deve essere salvata prima che possa essere pubblicata. Assicurarsi di selezionare il pulsante Salva ed esegui il training dopo ogni operazione di modifica.

La Knowledge Base supporta dati avanzati o contenuti multimediali?

Risposta:

Estrazione automatica multimediale per file e URL

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

Testo della risposta in markdown

Una volta che le coppie QnA si trovano nella Knowledge Base, è possibile modificare il testo markdown di una risposta per includere collegamenti ai supporti disponibili dagli URL pubblici.

QnA Maker supporta lingue non inglesi?

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 è necessario riavviare il servizio app?

Risposta: Aggiornare il servizio app quando l'icona di cautela è accanto al valore della versione per la Knowledge Base nella tabella Chiavi endpoint della pagina User Impostazioni.

Ho eliminato il mio servizio di ricerca esistente. Come posso risolvere questo problema?

Risposta: Se si elimina un indice di Ricerca intelligenza artificiale di Azure, l'operazione è finale e l'indice non può essere recuperato.

Ho eliminato l'indice "testkb" nel mio servizio di ricerca. Come posso risolvere questo problema?

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

Viene visualizzato l'errore seguente: verificare se le impostazioni CORS del servizio app QnA Maker consentono https://www.qnamaker.ai o se sono presenti restrizioni di rete specifiche dell'organizzazione. Come posso 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 dell'endpoint?

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

È possibile usare la stessa risorsa di Ricerca intelligenza artificiale di Azure per le knowledge base usando più lingue?

Risposta: per usare più lingue e più knowledge base, l'utente deve creare una risorsa QnA Maker per ogni 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 Ricerca intelligenza artificiale di Azure usata da QnA Maker?

Risposta: il nome della risorsa di Ricerca intelligenza artificiale di Azure è il nome della risorsa QnA Maker con alcune lettere casuali aggiunte alla fine. La distinzione tra più risorse di ricerca per QnA Maker risulta quindi più difficile. Creare un servizio di ricerca separato (denominandolo nel modo desiderato) e connetterlo al servizio QnA. I passaggi sono simili ai passaggi da eseguire per aggiornare una ricerca di Azure.

Quando QnA Maker restituisce 'Runtime core is not initialized' (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. Nella portale di Azure selezionare il servizio app di QnA Maker e quindi arrestare il servizio.

  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 i passaggi seguenti per risolvere il problema:

  1. Nella sezione servizio app -> gruppo Impostazioni -> Configurazione -> Application Impostazioni -> Name "UserAppInsightsKey" parameters is configured correttamente and set to the respective application insights Overview tab ("Instrumentation Key").

  2. Nella sezione> servizio app -> Impostazioni -> "Application Insights" - Assicurarsi che le informazioni dettagliate sulle app siano abilitate e connesse alla rispettiva risorsa di Application Insights.

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

Risposta: Attenersi alla procedura seguente:

  1. Copiare il valore di "APPINSIGHTS_INSTRUMENTATIONKEY" name" nel nome "UserAppInsightsKey" eseguendo l'override se è già presente un valore.

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

  3. Salvarlo e verrà riavviato automaticamente il servizio app. 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. Tuttavia, QnA Maker viene offerto come uno dei diversi modelli in Azure AI servizio Bot. Il servizio Bot consente di sviluppare rapidamente bot intelligenti con Microsoft Bot Framework e viene eseguito in un ambiente senza server.

Come è possibile creare un nuovo bot con QnA Maker?

Risposta: seguire le istruzioni riportate in questa documentazione per creare il bot con azure ai servizio Bot.

Ricerca per categorie usare una knowledge base diversa con un servizio Bot di intelligenza artificiale di Azure esistente?

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

  • ID 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 pubblicata 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 timeout, prendere in considerazione l'aggiornamento del livello di servizio per il servizio app associato alla Knowledge Base.

Ricerca per categorie incorporare il servizio QnA Maker nel sito Web?

Risposta: Seguire questa procedura per incorporare il servizio QnA Maker come controllo web 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 vengono archiviati?

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.