Integrazione di AudioHook di Genesys Cloud

Questo connettore audio Genesys Cloud acquisisce, elabora e analizza in modo efficiente gli stream audio in tempo reale delle interazioni del contact center. Si integra perfettamente con l'API Audiohook di Genesys Cloud utilizzando una connessione WebSocket persistente al servizio Audiohook. Questa connessione consente lo streaming audio in tempo reale con gRPC al backend di integrazione di Agent Assist. Il connettore fornisce un framework per la gestione dei chunk audio in entrata, consentendo l'elaborazione audio personalizzata, la trascrizione o altre funzionalità basate sull'AI come Summarization, Proactive Generative Knowledge Assist.

Prerequisiti

Segui questi passaggi prima di iniziare l'integrazione vocale di Genesys Cloud:

  1. Installa Genesys Cloud Application Server.
  2. Configura sia il client OAuth di Genesys Cloud sia il widget di interazione.
  3. Installa il backend di integrazione di Agent Assist.
  4. Tieni presente le seguenti variabili:
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  5. Installa il monitor AudioHook in Genesys Cloud.

Esegui il deployment del server del connettore audio Genesys Cloud utilizzando Google Cloud CLI

Per utilizzare Google Cloud CLI per implementare il server del connettore audio, segui questi passaggi.

  1. Clona il repository GitHub sulla tua macchina locale o nell'ambiente di sviluppo con il seguente codice: 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
cd  genesyscloud/genesyscloud-audiohook
  2. Vai alla directory principale del connettore audio.

  3. Crea un file ENV nella directory principale e aggiornalo con le seguenti variabili.

    Utilizza lo stesso valore della variabile di ambiente del backend di integrazione di Agent Assist:

    • REDIS_INSTANCE_ID
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION

    Utilizza un valore di un'altra origine:

    • UI_CONNECTOR: il nome di dominio del servizio di backend di integrazione di Agent Assist di cui è stato eseguito il deployment.
    • GCP_PROJECT_ID: l'identificatore univoco a livello globale del tuo progetto. Per trovarlo, segui questi passaggi.
    • SERVICE_ACCOUNT: l'account di servizio per il servizio di connettore AudioHook. Se non esiste, lo script deploy.sh ne creerà uno nuovo.
    • API_KEY: genera una chiave API nell'integrazione del monitoraggio di AudioHook. Fai riferimento alla sezione Aggiungere le credenziali di AudioHook Monitor. Per il momento lascia vuoto il campo e aggiorna il valore dopo aver configurato AudioHook.
    • VOICE_INTERCEPTOR_SERVICE: scegli un nome per il servizio Cloud Run del connettore vocale.

    File ENV di esempio:

    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. Esegui lo script deploy.sh nella directory ./aa-integration-backend/audiohook:

    sh deploy.sh

Configurare l'integrazione del monitoraggio di AudioHook di Genesys Cloud

Per configurare l'integrazione, segui questi passaggi.

  1. Dopo aver eseguito il deployment del connettore vocale in Cloud Run, configura e attiva il monitoraggio di AudioHook in Genesys Cloud.
  2. Nella scheda Monitor Configuration (Configurazione del monitoraggio) di Audiohook, aggiorna le seguenti variabili:
    • Seleziona entrambi per il canale.
    • Per l'URI connessione Audiohook, utilizza: 
      wss://your-cloud-run-domain.run.app/connect
  3. Dopo aver impostato la chiave API nella scheda Credenziali, aggiorna la variabile di ambiente API_KEY nel file ENV.
  4. Esegui nuovamente il deployment del servizio del connettore vocale.
  5. Attiva il monitoraggio di AudioHook all'interno della coda. Per ulteriori dettagli, consulta la sezione "Imposta comportamento e soglie per tutti i tipi di interazione" dell'articolo di Genesys Cloud sulla creazione e la configurazione delle code.