開始前に

Genesys Audio Connector とのアシスタントの統合を開始する前に、以下の前提条件を満たしている必要があります。

• Genesys Architect および Genesys Cloud ポータルの正しい地域にアクセスできる、新規アカウントまたは既存の Genesys Cloud アカウントにログインします。
• Genesys Cloud 組織での Admin 役割。

Genesysクラウドのロールとパーミッションの詳細については、「 ロールとパーミッションの概要 」を参照してください。

アシスタントでのオーディオ・コネクター統合の作成

1. 左メニューの をクリックして、 統合ページに移動します。

「保存」 をクリックしても資格情報が表示されないため、資格情報を保管します。 Genesys Audio Connector をセットアップするには、これらの資格情報が必要です。

1. 「電話」 のタイルで 「追加」 をクリックします。

2. 「Genesys Audio Connector」 タイルをクリックします。

3. 「資格情報」 セクションで、自動生成された資格情報を以下のフィールドにコピーして保管します。

   • API キー
   • クライアント・シークレット
   • Genesys オーディオ接続 URI
   • ボット・コネクター ID

4. **「保存して終了」**をクリックします。

アシスタントを統合するためのオーディオ・コネクターのセットアップ

Genesys Audio Connectorをセットアップするには、Genesys Cloudドキュメントの「 Configure and activate Audio Connector in Genesys Cloud 」トピックのステップを完了します。

Genesys Admin ページで、 Integrations > Configuration に進み、 アシスタントで Audio Connector インテグレーションを作成した ときにコピーした Genesys audio connect URI 値を追加します。

Genesys Admin ページで、 Integrations > Credentials に進み、 アシスタントでAudio Connector統合を作成した ときにコピーした APIキーと Client secret フィールドの認証情報を追加します。

セッション変数によるコンテキスト共有

Genesys Architect フローの Audio Connector ノードから、情報を watsonx Assistantに渡すために使用できるセッション変数を指定できます。 入力パラメーターと出力パラメーターの両方を指定できます。 統合のために、これらのパラメータは、 context オブジェクトの下に1つのオブジェクトに統合される。

入力パラメーターと出力パラメーターの両方が watsonx Assistant context で使用可能であり、情報は各ターンで共有されます。 例えば、 watsonx Assistantで利用できる context ：

{
  "context": {
    "integrations": {
      "genesys_audio_connector": {
        "user_id": "<SENT FROM GENESYS>",
        "some_variable": "<SET_FROM_WATSON_ASSISTANT>"
      }
    }
  }
}

セッション変数 ${system_integrations.genesys_audio_connector.user_id}を使って、'watsonx Assistant入力パラメータにアクセスする。

出力パラメータを設定するには、${system_integrations{system_integrations.genesys_audio_connector.some_variable}のような式を使用します。

出力変数を設定するには、以下の手順を実行する：

1. 変数を定義したいアクションステップに移動する。

2. **Set new variable ** をクリックし、Expression を選択する。

3. 以下の式を入力する： ${system_integrations.genesys_audio_connector.<variable_name>} = "<variable_value>"

   例:

   ${system_integrations.genesys_audio_connector.some_variable} = "this is an output variable"
   

   この例では、変数名は some_variable で、値は this is an output variable に設定されています。

Genesys Audio Connector フローの終了

ユーザーから音声会話を受信した後、Genesys Architect の音声コネクター・ノードを使用すると、会話が終了するまでユーザーとアシスタントの間でメッセージを交換することができます。 オーディオ会話を Genesys に送り返すには、 end_session レスポンスタイプを使用する必要があります。

{
  "generic": [
    {
      "response_type": "text",
      "values": [
        {
          "text": "You have ended the call."
        }
      ]
    },
    {
      "response_type": "end_session"
    }
  ]
}

応答タイプ

watsonx Assistant を Genesys Audio Connector と統合した後、アシスタントで以下の 応答タイプ を使用できます。

• テキスト
• オプション
• end_session
• speech_to_text
• text_to_speech
• start_activities
• stop_activities
• dtmf
• user_defined
• connect_to_agent
• イメージ
• 音声