Risoluzione dei problemi per QnA MakerTroubleshooting for QnA Maker

L'elenco curato delle domande più frequenti relative al servizio QnA Maker consentirà di adottare il servizio più rapidamente e con risultati migliori.The curated list of the most frequently asked questions regarding the QnA Maker service will help you adopt the service faster and with better results.

Come ottenere l'endpoint del servizio QnAMakerHow to get the QnAMaker service endpoint

L'endpoint del servizio QnAMaker è utile a scopo di debug quando si contatta il supporto di QnAMaker o UserVoice.QnAMaker service endpoint is useful for debugging purposes when you contact QnAMaker Support or UserVoice. L'endpoint è un URL nel formato seguente: https://your-resource-name.azurewebsites.net.The endpoint is a URL in this form: https://your-resource-name.azurewebsites.net.

  1. Passare al servizio QnA Maker (gruppo di risorse) nel portale di AzureGo to your QnAMaker service (resource group) in the Azure portal

    Gruppo di risorse Azure per QnA Maker nel portale di Azure

  2. Selezionare il servizio app associato alla risorsa QnA Maker.Select the App Service associated with the QnA Maker resource. In genere, i nomi sono gli stessi.Typically, the names are the same.

    Selezionare il servizio app QnA Maker

  3. L'URL dell'endpoint è disponibile nella sezione PanoramicaThe endpoint URL is available in the Overview section

    Endpoint QnAMaker

Usare il bot della guida nel portale di QnA MakerUse the Help bot in the QnA Maker portal

QnA Maker fornisce un bot della Guida all'interno del portale QnA Maker per aiutarti.QnA Maker provides a Help bot within the QnA Maker portal to help you. Il bot della guida è disponibile in ogni pagina Web.The help bot is available on every web page. Il bot USA QnA Maker per fornire risposte e fornisce il C# progetto di codice di bot Framework al bot, in modo che sia possibile iniziare subito a usare il proprio bot di risposta.The bot uses QnA Maker to provide answers and provides the C# Bot Framework code project to the bot so you can quickly get up and running with your own answer bot.

! [QnA Maker fornisce un bot * * Help * * all'interno del portale di QnA Maker.] (./media/qnamaker-faq/use-qna-maker-help-bot-to-learn-qna-maker-service.png)

Gestione della knowledge baseManage the knowledge base

Ho accidentalmente eliminato una parte di QnA Maker, cosa devo fare?I accidentally deleted a part of my QnA Maker, what should I do?

Non eliminare i servizi di Azure creati insieme alla risorsa QnA Maker come la ricerca o l'app Web.Do not delete any of the Azure services created along with the QnA Maker resource such as Search or Web App. Per il corretto funzionamento di QnA Maker, è necessario eliminarne uno QnA Maker smette di funzionare correttamente.These are necessary for QnA Maker to work, if you delete one, QnA Maker will stop working correctly.

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.All deletes are permanent, including question and answer pairs, files, URLs, custom questions and answers, knowledge bases, or Azure resources. Prima di eliminare qualsiasi parte della knowledge base, quindi, assicurarsi di esportare le knowledge base dalla pagina Impostazioni.Make sure you export your knowledge base from the Settings page before deleting any part of your knowledge base.

Perché i miei URL/file non estraggono coppie di domanda/risposta?Why is my URL(s)/file(s) not extracting question-answer pairs?

È possibile che QnA Maker non possa estrarre automaticamente alcune coppie di domanda/riposta da URL di domande frequenti validi.It's possible that QnA Maker can't auto-extract some question-and-answer (QnA) content from valid FAQ URLs. In questi casi è possibile incollare il contenuto di domande/risposte in un file TXT e verificare se lo strumento è in grado di inglobarlo.In such cases, you can paste the QnA content in a .txt file and see if the tool can ingest it. In alternativa è possibile aggiungere contenuti alla Knowledge Base in modo editoriale tramite il portale QnA Maker.Alternately, you can editorially add content to your knowledge base through the QnA Maker portal.

Quali sono le dimensioni massime consentite per la creazione di Knowledge Base?How large a knowledge base can I create?

Le dimensioni della Knowledge Base dipendono dallo SKU di Ricerca di Azure scelto durante la creazione del servizio QnA Maker.The size of the knowledge base depends on the SKU of Azure search you choose when creating the QnA Maker service. Vedere qui per altri dettagli.Read here for more details.

Perché non vedo nulla nell'elenco a discesa quando cerco di creare una nuova Knowledge Base?Why can't I see anything in the drop-down when I try to create a new knowledge base?

Non è stato ancora creato alcun servizio QnA Maker in Azure.You haven't created any QnA Maker services in Azure yet. Per altre informazioni su come eseguire questa operazione, leggere qui.Read here to learn how to do that.

Come si condivide una Knowledge Base?How do I share a knowledge base with others?

La condivisione funziona a livello di servizio QnA Maker, in altre parole vengono condivise tutte le Knowledge Base all'interno di un servizio.Sharing works at the level of a QnA Maker service, that is, all knowledge bases in the service will be shared. Vedere qui per informazioni su come collaborare a una Knowledge Base.Read here how to collaborate on a knowledge base.

È possibile condividere una knowledge base con un collaboratore che non è nello stesso tenant di AAD, per modificare una knowledge base?Can you share a knowledge base with a contributor that is not in the same AAD tenant, to modify a knowledge base?

La condivisione è basata sul controllo degli accessi in base al ruolo di Azure.Sharing is based on Azure role-based access control (RBAC). Se è possibile condividere qualsiasi risorsa in Azure con un altro utente, è anche possibile condividere QnA Maker.If you can share any resource in Azure with another user, you can also share QnA Maker.

Se si dispone di un piano di servizio app con 5 knowledge base QnAMaker.If you have an App Service Plan with 5 QnAMaker knowledge bases. È possibile assegnare diritti di lettura/scrittura per 5 utenti diversi in modo che ognuno di essi possa accedere solo a 1 knowledge base QnAMaker?Can you assign read/write rights to 5 different users so each of them can access only 1 QnAMaker knowledge base?

È possibile condividere un intero servizio QnAMaker, non i singoli knowledge base.You can share an entire QnAMaker service, not individual knowledge bases.

Come si modifica il messaggio predefinito visualizzato se non viene trovata alcuna corrispondenza?How can I change the default message when no good match is found?

Il messaggio predefinito fa parte delle impostazioni del servizio app.The default message is part of the settings in your App service.

  • Passare alla risorsa del servizio app nel portale di AzureGo to your App service resource in the Azure portal

Servizio app QnA Maker

  • Fare clic sull'opzione ImpostazioniClick on the Settings option

Impostazioni del servizio app QnA Maker

  • Modificare il valore dell'impostazione DefaultAnswerChange the value of the DefaultAnswer setting
  • Riavviare il servizio appRestart your App service

Riavvio del servizio app QnA Maker

Per altre informazioni, vedere Posizioni della data factory.See Data source locations for more information.

Gli aggiornamenti apportati alla Knowledge Base non sono riflesse nella pubblicazione.The updates that I made to my knowledge base are not reflected on publish. Perché?Why not?

Ogni operazione di modifica, nell'aggiornamento di tabelle, nel test o nell'impostazione, deve essere salvata prima di poter essere pubblicata.Every edit operation, whether in a table update, test, or setting, needs to be saved before it can be published. Assicurarsi di fare clic sul pulsante Salva e Train dopo ogni operazione di modifica.Be sure to click the Save and train button after every edit operation.

La Knowledge Base supporta i dati avanzati o i contenuti multimediali?Does the knowledge base support rich data or multimedia?

La Knowledge Base supporta Markdown.The knowledge base supports Markdown. L'estrazione automatica dagli URL ha tuttavia una capacità limitata di conversione da HTML a Markdown.However, the auto-extraction from URLs has limited HTML-to-Markdown conversion capability. Per usare le funzionalità complete di Markdown, è possibile modificare i contenuti direttamente nella tabella o caricare una Knowledge Base con contenuti avanzati.If you want to use full-fledged Markdown, you can modify your content directly in the table, or upload a knowledge base with the rich content.

Al momento non è supportato alcun tipo di contenuto multimediale, ad esempio immagini e video.Multimedia, such as images and videos, is not supported at this time.

QnA Maker supporta lingue diverse dall'inglese?Does QnA Maker support non-English languages?

Vedere altri dettagli sulle lingue supportate.See more details about supported languages.

Se sono presenti contenuti in più lingue, assicurarsi di creare un servizio separato per ciascuna lingua.If you have content from multiple languages, be sure to create a separate service for each language.

Gestire il servizioManage service

Quando è consigliabile riavviare un servizio app?When should I restart my app service?

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.Refresh your app service when the caution icon is next to the version value for the knowledge base in the Endpoint keys table on the User Settings page.

Il servizio di ricerca esistente è stato eliminato.I deleted my existing Search service. Come si risolve questo problema?How can I fix this?

Se si elimina un indice ricerca cognitiva di Azure, l'operazione è finale e non è possibile recuperare l'indice.If you delete an Azure Cognitive Search index, the operation is final and the index cannot be recovered.

Ho eliminato l'indice testkb nel servizio di ricerca.I deleted my testkb index in my Search service. Come si risolve questo problema?How can I fix this?

Non è possibile recuperare i dati precedenti.Your old data can't be recovered. Creare una nuova risorsa di QnA Maker e creare di nuovo la Knowledge base.Create a new QnA Maker resource and create your knowledge base again.

Quando è necessario aggiornare le chiavi endpoint?When should I refresh my endpoint keys?

Aggiornare le chiavi endpoint se si sospetta che siano state compromesse.Refresh your endpoint keys if you suspect that they have been compromised.

È possibile usare la stessa risorsa ricerca cognitiva di Azure per le Knowledge base usando più lingue?Can I use the same Azure Cognitive Search resource for knowledge bases using multiple languages?

Per usare più lingue e knowledge base, l'utente deve creare una risorsa di QnA Maker per ciascuna lingua.To use multiple language and multiple knowledge bases, the user has to create an QnA Maker resource for each language. Verrà creato un servizio di ricerca di Azure separato per ogni lingua.This will create a separate Azure search service per language. La combinazione di knowledge base in lingue diverse in un singolo servizio di Ricerca di Azure comporterà una ridotta pertinenza dei risultati.Mixing different language knowledge bases in a single Azure search service will result in degraded relevance of results.

Come è possibile modificare il nome della risorsa ricerca cognitiva di Azure usata da QnA Maker?How can I change the name of the Azure Cognitive Search resource used by QnA Maker?

Il nome della risorsa ricerca cognitiva di Azure è il nome della risorsa QnA Maker con alcune lettere casuali aggiunte alla fine.The name of the Azure Cognitive Search resource is the QnA Maker resource name with some random letters appended at the end. La distinzione tra più risorse di ricerca per QnA Maker risulta quindi più difficile.This makes it hard to distinguish between multiple Search resources for QnA Maker. Creare un servizio di ricerca separato (denominarlo come si desidera) e connetterlo al servizio QnA.Create a separate search service (naming it the way you would like to) and connect it to your QnA Service. I passaggi sono simili ai passaggi necessari per aggiornare una ricerca di Azure.The steps are similar to the steps you need to do to upgrade an Azure search.

Quando QnA Maker restituisce Runtime core is not initialized, come risolverlo?When QnA Maker returns Runtime core is not initialized, how do I fix it?

Lo spazio su disco per il servizio app potrebbe essere pieno.The disk space for your app service might be full. Passaggi per la correzione dello spazio su disco:Steps to fix your disk space:

  1. Nella portale di Azureselezionare il servizio App del QnA Maker, quindi arrestare il servizio.In the Azure portal, select your QnA Maker's App service, then stop the service.

  2. Sempre nel servizio app, selezionare strumenti di sviluppo, strumenti avanzati, quindi fareclic su.While still on the App service, select Development Tools, then Advanced Tools, then Go. Verrà visualizzata una nuova finestra del browser.This opens a new browser window.

  3. Selezionare console di debug, quindi cmd per aprire uno strumento da riga di comando.Select Debug console, then CMD to open a command line tool.

  4. Passare alla directory site/wwwroot/data/QnAMaker/ .Navigate to the site/wwwroot/Data/QnAMaker/ directory.

  5. Rimuovere tutte le cartelle il cui nome inizia con rd.Remove all the folders whose name begins with rd.

    Non eliminare gli elementi seguenti:Do not delete the following:

    • File KbIdToRankerMappings. txtKbIdToRankerMappings.txt file
    • File EndpointSettings. JSONEndpointSettings.json file
    • Cartella EndpointKeysEndpointKeys folder
  6. Avviare il servizio app.Start the App service.

  7. Accedere alla Knowledge base per verificarne il funzionamento.Access your knowledge base to verify it works now.

Integrazione con altri servizi, inclusi BotIntegrate with other services including Bots

È necessario usare Bot Framework per usare QnA Maker?Do I need to use Bot Framework in order to use QnA Maker?

No, non è necessario usare bot Framework con QnA Maker.No, you do not need to use the Bot Framework with QnA Maker. Tuttavia, QnA Maker è disponibile come uno dei diversi modelli nel servizio Azure bot.However, QnA Maker is offered as one of several templates in Azure Bot Service. Il servizio Bot consente di sviluppare rapidamente bot intelligenti con Microsoft Bot Framework e viene eseguito in un ambiente senza server.Bot Service enables rapid intelligent bot development through Microsoft Bot Framework, and it runs in a server-less environment.

Come è possibile creare un nuovo bot con QnA Maker?How can I create a new bot with QnA Maker?

Seguire le istruzioni riportate in questa documentazione per creare il bot con il servizio Azure Bot.Follow the instructions in this documentation to create your Bot with Azure Bot Service.

Ricerca per categorie usare una Knowledge base diversa con un servizio Azure bot esistente?How do I use a different knowledge base with an existing Azure bot service?

È necessario disporre delle informazioni seguenti sulla Knowledge Base:You need to have the following information about your knowledge base:

  • ID della Knowledge base.Knowledge base ID.
  • Nome del sottodominio personalizzato dell'endpoint pubblicato della Knowledge base, noto come host, disponibile nella pagina Impostazioni dopo la pubblicazione.Knowledge base's published endpoint custom subdomain name, known as host, found on Settings page after you publish.
  • Chiave endpoint pubblicata della Knowledge base, disponibile nella pagina Impostazioni dopo la pubblicazione.Knowledge base's published endpoint key - found on Settings page after you publish.

Con queste informazioni, andare al servizio app del bot nella portale di Azure.With this information, go to your bot's app service in the Azure portal. In Impostazioni-> configurazione > Impostazioni applicazionemodificare tali valori.Under Settings -> Configuration -> Application settings, change those values.

La chiave dell'endpoint della Knowledge base è denominata QnAAuthkey nel servizio ABS.The knowledge base's endpoint key is labeled QnAAuthkey in the ABS service.

Due o più applicazioni client possono condividere una Knowledge base?Can two or more client applications share a knowledge base?

Sì, la Knowledge base può essere sottoposta a query da un numero qualsiasi di client.Yes, the knowledge base can be queried from any number of clients. Se la risposta dalla Knowledge base sembra essere lenta o timeout, provare ad aggiornare il livello di servizio per il servizio app associato alla Knowledge base.If the response from the knowledge base appears to be slow or time out, consider upgrading the service tier for the app service associated with the knowledge base.

Come si incorpora il servizio QnA Maker nel proprio sito Web?How do I embed the QnA Maker service in my website?

Seguire questa procedura per incorporare il servizio QnA Maker come controllo di chat nel sito Web:Follow these steps to embed the QnA Maker service as a web-chat control in your website:

  1. Creare il bot di domande frequenti seguendo queste istruzioni.Create your FAQ bot by following the instructions here.
  2. Abilitare la chat Web seguendo questi passaggiEnable the web chat by following the steps here

Archiviazione dei datiData storage

Quali dati vengono archiviati e dove vengono archiviati?What data is stored and where is it stored?

Quando si crea un servizio QnA Maker, si seleziona un'area di Azure.When you create your QnA Maker service, you selected an Azure region. Le knowledge base e i file di log vengono archiviati in questa area.Your knowledge bases and log files are stored in this region.