Sie können einen Anwendungsserver zum Rendern von Agent Assist-Vorschlägen im Web in Genesys Cloud einrichten.
Ziele
Die Genesys Cloud-Integration umfasst die folgenden Prozesse:
- Stellen Sie den Backend-Server für das UI-Modul bereit, um die Dialogflow API aufzurufen, ein Authentifizierungstoken zu registrieren und Cloud Pub/Sub und Memorystore for Redis einzurichten.
- Stellen Sie den Genesys Cloud-Anwendungsserver zum Rendern des Agent Assist-UI-Moduls in Cloud Run bereit.
- OAuth-Client erstellen
- Füllen Sie die Umgebungsvariablen aus.
- Richten Sie das Interaktions-Widget in Genesys Cloud ein.
- Konfigurieren Sie die Agent Assist-Integration mit dem Interaktions-Widget in Genesys Cloud.
- Messenger in Genesys Cloud konfigurieren
- Verwenden Sie die Webchat- und Messaging-Tools von Genesys Cloud, um die Integration zu testen.
Hinweise
Sie müssen die folgenden Aktionen ausführen, bevor Sie mit der Genesys Cloud-Integration beginnen:
- Installieren Sie die Google Cloud CLI, falls Sie sie noch nicht konfiguriert haben.
- Folgen Sie der Google Cloud Anleitung zum Erstellen eines Dienstkontos und Zuweisen der Rolle „Dialogflow API Client“.
- Wenden Sie sich an agent-assist-ui-modules-support@google.com, um Zugriff auf das Genesys Cloud-Repository zu erhalten.
- Stellen Sie ein Backend für Agent Assist-UI-Module bereit. Wenn Sie den Backend-Server bereitstellen, geben Sie die Umgebungsvariable
AUTH_OPTION
alsGenesysCloud
an. Folgen Sie dazu der Bereitstellungsanleitung.
Genesys Cloud-Anwendungsserver mit der CLI bereitstellen
- Klonen Sie das Git-Repository mit dem folgenden Code auf Ihren lokalen Computer oder in Ihre Entwicklungsumgebung:
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
- Verwenden Sie in Ihrem lokalen Terminal den folgenden Code, um das aktive Verzeichnis in das Stammverzeichnis des Repositorys zu ändern, in dem sich die Docker-Datei befindet, bevor Sie die Google Cloud CLI-Builds ausführen.
cd genesyscloud/frontend
- Wenn Sie zur Eingabe eines Dienstnamens aufgefordert werden, drücken Sie die Eingabetaste, um den Standardwert zu übernehmen.
- Stellen Sie die Integration mit dem folgenden Befehl bereit. Ersetzen Sie
PROJECT-ID
durch die Projekt-ID Ihres Agents, Google Cloud durch die Client-E-Mail-Adresse Ihres Dienstkontos und legen SieREGION
für Cloud Run fest.UI_MODULE_SERVICE_ACCOUNT
gcloud run deploy $AA_MODULE_APPLICATION_SERVER
--source ./
--service-account=$ui_module_service_account
--memory 1Gi --platform managed
--region us-central1
--allow-unauthenticated
- Klicken Sie auf Eingabe, um den Standarddienstnamen zu übernehmen.
Weitere Informationen finden Sie in der Cloud Run-Dokumentation. In der Google Cloud Console können Sie unter Cloud Run eine Liste Ihrer aktiven Integrationsbereitstellungen aufrufen.
OAuth-Client erstellen
- Folgen Sie der Anleitung in der Genesys Cloud-Dokumentation, um einen neuen OAuth-Client (Token Implicit Grant) zu erstellen.
- Prüfen Sie, ob der Grant-Typ Implizite Berechtigung (Browser) ist.
- Fügen Sie die URL Ihrer Anwendung dem Abschnitt Autorisierte Weiterleitungs-URIs hinzu.
- Aktualisieren Sie die Dauer des OAuth 2.0-Clienttokens auf 3.600 Sekunden. Dies entspricht dem JWT-Token für den Dialogflow API-Zugriff von 1 Stunde.
{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.
- Ersetzen Sie
CONVERSATION_PROFILE_NAME
durch den Namen des Unterhaltungsprofils, z. B.projects/your-project/locations/your-location/conversationProfiles/abc123
. - Ersetzen Sie
{FEATURES}
durch eine durch Kommas getrennte Liste der Agent Assist-Funktionen, die in der Anwendung enthalten sein sollen. Wichtig: Fügen Sie nur Funktionen ein, die in Ihrem Konversationsprofil konfiguriert sind. Genesys Cloud unterstützt die folgenden Funktionen: - Wenn Sie dem OAuth-Client Bereiche hinzufügen möchten, gehen Sie zum Bereich Bereich und wählen Sie Ihre Tags aus.
Die Bereiche sollten Benachrichtigungen, Autorisierung, Unterhaltungen, Benachrichtigungen und Organisation umfassen.
Beispiel-URL:
https://my-project.wm.run.app?conversationProfile=projects/my-project/conversationProfiles/abc123&features=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION
Umgebungsvariablen vervollständigen
Die Genesys Cloud-Anwendung verwendet die folgenden Umgebungsvariablen. Folgen Sie der Cloud Run-Anleitung, um die Umgebungsvariablen festzulegen.
OAUTH_CLIENT_ID
: Genesys Cloud-OAuth-Client-ID.GENESYS_CLOUD_REGION
: die Genesys Cloud-Region. Zum Beispielusw2.pure.cloud
für „US West(Oregon)“. Der Standardwert istmypurecloud.com
.GENESYS_CLOUD_ENVIRONMENT
: Genesys Cloud-Umgebung. Der Standardwert istprod
.PROXY_SERVER
: Die URL des Agent Assist-Backend-Connectors.APPLICATION_SERVER_URL
: URL des UI-Anwendungsservers.PROJECT_ID
: Ihre Google Cloud -Projekt-IDCONVERSATION_PROFILE
: Das zu verwendende Unterhaltungsprofil. Dieser sollte mit dem Profil in der Weiterleitungs-URL des OAuth-Clients übereinstimmen.FEATURES
: Durch Kommas getrennte Konstante für Agent Assist-Funktionen. Dies sollte mit den Funktionen in der Weiterleitungs-URL des OAuth-Clients übereinstimmen.CHANNEL
: Wählen Sie den Integrationstyp aus. Der Wert kann „voice“ oder „chat“ sein.
Beispiel für eine .env-Datei:
OAUTH_CLIENT_ID={your-oauth-client-id} GENESYS_CLOUD_REGION={your-pure-cloud-region} GENESYS_CLOUD_ENVIRONMENT={your-pure-cloud-environment} PROXY_SERVER={your-proxy-server-endpoint} PROJECT_ID={your-gcp-project-id} CONVERSATION_PROFILE={your-conversation-profile} FEATURES=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION CHANNEL={use-voice-or-chat}
Wenn Sie einen OAuth-Client erstellen, stellt Genesys Cloud auch eine Client-ID bereit.
Führen Sie den Bereitstellungsbefehl mit aktualisierten Umgebungsvariablen aus.
gcloud run deploy $AA_MODULE_APPLICATION_SERVER
--source ./
--service-account=$ui_module_service_account
--memory 1Gi --platform managed
--region us-central1
--allow-unauthenticated
--set-env-vars ^~^OAUTH_CLIENT_ID=$OAUTH_CLIENT_ID~GENESYS_CLOUD_REGION=$GENESYS_CLOUD_REGION~GENESYS_CLOUD_ENVIORNMENT=$GENESYS_CLOUD_ENVIORNMENT~CONVERSATION_PROFILE=$CONVERSATION_PROFILE~FEATURES=$FEATURES~PROJECT_ID=$PROJECT_ID~APPLICATION_SERVER_URL=''~PROXY_SERVER=$PROXY_SERVER~APPLICATION_SERVER_URL=$APPLICATION_SERVER_URL
Der Genesys Cloud-Anwendungsserver muss auf einem Google Cloud -Hostingdienst bereitgestellt werden. App Engine oder Cloud Run verwenden
Anwendungsserver herunterfahren
- Löschen Sie den Cloud Run-Dienst.
- Führen Sie in Ihrem lokalen Terminal den folgenden Befehl aus:
gcloud run services list
- Wählen Sie die zuvor ausgewählte Zielplattform aus, um aktive Bereitstellungen aufzulisten.
- Führen Sie dazu diesen Befehl aus:
gcloud run services delete agent-assist-modules-application-server
Haftungsausschluss für Preise
Wenn Sie die Genesys Cloud-Integration verwenden, fallen Kosten für den zugrunde liegenden Cloud Run-Dienst an.