Questa guida illustrativa illustra la procedura per abilitare la funzionalità Assistente agente virtuale chiamando direttamente l'API. L'assistente Agent Assist segue la conversazione e utilizza un agente virtuale Dialogflow per fornire supporto al workflow agli agenti umani e rilevare gli intent per l'analisi dei dati.
Se preferisci, puoi utilizzare la console di Agent Assist per addestrare un modello e testarne il rendimento utilizzando il simulatore. Per istruzioni, consulta il tutorial della console di Agent Assist virtuale .
Prima di iniziare
Prima di poter abilitare l'assistente agente virtuale, devi aver già implementato una o più funzionalità di Agent Assist da utilizzare con l'agente virtuale. Risposta rapida, Assistenza per le domande frequenti, Suggerimento articoli e Scrittura intelligente possono essere utilizzati da soli con Agent Assist virtuale o in qualsiasi combinazione. I seguenti link ti rimandano alla documentazione pertinente per i dettagli di implementazione.
Crea una conversazione
Quando inizia una finestra di dialogo tra un utente finale e un agente umano o virtuale, crei una conversazione. Per visualizzare i suggerimenti, devi anche creare un partecipante utente finale e un partecipante agente umano e aggiungerli alla conversazione. Le sezioni seguenti illustrano questa procedura.
Innanzitutto, devi creare una conversazione:
REST
Per creare una conversazione, chiama il metodocreate sulla
Conversation
risorsa.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID del tuo progetto Cloud
- LOCATION_ID: ID località
- CONVERSATION_PROFILE_ID: l'ID che hai ricevuto quando hai creato il profilo di conversazione
Metodo HTTP e URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations
Corpo JSON della richiesta:
{
"conversationProfile": "projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"name": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID",
"lifecycleState": "IN_PROGRESS",
"conversationProfile": "projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
"startTime": "2018-11-05T21:05:45.622Z"
}
Il segmento di percorso dopo conversations contiene il nuovo ID conversazione.
Python
Per eseguire l'autenticazione in Agent Assist, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Crea un partecipante utente finale
Per visualizzare i suggerimenti, devi aggiungere alla conversazione sia i partecipanti utente finale sia gli agenti umani. Innanzitutto, aggiungi il partecipante utente finale alla conversazione:
REST
Per creare un partecipante utente finale,
chiama il metodo create sulla
Participant
risorsa.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID del tuo progetto Cloud
- LOCATION_ID: ID località
- CONVERSATION_ID: l'ID della tua conversazione
Metodo HTTP e URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants
Corpo JSON della richiesta:
{
"role": "END_USER",
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"name": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants/PARTICIPANT_ID",
"role": "END_USER"
}
Il segmento di percorso dopo participants contiene il nuovo ID partecipante utente finale.
Python
Per eseguire l'autenticazione in Agent Assist, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Crea un partecipante agente umano
Aggiungi un partecipante agente umano alla conversazione:
REST
Per creare un partecipante agente umano,
chiama il metodo create sulla
Participant
risorsa.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID del tuo progetto Cloud
- LOCATION_ID: ID località
- CONVERSATION_ID: l'ID della tua conversazione
Metodo HTTP e URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants
Corpo JSON della richiesta:
{
"role": "HUMAN_AGENT",
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"name": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants/PARTICIPANT_ID",
"role": "HUMAN_AGENT"
}
Il segmento di percorso dopo participants contiene il nuovo ID partecipante agente umano.
Python
Per eseguire l'autenticazione in Agent Assist, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Aggiungi un messaggio dall'utente finale e ricevi suggerimenti
Per aggiungere e analizzare un messaggio dell'utente finale per la conversazione, chiama il
analyzeContent
metodo sulla
Participant
risorsa. La risposta include un campo dialogflowAssistAnswers contenente i seguenti dati:
fulfillmentText: contiene una risposta suggerita. Puoi configurare il sistema in modo che presenti questo suggerimento all'agente umano.answer record: un ID univoco per il suggerimento.
Seleziona il suggerimento
Quando un agente umano riceve un suggerimento, può accettarlo così com'è o modificarlo prima di passarlo all'utente finale. Per selezionare un suggerimento, chiama
analyzeContent
di nuovo utilizzando il partecipante agente umano. Imposta il campo suggestionInput sulle impostazioni selezionate e fornisci il answer record che hai ricevuto in precedenza. Il campo text override deve contenere il testo effettivo inviato all'utente finale. Di seguito è riportato un esempio di configurazione del campo suggestionInput:
{
"answerRecord": "answer-record",
"textOverride": {
"text" : "Yes, there will be ponies.",
"languageCode": "en-US"
}
}
Completa la conversazione
Al termine della conversazione, utilizza l'API per completarla.
REST
Per completare la conversazione, chiama il metodocomplete sulla
conversations
risorsa.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID del tuo progetto GCP
- CONVERSATION_ID: l'ID che hai ricevuto quando hai creato la conversazione
Metodo HTTP e URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/conversations/CONVERSATION_ID:complete
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"name": "projects/PROJECT_ID/conversations/CONVERSATION_ID",
"lifecycleState": "COMPLETED",
"conversationProfile": "projects/PROJECT_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
"startTime": "2018-11-05T21:05:45.622Z",
"endTime": "2018-11-06T03:50:26.930Z"
}
Python
Per eseguire l'autenticazione in Agent Assist, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.