Genesys Cloud AudioHook の統合

この Genesys Cloud 音声コネクタは、コンタクト センターのやり取りからリアルタイム音声ストリームを効率的にキャプチャ、処理、分析します。Audiohook サービスへの永続的な WebSocket 接続を使用して、Genesys Cloud Audiohook API とシームレスに統合されます。この接続により、gRPC を使用して Agent Assist 統合バックエンドへのリアルタイム音声ストリーミングが可能になります。このコネクタは、受信した音声チャンクを処理するためのフレームワークを提供します。これにより、カスタム音声処理、音声文字変換、要約、生成 AI による事前知識アシストなどの AI 主導型の機能を利用できます。

前提条件

Genesys Cloud の音声統合を開始する前に、次の手順を行います。

  1. Genesys Cloud アプリケーション サーバーをインストールします。
  2. Genesys Cloud OAuth クライアントとインタラクション ウィジェットの両方を構成します。
  3. Agent Assist 統合バックエンドをインストールします。
  4. 次の変数に注意してください。
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  5. 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 Monitor の認証情報を追加するをご覧ください。現時点では空白のままにして、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. ./aa-integration-backend/audiohook ディレクトリにある deploy.sh スクリプトを実行します。

    sh deploy.sh

Genesys Cloud AudioHook モニタの統合を構成する

次の手順で統合を構成します。

  1. 音声コネクタを Cloud Run にデプロイしたら、Genesys Cloud で AudioHook モニターを構成して有効にします。
  2. Audiohook の [Monitor Configuration] タブで、次の変数を更新します。
    • チャンネルで [両方] を選択します。
    • Audiohook 接続 URI には、以下を使用します。
      wss://your-cloud-run-domain.run.app/connect
  3. [認証情報] タブで API キーを設定したら、ENV ファイルの API_KEY 環境変数を更新します。
  4. 音声コネクタ サービスを再デプロイします。
  5. キュー内で AudioHook モニターを有効にします。詳細については、Genesys Cloud のキューの作成と構成に関する記事の「すべてのインタラクション タイプの動作としきい値を設定する」セクションをご覧ください。