Integrazione di AudioHook di Genesys Cloud

Questo connettore audio Genesys Cloud acquisisce, elabora e analizza in modo efficiente i flussi audio in tempo reale dalle interazioni del contact center. Si integra perfettamente con l'API Genesys Cloud Audiohook 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 blocchi audio in entrata, consentendo l'elaborazione audio personalizzata, la trascrizione o altre funzionalità basate sull'AI come il Riepilogo e l'assistenza proattiva con l'AI generativa.

Prerequisiti

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

  1. Installa il server delle applicazioni Genesys Cloud.
  2. Configura sia il client OAuth Genesys Cloud sia il widget di interazione.

La documentazione su come creare e utilizzare il client OAuth per Genesys Cloud fornisce istruzioni per specificare il tipo di concessione, il reindirizzamento, la durata del token e le funzionalità basate sull'AI utilizzate dall'agente.

  1. Installa il backend di integrazione di Agent Assist.
  2. Tieni presente le seguenti variabili:
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  3. Installa il monitor AudioHook in Genesys Cloud.

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

Segui questi passaggi per utilizzare Google Cloud CLI per eseguire il deployment del server del connettore audio.

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

  3. Crea un file ENV nella directory radice 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 globale del progetto. Per trovarlo, segui questi passaggi.
    • SERVICE_ACCOUNT: Il account di servizio per il servizio del connettore AudioHook. Se non esiste, lo script deploy.sh ne creerà uno nuovo.
    • API_KEY: genera una chiave API nell'integrazione del monitor AudioHook. Consulta la sezione Aggiungere le credenziali di AudioHook Monitor. Lascia vuoto per ora e aggiorna il valore dopo aver configurato AudioHook.
    • VOICE_INTERCEPTOR_SERVICE: scegli un nome per il servizio Cloud Run del tuo 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 che si trova nella directory ./genesyscloud/genesyscloud-audiohook:

    sh deploy.sh

Configurare l'integrazione del monitoraggio Genesys Cloud AudioHook

Per configurare l'integrazione, segui questi passaggi.

  1. Dopo aver eseguito il deployment del connettore vocale su Cloud Run, configura e attiva il monitor AudioHook in Genesys Cloud.
  2. Nella scheda Configurazione monitor di Audiohook, aggiorna le seguenti variabili:
    • Seleziona Entrambi per il canale.
    • Per l'URI di 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 Voice Connector.
  5. Attiva il monitor AudioHook all'interno della coda. Per ulteriori dettagli, consulta la sezione "Imposta il comportamento e le soglie per tutti i tipi di interazione" dell'articolo sulla creazione e la configurazione delle code di Genesys Cloud.