In dieser Anleitung wird beschrieben, wie Sie die Funktion Virtual Agent Assist aktivieren, indem Sie die API direkt aufrufen. Der Assistent von Virtual Agent Assist verfolgt die Unterhaltung und verwendet einen virtuellen Dialogflow Agenten, um menschliche Kundenservicemitarbeiter bei ihren Arbeitsabläufen zu unterstützen und Intents für die Datenanalyse zu erkennen.
Alternativ können Sie in der Agent Assist Console ein Modell trainieren und seine Leistung mit dem Simulator testen. Eine Anleitung finden Sie in der Anleitung zur Virtual Agent Assist Console.
Hinweis
Bevor Sie Virtual Agent Assist aktivieren können, müssen Sie bereits eine oder mehrere Agent Assist-Funktionen implementiert haben, die mit dem virtuellen Kundenservicemitarbeiter verwendet werden sollen. „Intelligente Antwort“, „FAQ Assist“, „Artikelvorschlag“ und „Intelligentes Schreiben“ können einzeln mit Virtual Agent Assist oder in beliebiger Kombination verwendet werden. Über die folgenden Links gelangen Sie zur entsprechenden Dokumentation mit Details zur Implementierung.
Unterhaltung erstellen
Wenn ein Dialog zwischen einem Endnutzer und einem menschlichen oder virtuellen Kundenservicemitarbeiter beginnt, erstellen Sie eine Unterhaltung. Damit Sie Vorschläge sehen können, müssen Sie einen Endnutzer und einen menschlichen Kundenservicemitarbeiter erstellen und der Unterhaltung als Teilnehmer hinzufügen. Dieser Prozess wird in den folgenden Abschnitten beschrieben.
Zuerst müssen Sie eine Unterhaltung erstellen:
REST
Rufen Sie zum Erstellen einer Unterhaltung die Methodecreate für die
Conversation
Ressource auf.
Ersetzen Sie folgende Werte in den Anfragedaten:
- PROJECT_ID: Ihre Cloud-Projekt-ID
- LOCATION_ID: Ihre Standort-ID
- CONVERSATION_PROFILE_ID: Die ID, die Sie beim Erstellen des Unterhaltungsprofils erhalten haben.
HTTP-Methode und URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations
JSON-Text der Anfrage:
{
"conversationProfile": "projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"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"
}
Das Pfadsegment nach conversations enthält Ihre neue Unterhaltungs-ID.
Python
Richten Sie zur Authentifizierung bei Agent Assist die Standardanmeldedaten für Anwendungen (ADC) ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Endnutzer als Teilnehmer erstellen
Sie müssen der Unterhaltung sowohl Endnutzer als auch menschliche Kundenservicemitarbeiter hinzufügen, damit Vorschläge angezeigt werden. Fügen Sie der Unterhaltung zuerst einen Endnutzer als Teilnehmer hinzu:
REST
Rufen Sie zum Erstellen eines Endnutzers als Teilnehmer
die Methode create für die
Participant
Ressource auf.
Ersetzen Sie folgende Werte in den Anfragedaten:
- PROJECT_ID: Ihre Cloud-Projekt-ID
- LOCATION_ID: Ihre Standort-ID
- CONVERSATION_ID: Die Unterhaltungs-ID
HTTP-Methode und URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants
JSON-Text der Anfrage:
{
"role": "END_USER",
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"name": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants/PARTICIPANT_ID",
"role": "END_USER"
}
Das Pfadsegment nach participants enthält die neue Teilnehmer-ID für den Endnutzer.
Python
Richten Sie zur Authentifizierung bei Agent Assist die Standardanmeldedaten für Anwendungen (ADC) ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Menschlichen Kundenservicemitarbeiter als Teilnehmer erstellen
Fügen Sie der Unterhaltung einen menschlichen Kundenservicemitarbeiter als Teilnehmer hinzu:
REST
Rufen Sie zum Erstellen eines menschlichen Kundenservicemitarbeiters als Teilnehmer
die Methode create für die
Participant
Ressource auf.
Ersetzen Sie folgende Werte in den Anfragedaten:
- PROJECT_ID: Ihre Cloud-Projekt-ID
- LOCATION_ID: Ihre Standort-ID
- CONVERSATION_ID: Die Unterhaltungs-ID
HTTP-Methode und URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants
JSON-Text der Anfrage:
{
"role": "HUMAN_AGENT",
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"name": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants/PARTICIPANT_ID",
"role": "HUMAN_AGENT"
}
Das Pfadsegment nach participants enthält die neue Teilnehmer-ID für den menschlichen Kundenservicemitarbeiter.
Python
Richten Sie zur Authentifizierung bei Agent Assist die Standardanmeldedaten für Anwendungen (ADC) ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Nachricht vom Endnutzer hinzufügen und Vorschläge erhalten
Rufen Sie die
analyzeContent
Methode für die
Participant
Ressource auf, um eine Endnutzernachricht für die Unterhaltung hinzuzufügen und zu analysieren. Die Antwort enthält ein Feld dialogflowAssistAnswers mit den folgenden Daten:
fulfillmentText: Enthält einen Antwortvorschlag. Sie können Ihr System so konfigurieren, dass dieser Vorschlag dem menschlichen Kundenservicemitarbeiter angezeigt wird.answer record: Eine eindeutige ID für den Vorschlag.
Vorschlag auswählen
Wenn ein menschlicher Kundenservicemitarbeiter einen Vorschlag erhält, kann er ihn unverändert annehmen oder bearbeiten, bevor er ihn an den Endnutzer weitergibt. Rufen Sie
analyzeContent
noch einmal mit dem menschlichen Agenten-Teilnehmer auf, um einen Vorschlag auszuwählen. Legen Sie das Feld suggestionInput auf die ausgewählten Einstellungen fest und geben Sie den zuvor erhaltenen answer record an. Das Feld text override sollte den tatsächlichen Text enthalten, der an den Endnutzer gesendet wurde. Hier sehen Sie ein Beispiel für die Konfiguration des Felds suggestionInput:
{
"answerRecord": "answer-record",
"textOverride": {
"text" : "Yes, there will be ponies.",
"languageCode": "en-US"
}
}
Unterhaltung abschließen
Verwenden Sie am Ende der Unterhaltung die API, um die Unterhaltung abzuschließen.
REST
Rufen Sie zum Abschließen der Unterhaltung diecomplete Methode für die
conversations
Ressource auf.
Ersetzen Sie folgende Werte in den Anfragedaten:
- PROJECT_ID: Ihre GCP-Projekt-ID
- CONVERSATION_ID: Die ID, die Sie beim Erstellen der Unterhaltung erhalten haben
HTTP-Methode und URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/conversations/CONVERSATION_ID:complete
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"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
Richten Sie zur Authentifizierung bei Agent Assist die Standardanmeldedaten für Anwendungen (ADC) ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.