I connettori di conoscenza completano gli intenti definiti. Analizza i documenti della knowledge base (ad es. domande frequenti o articoli) per trovare risposte automatiche. Per configurarli, definisci una o più knowledge base, che sono raccolte di documenti di conoscenza.
Puoi attivare le knowledge base per il tuo agente, in modo che tutte le richieste di rilevamento dell'intenzione possano trovare risposte automatiche utilizzando le tue knowledge base. In alternativa, puoi specificare una o più knowledge base nelle singole richieste di rilevamento dell'intenzione.
È normale che un agente che utilizza connettori di conoscenza utilizzi anche intent definiti. I connettori di conoscenza offrono meno precisione e controllo delle risposte rispetto agli intent. Devi definire le tue intenzioni per gestire le richieste complesse degli utenti e lasciare che i connettori di conoscenza gestiscano le richieste semplici.
Per un elenco delle lingue supportate, consulta la colonna Connettori di conoscenza nel riferimento alle lingue.
Limitazioni
La funzionalità dei connettori di conoscenza è disponibile solo per la global
regione.
Attivare le funzionalità beta
Assicurati che le funzionalità beta siano attive:
- Vai alla console Dialogflow ES.
- Seleziona un agente.
- Fai clic sul pulsante delle impostazioni settings accanto al nome dell'agente.
- Scorri verso il basso nella scheda Generali e assicurati che l'opzione Funzionalità beta sia attivata.
- Se hai apportato modifiche, fai clic su Salva.
Crea una knowledge base e un documento
Segui le istruzioni riportate nella guida alle knowledge base per creare una knowledge base e un documento.
Impostazioni per i connettori di conoscenza
Puoi attivare o disattivare le knowledge base per l'agente. Le knowledge base attivate verranno prese in considerazione per tutte le richieste di corrispondenza all'intento che non specificano knowledge base. Per attivare o disattivare le knowledge base:
- Vai alla console Dialogflow ES.
- Seleziona un agente.
- Fai clic su Conoscenza nel menu della barra laterale a sinistra.
- Seleziona una o più knowledge base dall'elenco.
- Fai clic su Attiva o Disattiva.
Quando un'espressione dell'utente finale corrisponde anche a un'intenzione, puoi specificare la preferenza per i risultati della scheda informativa:
- Scorri verso il basso fino alla sezione Modificare la preferenza per i risultati della conoscenza.
- Regola il cursore da più debole (preferenza data all'intenzione) a più forte (preferenza data alla conoscenza). Per ulteriori informazioni, vedi Rileva le risposte all'intent di seguito.
Configurare le risposte
Per impostazione predefinita, una knowledge base è configurata con una singola risposta di testo predefinita compilata con la risposta della conoscenza più adatta. Puoi modificare questa risposta e aggiungere messaggi con risposta avanzata. Le risposte della knowledge base possono contenere fino a tre risposte per knowledge base e puoi fare riferimento a queste risposte nelle risposte configurate. Per aggiungere le risposte:
- Nella pagina Conoscenza, fai clic sul nome della tua knowledge base.
- Scorri verso il basso fino alla sezione Risposte e aggiungi le risposte che preferisci:
- Quando definisci la prima risposta,
utilizza
$Knowledge.Question[1]
e$Knowledge.Answer[1]
dove vuoi che vengano fornite la domanda e la risposta. - L'indice per
$Knowledge.Question
e$Knowledge.Answer
inizia da 1, quindi aumenta questo indice quando aggiungi altre risposte.
- Quando definisci la prima risposta,
utilizza
- Al termine, fai clic su Salva.
Quando definisci le risposte, devi considerare questi punti:
- Se il numero di risposte definite è superiore al numero N di corrispondenze della risposta del connettore di conoscenza, verranno restituite solo N risposte.
- Poiché l'accuratezza potrebbe essere inferiore rispetto alla corrispondenza di intenti definiti esplicitamente, ti consigliamo di restituire tre risposte agli utenti, se possibile.
Esempio:
Rilevamento dell'intent con la knowledge base
Quando effettui una richiesta di rilevamento dell'intenzione, puoi specificare una o più basi di conoscenza per una possibile risposta. L'indicazione esplicita delle knowledge base in una richiesta sovrascrive le impostazioni per le knowledge base attivate e disattivate.
Gli esempi riportati di seguito mostrano come utilizzare la console Dialogflow, l'API REST (inclusa la riga di comando) o le librerie client per rilevare l'intent.
Per utilizzare l'API, chiama il metodo detectIntent
sul tipo
Sessions
.
UI web
Puoi interagire con l'agente e ricevere le risposte del connettore di conoscenza tramite il simulatore Dialogflow:- Segui i passaggi precedenti per attivare una knowledge base.
- Segui i passaggi precedenti per definire le risposte.
- Digita "Come faccio a registrarmi?" nel simulatore.
REST
Chiama il metododetectIntent
sul tipo
Sessions
e specifica la knowledge base nel campo queryParams
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: il tuo ID progetto Google Cloud
- KNOWLEDGE_BASE_ID: il tuo ID knowledge base
Metodo HTTP e URL:
POST https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/agent/sessions/123456789:detectIntent
Corpo JSON della richiesta:
{ "queryInput": { "text": { "text": "How do I sign up?", "languageCode": "en-US" } }, "queryParams": { "knowledgeBaseNames": ["projects/PROJECT_ID/knowledgeBases/KNOWLEDGE_BASE_ID"] } }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ ... "queryResult": { "queryText": "How do I sign up?", "parameters": {}, "allRequiredParamsPresent": true, "fulfillmentText": "Sign up for Cloud Storage by turning on the Cloud Storage service in the Google Cloud Platform Console.", "intent": { "name": "projects/my-gcp-project/agent/intents/487c7242-a769-408a-a339-47b95e10dac4", "displayName": "Knowledge.KnowledgeBase.MzkzNTAyMDE3NDQxNDk3MDg4MA" }, "intentDetectionConfidence": 0.99371547, "languageCode": "en-us", "knowledgeAnswers": { "answers": [ { "answer": "Sign up for Cloud Storage by turning on the Cloud Storage service in the Google Cloud Platform Console.", "matchConfidenceLevel": "HIGH", "matchConfidence": 0.99371547 }, { "answer": "Certain types of content are not allowed on this service; please refer to the Terms of Services and Platform Policies for details. If you believe a piece of content is in violation of our policies, report it here (select See more products, then Google Cloud Storage and Cloud Bigtable).", "matchConfidenceLevel": "LOW", "matchConfidence": 0.0012244871 }, { "answer": "From the Cloud Storage documentation click \"Send feedback\" near the top right of the page. This will open a feedback form. Your comments will be reviewed by the Cloud Storage team.", "matchConfidenceLevel": "LOW", "matchConfidence": 0.0011537358 } ] } } }
Java
Per autenticarti a Dialogflow, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per autenticarti a Dialogflow, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per autenticarti a Dialogflow, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Rileva le risposte all'intent
La risposta per il metodo detectIntent
di tipo Sessions
è un DetectIntentResponse
.
Diversi fattori influiscono sul modo in cui vengono compilati i campi di risposta.
Se un'intenzione definita e una knowledge base sono entrambe potenziali corrispondenze,
la confidenza della corrispondenza di ciascuna e la preferenza per i risultati della knowledge base
(vedi Impostazioni per i connettori della knowledge base)
vengono utilizzate per determinare quale corrispondenza è quella selezionata.
La corrispondenza selezionata viene inserita nel campo DetectIntentResponse.queryResult
, mentre le altre potenziali corrispondenze vengono inserite nel campo DetectIntentResponse.alternativeQueryResults
.
Entrambi questi campi contengono messaggi QueryResult
.
Se una knowledge base fornisce una potenziale corrispondenza:
QueryResult.knowledgeAnswers
viene compilato con un elenco di potenziali risposte del knowledge ordinato in base alla probabilità di corrispondenza decrescente.- Se sono state definite risposte avanzate per la knowledge base,
QueryResult.fulfillmentMessages
viene compilato con i messaggi di risposta avanzata.
Quando esegui una richiesta di rilevamento dell'intenzione,
è possibile che la query di conoscenza non vada a buon fine.
In questo caso, verranno selezionati gli intent definiti,
pertanto la richiesta di rilevamento dell'intent complessiva non avrà esito negativo.
Puoi trovare le informazioni sugli errori delle query sulla conoscenza nel campo DetectIntentResponse.alternativeQueryResults[i].diagnosticInfo
.
Gestione delle knowledge base
Per scoprire di più sulla gestione delle knowledge base, consulta Gestire le knowledge base.