與 Genesys Audio Connector 整合

IBM Cloud

您可以整合 Genesys Audio Connector 與助理，以串流助理與 Genesys Cloud 之間的交談音訊。

開始之前

在開始整合助理與 Genesys Audio Connector 之前，您必須具有下列必要條件:

新帳戶或登入現有的 Genesys Cloud 帳戶，以存取 Genesys Cloud 入口網站中的 Genesys Architect 及正確區域。
Genesys Cloud 組織中的 Admin 角色。

有關 Genesys Cloud 角色和權限的更多信息，請參閱角色和權限概述。

在助理中建立音訊連接器整合

點擊左側選單中的整合，前往整合頁面。

儲存認證，因為您在按一下儲存之後無法看到它們。您需要這些認證，才能設定「Genesys 音訊連接器」。

按一下電話磚上的新增。
按一下 Genesys 音訊連接器 磚。
在認證區段中，複製並儲存下列欄位中自動產生的認證:
- API 金鑰
- 用戶端密鑰
- Genesys 音訊連接 URI
- 機器人連接器 ID
按一下儲存並結束。

設定音訊連接器以整合助理

若要設定 Genesys Audio Connector，請完成 Genesys Cloud 文件中在 Genesys Cloud 中設定和啟動 Audio Connector 主題中的步驟。

在 Genesys 管理頁面中，前往整合 > 設定以新增您在 Assistant 中建立音訊連接器整合時複製的 Genesys 音訊連接 URI 值。

在 Genesys 管理頁面中，前往整合 > 憑證，新增您在助理中建立音訊連接器整合時複製的 API 金鑰和用戶端金鑰欄位的憑證。

通話流程

使用 Genesys 中的 呼叫音訊連接器 動作來啟動助理中的音訊連接器整合。

如需相關資訊，請參閱呼叫音訊連接器動作。

從 「憑證」 部分取得 Genesys 音訊連接 URI 後，請執行下列操作：

移至 Genesys 管理頁面。
在 Architect 下，按一下 Architect，並建立 入埠呼叫流程。
在「工具箱」中，按一下 機器人，然後按一下 呼叫音訊連接器。
輸入 Call Flow 的名稱。
從整合下拉功能表中選擇音訊連接器整合。
您必須複製認證區段中儲存的 機器人連接器 ID 欄位，並將它貼至 連接器 ID 欄位。<instance-id>/connect?version=<api-version>
輸入您要傳遞至 watsonx Assistant以及從其傳遞至 watsonx Assistant 的階段作業變數。如需相關資訊，請參閱透過階段作業變數進行環境定義共用。
按一下「流程圖」底端，以建立「終止動作」。例如，Disconnect。
按一下「儲存並發佈」。

呼叫路由

建立呼叫遞送，以將送入呼叫導向至 Genesys 呼叫流程。

移至 Genesys 管理頁面。
移至 呼叫遞送，以建立呼叫遞送。
輸入通話遞送的名稱。
選擇分區。
從 遞送至 下拉功能表中選擇您在前一個步驟中配置的呼叫流程。
在通話流程中，指派您要將通話遞送至的電話號碼。
按一下建立。

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

從 Genesys Architect 流程中的「音訊連接器」節點，您可以指定可用來將資訊傳遞至 watsonx Assistant的階段作業變數。您可以同時指定「輸入」和「輸出」參數。為了集成，這兩個參數都被合併到 context 目的。

輸入及輸出參數都在 watsonx Assistant context 中可用，且每一次都會共用資訊。例如，context 在 watsonx Assistant 中提供的是：

{
  "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.genesys_audio_connector.some_variable}等表達式，您可以稍後在流程中存取該表達式。

執行以下步驟來設定輸出變數：

轉到要定義變數的操作步驟。
點擊設定新變數並選擇表達式。
輸入以下表達式：${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 音訊連接器流程

從使用者接收音訊交談之後，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
使用者定義的
連接到代理
映像檔
音訊