Genesys Cloud AudioHook 整合

這個 Genesys Cloud 音訊連結器可有效擷取、處理及分析客服中心互動的即時音訊串流。透過與 Audiohook 服務的持續性 WebSocket 連線，與 Genesys Cloud Audiohook API 順暢整合。這項連線可透過 gRPC 將音訊即時串流至 Agent Assist 整合後端。這個連結器提供處理傳入音訊區塊的架構，可自訂音訊處理、轉錄或其他 AI 輔助功能，例如摘要、主動生成知識輔助。

必要條件

開始整合 Genesys Cloud 語音服務前，請先完成下列步驟：

  1. 安裝 Genesys Cloud 應用程式伺服器。
  2. 設定 Genesys Cloud OAuth 用戶端和互動小工具。

如需如何建立及使用 Genesys Cloud 的 OAuth 用戶端，請參閱相關說明文件，瞭解如何指定授權類型、重新導向、權杖持續時間，以及代理程式使用的 AI 輔助功能。

  1. 安裝 Agent Assist 整合後端。
  2. 請注意下列變數：
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  3. 在 Genesys Cloud 安裝 AudioHook 監控器。

使用 Google Cloud CLI 部署 Genesys Cloud 音訊連接器伺服器

請按照下列步驟，使用 Google Cloud CLI 部署音訊連接器伺服器。

  1. 使用下列程式碼，將 GitHub 存放區複製到本機電腦或開發環境： 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
cd  genesyscloud/genesyscloud-audiohook
  2. 前往音訊連接器根目錄。

  3. 在根目錄中建立 ENV 檔案，並使用下列變數更新該檔案。

    使用 Agent Assist 整合後端的環境變數中的相同值：

    • REDIS_INSTANCE_ID
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION

    使用其他來源的值：

    • UI_CONNECTOR：已部署的 Agent Assist 整合後端服務網域名稱。
    • GCP_PROJECT_ID：專案的全球專屬 ID。請按照這些步驟尋找。
    • SERVICE_ACCOUNT：AudioHook 連接器服務的服務帳戶。如果不存在，deploy.sh 指令碼會建立新的檔案。
    • API_KEY：在 AudioHook 監控器整合中產生 API 金鑰。請參閱「新增 AudioHook 監控器憑證」一節。目前請留空，設定 AudioHook 後再更新值。
    • VOICE_INTERCEPTOR_SERVICE：為語音連線 Cloud Run 服務選擇名稱。

    ENV 檔案範例：

    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. 執行 ./genesyscloud/genesyscloud-audiohook 目錄中的 deploy.sh 指令碼：

    sh deploy.sh

設定 Genesys Cloud AudioHook 監控整合功能

請按照下列步驟設定整合。

  1. 將語音連接器部署至 Cloud Run 後，請在 Genesys Cloud 中設定並啟用 AudioHook 監控器。
  2. 在 Audiohook 的「Monitor Configuration」(監控設定) 分頁中，更新下列變數：
    • 選取管道的「兩者」。
    • 音訊掛鉤連線 URI 請使用： 
      wss://your-cloud-run-domain.run.app/connect
  3. 在「憑證」分頁中設定 API 金鑰後，請更新 ENV 檔案中的 API_KEY 環境變數。
  4. 重新部署語音連接器服務。
  5. 在佇列中啟用 AudioHook 監控器。如需更多詳細資料，請參閱 Genesys Cloud 文章中「為所有互動類型設定行為和門檻」一節，瞭解如何建立及設定佇列。