IBM Cloud Docs
Genesys Bot Connector との統合

Genesys Bot Connector との統合

IBM Cloud

Genesys Bot Connector 統合を使用して、アシスタントを Genesys に接続します。

Genesys Bot Connector により、Genesys Architect Flow 設計者は、メッセージングと会話のフローをサード・パーティーの仮想アシスタントと統合できます。

開始前に

Genesys Bot Connectorにアシスタントを統合する前に、以下の要件を満たす必要があります

  • Genesys Architect および Genesys Cloud ポータルの正しい地域にアクセスできる、新規アカウントまたは既存の Genesys Cloud アカウントにログインします。
  • Genesys Cloud 組織での Admin 役割。 Genesys Cloud の役割と権限について詳しくは、 役割と権限の概要 を参照してください。

Genesys でのボット・コネクターのセットアップ

  1. Genesys 管理ページに移動します。

  2. 「統合 (Integrations)」「統合 (Integrations)」 をクリックします。

  3. 「統合 (Integrations)」ページで 「+ 統合 (+ Integrations)」 をクリックします。

  4. Genesys Bot Connector を検索し、 「インストール」 をクリックします。

  5. 「詳細」タブで、Bot Connector の名前とメモを入力します。

  6. 「統合 ID のコピー」 をクリックして保存します。 watsonx Assistant Genesys Bot Connector 統合を作成するには、 統合 ID が必要です。

  7. 「構成」タブの「プロパティー」で、プレースホルダー 「ボット・コネクター・ハンドル発話 URI (Bot Connector Handle Utterance URI)」 を入力します。 watsonx Assistant Genesys Bot Connector 統合の作成後に、この URI に戻って更新する必要があります。

  8. 「資格情報」タブで、 「構成」 を使用して、 「フィールド名」x-watson-genesys-verification-token とし、 watsonx Assistantで設定した秘密情報として Value を指定して、資格情報フィールドを作成します。 watsonx Assistant Genesys Bot Connector 統合を作成するには、この が必要です。 トークン および をコピーして保持し、 watsonx Assistantと統合するときにそれらを 「検証トークン」 フィールドに貼り付けることができるようにします。

    「保存」をクリックすると、これらの資格情報は再び表示されません。

  9. 「OK」をクリックして保存します。

Web ブラウザー・タブで Genesys Web ページを開いたままにして、セットアップの進行中にフィールドを参照して入力することができます。

Genesys との watsonx Assistant の統合

Bot コネクター統合の作成

  1. 左メニューの統合アイコン (Integrations icon)をクリックして、 watsonx Assistant 統合ページに移動します。

  2. 「Genesys ボット・コネクター (Genesys Bot Connector)」 タイルで 「追加」 をクリックします。

  3. 「確認」 をクリックします。

Genesys への watsonx Assistant の接続

  1. Genesys サイトから、Genesys OAuth 資格情報が必要です。

    OAuth 資格情報は、「統合」>「OAuth」の下の Genesys 管理ページにあります。 付与タイプが 「クライアント資格情報」 の資格情報と、 BotConnector 権限を持つ役割が必要です。

    以下の値をコピーして保持し、 Genesys Bot Connector 統合セットアップ・ページに貼り付けることができるようにします。

    • クライアント ID
    • クライアント・シークレット (Client Secret)
  2. watsonx Assistant Genesys Bot Connector 統合セットアップ・ページに戻り、 「次へ」 をクリックします。

  3. 必要事項を入力し、「 次へ 」をクリックします。

    • クライアント ID
    • クライアント・シークレット (Client Secret)
    • 検証トークン (Genesys Bot Connector セットアップからのトークンおよび値)
    • 統合 ID
    • API URI (お客様の地域の Genesys API サーバー、例えば: https://api.regionxyz.mypurecloud.com

セキュリティー上の理由から、認証フィールドは初期セットアップ後にビューから削除されます。

Genesys Bot コネクターの構成

  1. Webhook URI フィールドに生成された値をコピーします。

  2. 開いたままにしておいた「Genesys Bot コネクター構成 (Genesys Bot Connector Configuration)」タブに移動します。 「プロパティー」の下で、前に入力したプレースホルダー 「ボット・コネクター・ハンドル発話 URI (Bot Connector Handle Utterance URI)」 を、この 「Webhook URI」 値に置き換えます。

  3. 「完了 (Finish)」 をクリックします。

認証に必要なフィールドが変更された場合は、関連フィールドのすべての項目に入力し、再度検証する必要があります。

アシスタントとチャットする

アシスタントとチャットを開始するには、以下の手順を実行します。

  1. Genesys Architect を開き、 インバウンド・メッセージ・フローを作成します。
  2. ツールボックスで、 「ボット」 をクリックし、次に 「コール・ボット・コネクター」 をクリックします。
  3. 以下の値を選択します。
    • ボット統合:
    • ボット名: IBM watsonx Assistant Bot Connector
    • ボットのバージョン: 1.0
  4. watsonx Assistantとの間で受け渡しするセッション変数を入力します。 詳しくは、 セッション変数によるコンテキストの共有 を参照してください。
  5. Bot コネクターの出力は Success または Failure です。 「ボット・コネクターのインテント (Intent of the Bot Connector)」 の出力に従って、ボット・コネクターの終了時に Genesys フローを分岐させる必要があります。 詳しくは、 条件付けと出力のブランチ を参照してください。

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

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

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

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

入力パラメーターについては、 watsonx Assistant のセッション変数に以下のようにアクセスできる:

  • ダイアログの場合$integrations.genesys_bot_connector.user_id を使用してください。

  • アクション ${system_integrations.genesys_bot_connector.user_id} を使用する。

出力パラメータの場合、セッション変数をGenesysの状態変数に割り当てることができます(例えば、 State.some_variable )。フロー内で後からアクセスできます。

変数は、ダイアログ・スキルとアクション・スキルの両方から読み取ったり設定したりできます。

watsonx Assistant ボット・コネクターによるスロット・パラメーターの設定

watsonx Assistant ボット・コネクターは、会話の終了時に最後の会話ターンに基づいて以下の出力パラメーターを設定します。

パラメーター 説明
Intent watsonx Assistant は、成功インテントのスロット値として、ダイアログ・スキルによって認識されたインテントに設定されます。

条件付けと出力分岐

Genesys Architect からは、 Logical 関数を使用して、 watsonx Assistantから共有されているコンテキストに基づいてフローを分岐させることができます。 例えば、 watsonx Assistant は、 State.Intent に保存された Intent パラメーターを返します。

アーキテクトは、 Switch アクションを追加して、さまざまなシナリオに分岐させることができます。 例えば、 State.Intent == "connect_to_agent" というケースを構成してから、分岐することができます。

Genesys Bot Connector フローの終了

会話が Architect の Bot Connector ノードに到達すると、Genesys はユーザーと watsonx Assistantの間のメッセージをプロキシーし、会話が終了するまで続行します。 会話を Genesys に戻すには、 connect_to_agent 応答タイプまたは end_session 応答タイプを使用する必要があります。

{
  "output": {
    "generic": [
      {
        "response_type": "text",
        "values": [
          {
            "text": "You have ended the call."
          }
        ]
      },
      {
        "response_type": "end_session"
      }
    ]
  }
}
{
  "output": {
    "generic": [
      {
        "response_type": "text",
        "values": [
          {
            "text": "Connecting you to an agent."
          }
        ]
      },
      {
        "response_type": "connect_to_agent"
      }
    ]
  }
}

ユーザー定義の応答タイプ

user_defined 応答タイプを使用すると、カスタム応答を Genesys に戻すことができます。 例えば、これを使用して、 watsonx Assistant と同等の応答タイプを持たない Genesys に CardsCarousels を戻すことができます。 Genesys に Card を返送する例を以下に示します。

{
  "output": {
    "generic": [
      {
        "user_defined": {
          "replyMessages": [
            {
              "type": "Structured",
              "content": [
                {
                  "contentType": "Card",
                  "card": {
                    "title": "Card title",
                    "description": "Card description",
                    "image": "http://www.samplesite.com/photo/1234.jpg",
                    "actions": [
                      {
                        "type": "Link",
                        "text": "Link display text",
                        "url": "http://www.samplesite.com"
                      },
                      {
                        "type": "Postback",
                        "text": "Postback display text",
                        "payload": "Postback text"
                      }
                    ]
                  }
                }
              ]
            }
          ]
        },
        "response_type": "user_defined"
      }
    ]
  }
}

応答タイプ

これらの 応答タイプ はサポートされ、Genesys Bot Connector チャネル用にアシスタントを配置するときに予期されるとおりに表示されます。

  • connect_to_agent
  • end_session
  • オプション
  • テキスト
  • user_defined