Genesys Cloud AudioHook-Integration

Dieser Genesys Cloud-Audio-Connector erfasst, verarbeitet und analysiert effizient Echtzeit-Audiostreams aus Ihren Contact-Center-Interaktionen. Sie lässt sich nahtlos in die Genesys Cloud Audiohook API integrieren, indem eine persistente WebSocket-Verbindung zum Audiohook-Dienst hergestellt wird. Diese Verbindung ermöglicht das Echtzeit-Audiostreaming mit gRPC an das Agent Assist-Integrations-Backend. Der Connector bietet ein Framework für die Verarbeitung eingehender Audio-Chunks. So ist eine benutzerdefinierte Audioverarbeitung, Transkription oder andere KI-gestützte Funktionen wie Zusammenfassung und Proaktive generative Wissensunterstützung möglich.

Vorbereitung

Führen Sie die folgenden Schritte aus, bevor Sie mit der Sprachintegration in Genesys Cloud beginnen:

  1. Genesys Cloud Application Server installieren
  2. Konfigurieren Sie sowohl den Genesys Cloud OAuth-Client als auch das Interaktions-Widget.
  3. Installieren Sie das Agent Assist-Integrations-Backend.
  4. Beachten Sie die folgenden Variablen:
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  5. AudioHook-Monitor in Genesys Cloud installieren

Genesys Cloud-Audio-Connector-Server mit der Google Cloud CLI bereitstellen

So stellen Sie den Audio-Connector-Server mit der Google Cloud CLI bereit:

  1. Klonen Sie das GitHub-Repository mit dem folgenden Code auf Ihren lokalen Computer oder in Ihre Entwicklungsumgebung: 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
cd  genesyscloud/genesyscloud-audiohook
  2. Rufen Sie das Stammverzeichnis des Audio-Connectors auf.

  3. Erstellen Sie im Stammverzeichnis eine ENV-Datei und aktualisieren Sie sie mit den folgenden Variablen.

    Es wird derselbe Wert aus der Umgebungsvariablen des Agent Assist-Integrations-Backends verwendet:

    • REDIS_INSTANCE_ID
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION

    Es wird ein Wert aus einer anderen Quelle verwendet:

    • UI_CONNECTOR: Der Domainname des bereitgestellten Backend-Dienstes für die Agent Assist-Integration.
    • GCP_PROJECT_ID: Die global eindeutige Kennung Ihres Projekts. So finden Sie es.
    • SERVICE_ACCOUNT: Das Dienstkonto für den AudioHook-Connector-Dienst. Ist das nicht der Fall, wird durch das Script „deploy.sh“ ein neuer erstellt.
    • API_KEY: Erstelle einen API-Schlüssel in der AudioHook-Monitor-Integration. Weitere Informationen finden Sie im Abschnitt Anmeldedaten für AudioHook Monitor hinzufügen. Lassen Sie das Feld vorerst leer und aktualisieren Sie den Wert nach der Konfiguration von AudioHook.
    • VOICE_INTERCEPTOR_SERVICE: Wählen Sie einen Namen für den Cloud Run-Dienst des Sprachconnectors aus.

    Beispiel für eine ENV-Datei:

    CONVERSATION_PROFILE_NAME=projects/{your-project-id}/locations/{your-service-region}/conversationProfiles/{your-conversation-profile-id}
SERVICE_REGION={your-service-region}
GCP_PROJECT_ID={your-project-id}
API_KEY={api-key-from-genesys}
VPC_CONNECTOR_NAME={vpc-connector-name-from-aa-integration-backend}
SERVICE_ACCOUNT={your-service-account-name}
UI_CONNECTOR={your-agent-assist-backend-domain-name}
REDIS_INSTANCE_ID={redis-instance-id-from-aa-integration-backend}
VOICE_INTERCEPTOR_SERVICE={your-voice-interceptor-service-name}

  4. Führen Sie das Skript „deploy.sh“ im Verzeichnis ./aa-integration-backend/audiohook aus:

    sh deploy.sh

Genesys Cloud AudioHook-Monitorintegration konfigurieren

So konfigurieren Sie die Integration:

  1. Nachdem Sie den Sprach-Connector in Cloud Run bereitgestellt haben, konfigurieren und aktivieren Sie den AudioHook-Monitor in Genesys Cloud.
  2. Aktualisieren Sie auf dem Tab Monitor Configuration (Monitorkonfiguration) von Audiohook die folgenden Variablen:
    • Wählen Sie für den Kanal beides aus.
    • Verwende für die Audiohook-Verbindungs-URI Folgendes: 
      wss://your-cloud-run-domain.run.app/connect
  3. Nachdem Sie den API-Schlüssel auf dem Tab Anmeldedaten festgelegt haben, aktualisieren Sie die Umgebungsvariable API_KEY in der ENV-Datei.
  4. Stellen Sie den Voice Connector-Dienst neu bereit.
  5. Aktiviere den AudioHook-Monitor in der Warteschlange. Weitere Informationen finden Sie im Abschnitt „Verhalten und Grenzwerte für alle Interaktionstypen festlegen“ des Genesys Cloud-Artikels zum Erstellen und Konfigurieren von Warteschlangen.