Risorse di Azure per QnA Maker
QnA Maker usa diverse origini di Azure, ognuna con uno scopo diverso. Comprendere come vengono usate singolarmente consente di pianificare e selezionare il piano tariffario corretto o sapere quando modificare il piano tariffario. Comprendere come vengono usate in combinazione consente di individuare e risolvere i problemi quando si verificano.
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.
Pianificazione delle risorse
Quando si sviluppa per la prima volta una knowledge base di QnA Maker, nella fase prototipo è comune avere una singola risorsa QnA Maker sia per i test che per la produzione.
Quando si passa alla fase di sviluppo del progetto, è consigliabile prendere in considerazione quanto segue:
- Quante lingue conterrà il sistema di knowledge base?
- In quante regioni deve essere disponibile la knowledge base?
- Quanti documenti conterrà il sistema in ogni dominio?
Pianificare di avere una singola risorsa QnA Maker che contiene tutte le knowledge base con la stessa lingua, la stessa regione e la stessa combinazione di dominio e soggetto.
Considerazioni sul piano tariffario
Ci sono generalmente tre parametri da considerare:
La velocità effettiva che il servizio deve fornire:
- scegliere il piano app appropriato per il servizio app in base alle proprie esigenze. È possibile aumentare o ridurre le prestazioni dell'app.
- Ciò dovrebbe influire anche sulla scelta dello SKU di Ricerca cognitiva di Azure. Per altri dettagli vedere qui. Potrebbe anche essere necessario modificare la capacità di Ricerca cognitiva di Azure con le repliche.
Dimensioni e numero di Knowledge Base: scegliere lo SKU di Ricerca di Azure appropriato per lo scenario. In genere, si decide il numero di knowledge base necessarie in base al numero di domini soggetti diversi. Un dominio soggetto (per una singola lingua) deve trovarsi in una knowledge base.
La risorsa del servizio Ricerca di Azure deve essere stata creata dopo gennaio 2019 e non può essere nel livello gratuito (condiviso). Non è disponibile alcun supporto per configurare le chiavi gestite dal cliente nel portale di Azure.
Importante
È possibile pubblicare N-1 Knowledge Base in un particolare livello, dove N è il numero massimo di indici consentiti nel livello. Verificare anche le dimensioni massime e il numero di documenti consentiti per ogni livello.
Ad esempio, se il livello include 15 indici consentiti, è possibile pubblicare 14 articoli della knowledge base (un indice per ogni articolo della knowledge base pubblicato). Il quindicesimo indice viene usato per tutti gli articoli della knowledge base per la creazione e il testing.
- Numero di documenti come origini: lo SKU gratuito del servizio di gestione di QnA Maker limita a 3 (1 MB ciascuno) il numero di documenti gestibili tramite il portale e le API. Lo SKU Standard non pone limiti al numero di documenti gestibili. Per informazioni dettagliate, vedere qui.
La tabella seguente indica alcune linee guida generali.
| Gestione di QnA Maker | Servizio app | Azure AI Search | Limiti | |
|---|---|---|---|---|
| Sperimentazione | SKU gratuito | Livello gratuito | Livello gratuito | Pubblicazione di massimo 2 Knowledge Base, dimensioni 50 MB |
| Ambiente di sviluppo/test | SKU Standard | Condiviso | Di base | Pubblicazione di massimo 14 Knowledge Base, dimensioni 2 GB |
| Ambiente di produzione | SKU Standard | Basic | Standard | Pubblicazione di massimo 49 Knowledge Base, dimensioni 25 GB |
Impostazioni consigliate
| QPS di destinazione | Servizio app | Azure AI Search |
|---|---|---|
| 3 | S1, una replica | S1, una replica |
| 50 | S3, 10 repliche | S1, 12 repliche |
| 80 | S3, 10 repliche | S3, 12 repliche |
| 100 | P3V2, 10 repliche | S3, 12 repliche, 3 partizioni |
| Da 200 a 250 | P3V2, 20 repliche | S3, 12 repliche, 3 partizioni |
Quando cambiare un piano tariffario
| Aggiornamento | Motivo |
|---|---|
| Aggiornare lo SKU di gestione di QnA Maker | Servono più coppie di domanda e risposta o origini documenti nella knowledge base. |
| Aggiornare lo SKU del servizio app e controllare il livello di Azure AI Search e creare repliche di Ricerca cognitiva | La knowledge base deve gestire più richieste dall'app client, ad esempio un chatbot. |
| Aggiornare il servizio Azure AI Search | Si prevede di avere molte knowledge base. |
Ottenere gli aggiornamenti di runtime più recenti aggiornando il servizio app nel portale di Azure.
Chiavi in QnA Maker
Il servizio QnA Maker gestisce due tipi di chiavi: le chiavi di creazione e le chiavi di endpoint della query usate con il runtime ospitato nel servizio app.
Usare queste chiavi quando si effettuano richieste al servizio tramite le API.
| Nome | Ufficio | Scopo |
|---|---|---|
| Chiave di creazione/sottoscrizione | Azure portal | queste chiavi vengono usate per accedere alle API del servizio di gestione di QnA Maker. Queste API consentono di modificare le domande e le risposte nella knowledge base e pubblicare la knowledge base. Queste chiavi vengono create quando si crea un nuovo servizio QnA Maker. Individuare queste chiavi nella risorsa Servizi di Azure AI nella pagina Chiavi ed endpoint. |
| Chiave dell’endpoint della query | Portale di QnA Maker | Queste chiavi vengono usate per eseguire query sull'endpoint della knowledge base e ottenere una risposta a una domanda dell'utente. Questo endpoint della query viene solitamente usato nel chatbot o nel codice dell'applicazione client che si connette al servizio QnA Maker. Queste chiavi vengono create quando si pubblica la knowledge base di QnA Maker. È possibile trovare queste chiavi nella pagina Impostazioni del servizio. È possibile trovare questa pagina nel menu utente in alto a destra della pagina nel menu a discesa. |
Individuare le chiavi di creazione nel portale di Azure
È possibile visualizzare e reimpostare le chiavi di creazione dal portale di Azure in cui è stata creata la risorsa QnA Maker.
Passare alla risorsa di QnA Maker nel portale di Azure e selezionare la risorsa con il tipo di Servizi di Azure AI:
Passare a Chiavi ed endpoint:
Trovare le chiavi dell'endpoint di query nel portale di QnA Maker
L'endpoint si trova nella stessa regione della risorsa perché le chiavi dell'endpoint vengono usate per effettuare una chiamata alla knowledge base.
Le chiavi endpoint possono essere gestite dal portale di QnA Maker.
Accedere al portale di QnA Maker, andare al proprio profilo e selezionare Impostazioni servizio:
Visualizzare o reimpostare le chiavi:
Nota
Aggiornare le chiavi se si ritiene che siano state compromesse. Questa operazione può richiedere modifiche corrispondenti al codice del bot o dell'applicazione client.
Area del servizio di gestione
Il servizio di gestione di QnA Maker viene usato solo per il portale di QnA Maker e per l'elaborazione iniziale dei dati. Questo servizio è disponibile solo nella regione degli Stati Uniti occidentali. Nessun dato del cliente viene archiviato nel servizio degli Stati Uniti occidentali.
Considerazioni sulla denominazione delle risorse
Il nome della risorsa QnA Maker, ad esempio qna-westus-f0-b, viene usato anche per denominare le altre risorse.
La finestra di creazione del portale di Azure consente di creare una risorsa QnA Maker e selezionare i piani tariffari per le altre risorse.
Dopo aver creato le risorse, queste riportano lo stesso nome, ad eccezione della risorsa facoltativa di Application Insights, che pospone i caratteri al nome.
Suggerimento
Creare un nuovo gruppo di risorse quando si crea una risorsa QnA Maker. Ciò consente di visualizzare tutte le risorse associate alla risorsa QnA Maker durante la ricerca per gruppo di risorse.
Suggerimento
Usare una convenzione di denominazione per indicare i piani tariffari all'interno del nome della risorsa o del gruppo di risorse. Quando si ricevono errori in seguito alla creazione di una nuova knowledge base o all'aggiunta di nuovi documenti, il limite del piano tariffario di Ricerca cognitiva è un problema comune.
Scopi delle risorse
Ogni risorsa di Azure creata con QnA Maker ha uno scopo specifico:
- Risorsa QnA Maker
- Risorsa di Ricerca cognitiva
- Servizio app
- Servizio piano app
- Servizio Application Insights
Risorsa QnA Maker
La risorsa QnA Maker consente di accedere alle API di creazione e pubblicazione.
Impostazioni di configurazione delle risorse QnA Maker
Quando si crea una nuova knowledge base nel portale di QnA Maker, l'impostazione Lingua è l'unica impostazione applicata a livello di risorsa. Selezionare la lingua quando si crea la prima knowledge base per la risorsa.
Risorsa di Ricerca cognitiva
La risorsa Ricerca cognitiva viene usata per:
- Archiviare le coppie di domanda e risposta
- Specificare la classificazione iniziale (ranker #1) delle coppie di domanda e risposta in fase di esecuzione
Utilizzo dell'indice
La risorsa mantiene un indice da usare come indice di test e gli indici rimanenti sono correlati ognuno a una knowledge base pubblicata.
Una risorsa con un prezzo per contenere 15 indici conterrà 14 knowledge base pubblicate, mentre un indice viene usato per testare tutte le knowledge base. Questo indice di test viene partizionato dalla Knowledge Base in modo che una query che usa il riquadro di test interattivo usi l'indice di test, ma restituisca solo i risultati dalla partizione specifica associata alla knowledge base specifica.
Utilizzo della lingua
La prima knowledge base creata nella risorsa QnA Maker viene usata per determinare il singolo set di lingua per la risorsa di Ricerca cognitiva e tutti i relativi indici. È possibile impostare un solo set di lingua per un servizio QnA Maker.
Uso di un singolo servizio di Ricerca cognitiva
Se si creano un servizio QnA Maker e le relative dipendenze (ad esempio Ricerca) tramite il portale, viene creato automaticamente un servizio di ricerca collegato al servizio QnA Maker. Dopo aver creato queste risorse, è possibile aggiornare l'impostazione del servizio app per usare un servizio di ricerca esistente in precedenza e rimuovere quello appena creato.
Informazioni su come configurare QnA Maker per l'uso di una risorsa di Servizi di Azure AI diversa da quella creata come parte del processo di creazione delle risorse di QnA Maker.
Servizio app e piano di servizio app
Il servizio app viene usato dall'applicazione client per accedere alle knowledge base pubblicate tramite l'endpoint di runtime. Il servizio app include il secondo livello di classificazione (ranker #2) basato sull’elaborazione del linguaggio naturale delle coppie di domanda e risposta in fase di esecuzione. La seconda classificazione applica filtri intelligenti che possono includere metadati e richieste di completamento.
Per eseguire query sulla knowledge base pubblicata, tutte le knowledge base pubblicate usano lo stesso endpoint URL, ma specificano l'ID della knowledge base all'interno della route.
{RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/generateAnswer
Application Insights
Application Insights viene usato per raccogliere i log di chat e i dati di telemetria. Esaminare le query Kusto comuni per informazioni sul servizio.
Condividere i servizi con QnA Maker
QnA Maker crea diverse risorse di Azure. Per ridurre la gestione e trarre vantaggio dalla condivisione dei costi, usare la tabella seguente per comprendere cosa è possibile condividere e cosa no:
| Servizio | Condividi | Motivo |
|---|---|---|
| Servizi di Azure AI | X | Non è possibile da progettazione |
| Piano di servizio app | ✔ | Spazio su disco fisso allocato per un piano di servizio app. Se altre app che condividono lo stesso piano di servizio app usano una quantità significativa di spazio su disco, l'istanza del servizio app QnAMaker riscontrerà problemi. |
| Servizio app | X | Non è possibile da progettazione |
| Application Insights | ✔ | Può essere condivisa |
| Servizio di ricerca | ✔ | 1. testkb è un nome riservato per il servizio QnAMaker, che non può essere usato da altri utenti.2. La mappa sinonimica in base al nome synonym-map è riservata al servizio QnAMaker.3. Il numero di knowledge base pubblicate è limitato dal livello di servizio di ricerca. Se sono disponibili indici liberi, altri servizi possono usarli. |
Passaggi successivi
- Informazioni sulla knowledge base di QnA Maker
- Comprendere un ciclo di vita della knowledge base
- Esaminare i limiti del servizio e della knowledge base