Risorse di Azure per QnA Maker
QnA Maker usa diverse origini di Azure, ognuna con uno scopo diverso. Comprendere come vengono usati singolarmente consente di pianificare e selezionare il piano tariffario corretto o sapere quando modificare il piano tariffario. Comprendere come vengono usati in combinazione consente di individuare e risolvere i problemi quando si verificano.
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.
Pianificazione delle risorse
Quando si sviluppa per la prima volta una knowledge base di QnA Maker, nella fase del 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:
- Quante lingue manterranno il sistema di knowledge base?
- Quante aree sono necessarie per essere disponibili nella Knowledge Base?
- Quanti documenti in ogni dominio il sistema conterrà?
Pianificare che una singola risorsa QnA Maker contenga tutte le knowledge base con la stessa lingua, la stessa area e la stessa combinazione di dominio 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.
- Questo dovrebbe influire anche sulla selezione dello SKU di Ricerca cognitiva di Azure. Per altri dettagli, vedere qui. Potrebbe anche essere necessario modificare la capacità di Ricerca cognitiva 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 oggetto diversi. Una volta che il dominio soggetto (per una singola lingua) deve trovarsi in una knowledge base.
La risorsa di Azure servizio di ricerca 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 ha 15 indici consentiti, è possibile pubblicare 14 knowledge base (un indice per ogni knowledge base pubblicata). 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 | Ricerca di intelligenza artificiale di Azure | 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 | Ricerca di intelligenza artificiale di Azure |
|---|---|---|
| 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 modificare un piano tariffario
| Aggiornamento | Motivo |
|---|---|
| Aggiornare lo SKU di gestione di QnA Maker | Si vogliono avere più coppie QnA o origini documenti nella knowledge base. |
| Aggiornare servizio app SKU e controllare il livello Ricerca intelligenza artificiale di Azure e creare repliche di Ricerca cognitiva | La knowledge base deve gestire più richieste dall'app client, ad esempio un chatbot. |
| Aggiornare i servizio di ricerca di intelligenza artificiale di Azure | 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: la creazione di chiavi e le chiavi dell'endpoint di query usate con il runtime ospitato nel servizio app.
Usare queste chiavi quando si effettuano richieste al servizio tramite le API.
| Name | Ubicazione | Scopo |
|---|---|---|
| Creazione/chiave di 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. Trovare queste chiavi nella risorsa dei servizi di intelligenza artificiale di Azure nella pagina Chiavi ed endpoint . |
| Chiave dell'endpoint di query | Portale di QnA Maker | Queste chiavi vengono usate per eseguire query sull'endpoint della Knowledge Base pubblicato per ottenere una risposta per una domanda dell'utente. Questo endpoint di query viene in genere 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. Trovare queste chiavi nella pagina Impostazioni servizio. Trova questa pagina dal menu dell'utente in alto a destra nella pagina nel menu a discesa. |
Trovare 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 QnA Maker nella portale di Azure e selezionare la risorsa con il tipo di servizi di intelligenza artificiale di Azure:
Passare a Chiavi ed endpoint:
Trovare le chiavi dell'endpoint di query nel portale di QnA Maker
L'endpoint si trova nella stessa area 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, passare al profilo e quindi 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 nell'area Stati Uniti occidentali. Nessun dato del cliente viene archiviato nel servizio 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 portale di Azure consente di creare una risorsa QnA Maker e selezionare i piani tariffari per le altre risorse.
Dopo aver creato le risorse, hanno lo stesso nome, ad eccezione della risorsa facoltativa di Application Insights, che antepone 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 in base al 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 dalla creazione di una nuova Knowledge Base o dall'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 QnA
- Specificare la classificazione iniziale (ranker #1) delle coppie QnA in fase di esecuzione
Utilizzo dell'indice
La risorsa mantiene un indice da usare come indice di test e gli indici rimanenti sono correlati a una knowledge base pubblicata ognuna.
Un prezzo di risorsa per contenere 15 indici, conterrà 14 knowledge base pubblicate e 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 set di lingue singole per la risorsa ricerca cognitiva e tutti i relativi indici. È possibile impostare una sola lingua per un servizio QnA Maker.
Uso di un singolo servizio di ricerca cognitivo
Se si crea un servizio QnA e le relative dipendenze ,ad esempio Ricerca, tramite il portale viene creato un servizio di ricerca e collegato al servizio QnA Maker. Dopo aver creato queste risorse, è possibile aggiornare l'impostazione servizio app per usare un servizio di ricerca esistente in precedenza e rimuovere quello appena creato.
Informazioni su come configurare QnA Maker per usare una risorsa del servizio azure per intelligenza artificiale 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 basato sul secondo livello di classificazione basato sul linguaggio naturale (ranker #2) delle coppie QnA 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 e non condividere:
| Servizio | Condividi | Motivo |
|---|---|---|
| Servizi di Azure AI | X | Non è possibile progettare |
| 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 spazio su disco significativo, l'istanza di QnAMaker servizio app riscontrerà problemi. |
| Servizio app | X | Non è possibile progettare |
| Application Insights | ✔ | Può essere condivisa |
| Servizio di ricerca | ✔ | 1. testkb è un nome riservato per il servizio QnAMaker. 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 servizio di ricerca. Se sono disponibili indici gratuiti, 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