Genesys Cloud AudioHook の統合

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

前提条件

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

  1. Genesys Cloud アプリケーション サーバーをインストールします。
  2. Genesys Cloud OAuth クライアントとインタラクション ウィジェットの両方を構成します。

Geneysys 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: プロジェクトのグローバル一意の識別子。こちらの手順で確認できます。
    • 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. ./genesyscloud/genesyscloud-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 のキューの作成と構成に関する記事の「すべてのインタラクション タイプの動作としきい値を設定する」セクションをご覧ください。