この Genesys Cloud 音声コネクタは、コンタクト センターのインタラクションからリアルタイムの音声ストリームを効率的にキャプチャ、処理、分析します。Audiohook サービスへの永続的な WebSocket 接続を使用して、Genesys Cloud Audiohook API とシームレスに統合されます。この接続により、gRPC を使用した Agent Assist 統合バックエンドへのリアルタイム音声ストリーミングが可能になります。コネクタは、受信した音声チャンクを処理するためのフレームワークを提供し、カスタム音声処理、文字起こし、その他の AI 駆動型機能(要約、プロアクティブな生成知識アシストなど)を可能にします。
前提条件
Genesys Cloud 音声統合を開始する前に、次の手順を行います。
Geneysys Cloud の OAuth クライアントの作成と使用方法に関するドキュメントには、付与タイプ、リダイレクト、トークンの有効期間、エージェントが使用する AI 搭載機能の指定方法が記載されています。
- Agent Assist 統合バックエンドをインストールします。
- 次の変数に注意してください。
- VPC_CONNECTOR_NAME
- SERVICE_REGION
- REDIS_INSTANCE_ID
- Genesys Cloud に AudioHook モニターをインストールします。
Google Cloud CLI を使用して Genesys Cloud オーディオ コネクタ サーバーをデプロイする
Google Cloud CLI を使用して音声コネクタ サーバーをデプロイする手順は次のとおりです。
- 次のコードを使用して、GitHub リポジトリのクローンをローカルマシンまたは開発環境に作成します。
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations cd genesyscloud/genesyscloud-audiohook
- オーディオ コネクタのルート ディレクトリに移動します。
ルート ディレクトリに 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}
./genesyscloud/genesyscloud-audiohook
ディレクトリにある deploy.sh スクリプトを実行します。sh deploy.sh
Genesys Cloud AudioHook モニター統合を構成する
インテグレーションを構成する手順は次のとおりです。
- 音声コネクタを Cloud Run にデプロイしたら、Genesys Cloud で AudioHook モニターを構成して有効にします。
- Audiohook の [Monitor Configuration] タブで、次の変数を更新します。
- チャネルで [両方] を選択します。
- Audiohook 接続 URI には、以下を使用します。
wss://your-cloud-run-domain.run.app/connect
- [認証情報] タブで API キーを設定したら、ENV ファイルの
API_KEY
環境変数を更新します。 - 音声コネクタ サービスを再デプロイします。
- キュー内で AudioHook モニターを有効にします。詳しくは、Genesys Cloud のキューの作成と構成に関する記事の「すべてのインタラクション タイプの動作としきい値を設定する」セクションをご覧ください。