開始之前

在開始將您的助理與 Genesys Bot Connector 整合之前，您必須遵守下列要求：

• 新帳戶或登入現有的 Genesys Cloud 帳戶，以存取 Genesys Cloud 入口網站中的 Genesys Architect 及正確區域。
• Genesys Cloud 組織中的 Admin 角色。 如需 Genesys Cloud 角色和許可權的相關資訊，請參閱 角色和許可權概觀。

在 Genesys 中設定 Bot 連接器

1. 移至 Genesys 管理頁面。

2. 在 整合下，按一下 整合。

3. 在「整合」頁面上，按一下 + 整合。

4. 搜尋 Genesys Bot 連接器，然後按一下 安裝。

5. 在「詳細資料」標籤中，輸入「機器人連接器」的名稱及任何附註。

6. 按一下 複製整合 ID，然後儲存。 您需要 整合 ID 才能建立 watsonx Assistant Genesys Bot Connector 整合。

7. 在「配置」標籤的「內容」下，輸入位置保留元 Bot Connector Handle Utterance URI。 您需要在建立 watsonx Assistant Genesys Bot Connector 整合之後返回並更新此 URI。

8. 在「認證」標籤中，使用 配置 來建立認證欄位，其 欄位名稱 為 x-watson-genesys-verification-token，並使用 值 作為您在 watsonx Assistant中設定的密碼。 您需要此 值 才能建立 watsonx Assistant Genesys Bot Connector 整合。 複製並保留 記號 和 值，以便在與 watsonx Assistant整合時，您可以將它們貼到 驗證記號 欄位中。

   按一下「儲存」之後，您無法再次看到這些認證。

9. 按一下確定並儲存。

在 Web 瀏覽器標籤中保持開啟 Genesys 網頁，以便您可以在設定進行時參照並完成欄位。

整合 watsonx Assistant 與 Genesys

與助理會談

若要開始與助理進行會談，請完成下列步驟：

1. 開啟 Genesys Architect，並建立 入埠訊息流程。
2. 在「工具箱」中，按一下 機器人，然後按一下 呼叫機器人連接器。
3. 選取值:
   • 機器人整合:
   • 機器人名稱: IBM watsonx Assistant 機器人連接器
   • 機器人版本: 1.0
4. 輸入您要在 watsonx Assistant中傳遞的階段作業變數。 如需相關資訊，請參閱 透過階段作業變數進行環境定義共用。
5. Bot 連接器的輸出為 Success 或 Failure。 結束「機器人連接器」時，您應該根據輸出 機器人連接器的目的來建立 Genesys 流程的分支。 如需相關資訊，請參閱 條件及輸出分支。

透過階段作業變數來共用環境定義

從 Genesys Architect 流程中的「機器人連接器」節點，您可以指定可用來將資訊傳遞至 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}。

對於 Output 參數，您可以將會話變數指定給 Genesys 中的狀態變數 (例如，State.some_variable，並在稍後的流程中存取它們)。

可以從「對話」及「動作」技能讀取及設定變數。

透過 watsonx Assistant 機器人連接器設定插槽參數

watsonx Assistant Bot Connector 會根據交談結束時的最後一回交談來設定下列輸出參數。

續電和輸出分支

從 Genesys Architect 中，您可以使用 Logical 函數，根據從 watsonx Assistant共用回來的環境定義來展開流程。 例如，watsonx Assistant 會傳回儲存至 State.Intent 的 Intent 參數。

在架構設計師中，您可以新增 Switch 動作，以分支出至不同的實務範例。 例如，您可以配置 State.Intent == "connect_to_agent" 的案例，然後分支出。

結束 Genesys Bot 連接器流程

當交談到達 Architect 中的「機器人連接器」節點時，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。 例如，這可用來將 Cards 和 Carousels 傳回給沒有 watsonx Assistant 對等回應類型的 Genesys。 將 Card 傳回給 Genesys 的範例如下:

{
  "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_too_agent
• 結束會談
• 選項
• 文字
• 使用者定義