配置CCE虛擬代理基於語音雲的聯結器

簡介

本文檔介紹如何配置基於聯絡中心企業(CCE)虛擬代理語音(VAV)雲的聯結器。

作者：Ramiro Amaya思科TAC工程師、Anjum Jeelani、Adithya Udupa和思科工程師Raghu Guvvala。

必要條件

需求

思科建議您瞭解以下主題：

• 思科整合客服中心企業版(UCCE)版本12.6.2
• 思科套裝客服中心企業版(PCCE)版本12.6.2
• 客戶語音入口網站(CVP)
• 虛擬語音瀏覽器(VVB)
• Google Dialogflow CX
• 控制中心

採用元件

本檔案中的資訊是根據以下軟體版本：

• PCCE版本12.6.2
• CVP 12.6.2
• 雲端連線12.6.2
• Google Dialogflow CX
• Webex Control Hub

本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除（預設）的組態來啟動。如果您的網路運作中，請確保您瞭解任何指令可能造成的影響。

背景

Virtual Agent-Voice (VAV)功能在CCE 12.5(1)版本中稱為客戶虛擬助理(CVA)，使互動式語音應答(IVR)平台能夠與基於雲的語音服務整合。

此功能支援類似人類的互動，使您能夠在IVR內快速高效地解決問題，從而減少定向到座席的呼叫。這可以幫助您首先與Virtual Agent互動，後者為您提供了自助服務解決方案，而無需使用物理Agent。

VVB使用以下聯結器之一來利用AI服務：

• 基於本地的聯結器：VVB使用本地聯結器連線到Google Dialogflow服務。此服務透過Cisco Unified Call Studio的Dialogflow ES或DialogflowCX元素啟用。VAV目前透過基於場所的聯結器支援Google Dialogflow ES和CX服務。

• 基於雲的聯結器：VVB使用基於雲的聯結器連線到Cisco CCAI服務。此服務透過Cisco Unified Call Studio的Virtual Agent Voice元素啟用。VAV目前透過基於雲的聯結器支援Google Dialogflow CX服務。

本文檔僅介紹基於雲的聯結器配置。

重要注意事項

透過基於雲的聯結器配置VAV之前，請考慮以下資訊：

• 支援的編解碼器為u-law。

• 語音活動檢測由Google完成。

• 必須在代理和防火牆中啟用埠443和HTTP/2。

• 您的網路中允許的清單必須包含下列URL：

  • U2C（埠443）：https://u2c-a.wbx2.com/u2c/api/v1/user/catalog -美國

  • U2C（埠443）：https://u2c-r.wbx2.com/u2c/api/v1/user/catalog -亞洲

  • U2C（埠443）：https://u2c-k.wbx2.com/u2c/api/v1/user/catalog -歐洲

  • Orchestrator （埠443）： https://insight-orchestrator.wxcc-us1.cisco.com

  • ID代理（埠443）：https://idbroker.webex.com

  • WS聯結器（埠443）：https://wsconnector.wxcc-us1.cisco.com和https://wsconnector.prod-us1.rtmsprod.net

• 您的網路中允許的清單也必須包含下列URL群組：

  • *.google.com

  • *.googleapis.com

  • *.gcr.io

  • *.cisco.com

  • *.wbx2.com

  • *.ciscoccservice.com

設定

以下是透過雲基聯結器配置VAV所需的步驟。

步驟1.交換自簽名證書或實施CA簽名證書。

步驟 2.配置代理伺服器。

步驟 3.建立Google專案。

步驟 4.與思科一起調配Google專案和雲組織。

步驟 5.建立並設計Dialogflow CX代理。

步驟 6.建立座席會話配置檔案。

步驟 7.在Webex Control Hub中配置CCAI。

- 雲端連線

- 聯結器

-功能

步驟 8.在UCCE和PCCE (SPOG)中配置CCAI。

步驟 9.建立和設計CVP Call Studio應用程式。

交換自簽名證書或實施CA簽名證書。

您需要實施CA簽名證書或交換與VAV for VAV功能相關的CCE元件才能正常工作。對於PCCE證書交換或CA簽名需要：AW、VVB和Cloud Connect。對於UCCE證書，AW、VVB、NOAMP和雲連線是必需的。有關UCCE Exchange證書：UCCE 12.6中的Exchange自簽名證書，有關CA簽名實施：在12.6中實施CA簽名證書，有關PCCE交換證書：在PCCE 12.6中交換自簽名證書，請參閱本文。

配置代理伺服器

如果您在VVB Speech Server (SS)和Webex CCAI服務之間沒有直接通訊，則需要代理伺服器。

要配置代理伺服器，請使用以下命令：

set speechserver httpsProxy Host

set speechserver httpsProxy port

set speechserver httpsProxy nonProxyHosts

set speechserver httpsProxy Host

此指令會設定語音伺服器的代理主機。如果需要的話，它也會要求認證。

命令語法：

set speechserver httpsProxy host <hostname/ip>

代理是否需要憑據？[Y/N] y
輸入使用者名稱：使用者名稱
輸入密碼：****

範例：

admin：set speechserver httpsProxy host abc.com
代理是否需要憑據？[Y/N] y
輸入使用者名稱：使用者名稱
輸入密碼：****
命令成功。

set speechserver httpsProxy port

此命令設定語音伺服器的代理埠。

命令語法：
set speechserver httpsProxy port <portNumber>

範例：
admin：set speechserver httpsProxy port 80

命令成功。

此命令為語音伺服器設定nonProxyHosts。流量不會透過代理主機到達這些主機。

set speechserver httpsProxy nonProxyHosts

命令語法：
set speechserver httpsProxy nonProxyHosts <parameter>

範例：
admin：set speechserver httpsProxy nonProxyHosts <用逗號分隔的nonProxyHosts清單>

命令成功。

引數可以是單一主機或以逗號分隔的多個主機

本文檔中的詳細資訊：VVB操作指南

注意：您必須停止並啟動Speech Server，才能反映值。
停止語音伺服器的語法：實用服務停止Cisco Speech Server
啟動語音伺服器的語法：實用服務啟動Cisco Speech Server

建立Google專案-提供專案與組織

Google AI和CCE的整合需要建立Google專案，此專案需要由思科提供。此外，需要為您或思科合作夥伴建立Cisco webex雲中的組織。本檔案說明建立及提供專案與組織所需的步驟。

使用CCE調配Google CCAI混合服務

建立Dialogflow CX代理

VAV目前透過基於雲的聯結器支援Google Dialogflow CX服務。

Dialogflow CX代理是一個虛擬代理，處理與終端使用者的併發會話。通話方塊流程可將通話期間的一般使用者文字或音訊轉換為應用程式與服務可以理解的結構化資料。您可以設計並建置Dialogflow代理程式，以處理系統所需的通話型別。有關Dialogflow CX的詳細資訊，您可以訪問：Dialogflow CX基礎知識。

以下是建立Dialogflow CX代理的步驟。

步驟 1.導航到https://dialogflow.cloud.google.com/cx/projects，使用建立專案時使用的Google帳戶登入，然後選擇專案。

步驟 2.選擇位置並按一下Create agent。

步驟 3.增加名稱，選擇時區和語言。點選建立。

步驟 4.代理建立後，您將在第一頁看到「預設啟動流」。

當您建立代理程式時，預設流程會自動在起始頁面中建立。若要在建立代理程式後變更預設設定，請選取代理程式設定。

在Speech and IVR部分，啟用語音適應、高級語音設定和強插。

如果您想要瞭解如何設定Dialogflow CX代理程式，請檢閱下列Google影片：

什麼是Dialogflow CX？

Dialogflow CX中的頁面和轉換簡介

建立單流通話代理

導入Dialogflow CX代理

您可以導入Dialogflow CX代理，而不是從頭開始構建代理。建立代理後，您可以導入以前建立和構建的Dialogflow CX代理。在本示例中，使用由Cisco工程團隊建立的Dialogflow CX代理。

步驟 1.在「座席」部分上，選擇檢視所有座席。

 步驟 2. 選擇您建立的代理，然後按一下Restore。

步驟 3.在Restore窗口中，按一下Upload，然後選擇下載檔案並按一下Restore。

現在，您會看到已導入的代理。

您可以從VAV Call Studio Application and Dialogflow CX Agent Sample下載Cisco Dialogflow CX代理示例(exported_agent_Travel_ flight information_VAV.blob)

建立Dialogflow CX代理-預構建的代理

在構建Dialogflow CX代理時，您可以使用Google預構建的代理模板來縮短設計時間。 

以下是使用預先建置代理程式的步驟。

步驟 1.在Dialogflow CX頁上，選擇專案，然後選擇使用預構建的代理。

步驟 2.選擇要使用的預建代理。本例中使用的是Travel： car rental代理。

步驟 3.按一下「Import」（匯入）。

步驟 4.選取位置。您會看到已建立新代理程式。

有關此Google影片的詳細資訊：使用預構建的代理模板建立Dialogflow CX代理

建立座席會話配置檔案

座席會話配置檔案是一組配置引數，用於定義與呼叫方會話中Dialogflow座席的行為。

以下是建立座席會話配置檔案的步驟。

步驟 1.登入Google Agent Assist。選擇Conversation profile（通話配置檔案）並選擇之前使用Dialogflow CX代理建立的專案。

步驟 2.按一下Create。

步驟 3.確保「座席助理URL」使用的位置與要建立會話配置檔案的座席位置相同。在本例中，您會看到URL位於位置全局中。

您以前建立的代理位於us-central1上，因此您必須替換位置才能繼續。

步驟 4.增加名稱和語言。

步驟 5.向下滾動並選擇Enable Virtual agent ，然後選擇Dialogflow CX agent。

現在已為座席建立通話配置檔案。

在Webex Control Hub中配置CCAI

步驟 1.確保已安裝Cloud Connect發佈伺服器和訂閱伺服器。有關詳細資訊，請參閱思科統一聯絡中心企業版安裝和升級指南12.6.2中的安裝雲連線部分.

步驟 2.登入到Webex Control Hub(admin.webex.com)。導航到聯絡中心並按一下Cloud Connect。

步驟 3.在Cloud Connect窗口中，輸入主雲連線和時鐘註冊的名稱和完全限定域名(FQDN)。

注意：在Webex Control Hub中增加雲連線時，請確保可以從打開Control Hub的PC訪問雲連線FQDN。

步驟 4.選擇Allow access to the Cloud Connect node，並按一下Continue。

您會看到Cloud Connect註冊已完成。

步驟 5.新增聯結器。在聯絡中心窗口上，依次選擇整合和聯結器頁籤。

步驟 6.如果已經新增聯結器，而您又需要新增一個聯結器，請按一下「新增更多」。使用Google登入並繼續執行指示。

注意：您使用Google登入的使用者帳戶必須具有Google專案的擁有者角色。 

步驟 7.提供Google專案、Cisco專案以及思科在提供Google專案時提供的Google服務帳戶。按一下Save。

步驟 8.現在新增功能。在Contact Center頁上，按一下Integrations和Features，然後按一下New。

步驟 9.您現在位於「建立新聯絡中心功能」頁面。 按一下「新增」。客服中心AI配置。

步驟 10.您現在位於「聯絡中心功能」頁面。 按一下Contact Center AI Config。

步驟 11.提供功能資訊，選擇已增加的聯結器並建立Google代理通話配置檔案。

在UCCE和PCCE (SPOG)中配置CCAI

PCCE配置

步驟 1.在CCE AW上，打開Unified CCE Administration tool並導航到Inventory。

步驟 2.向下滾動並按一下外部電腦。

步驟 3.選擇Cloud Connect Publisher並提供完全限定域名(FQDN)、使用者名稱和密碼。

Cloud Connect已增加並同步。

注意：請確保您以前在CCE元件之間交換過證書，或者實施了CA簽名的證書。有關PCCE證書交換和實施，請參閱以下文檔：在PCCE 12.6中交換自簽名證書和在12.6中實施CA簽名證書。

步驟 4.驗證預設組態。檢視預設CCAI配置（作為Webex Control Hub中的CCAI配置的一部分建立）。如果需要，請在CCE Admin中同步配置(使用Sync選項)。

步驟4a.在CCE Admin上，導航到功能卡，然後選擇Contact Center AI。

步驟4b.選擇思科計費AI服務

步驟4c.您將看到虛擬代理的預設配置。

UCCE配置

步驟 1.在CCE AW上，打開Unified CCE Administration tool並導航到Inventory。按一下「新增」。

步驟 2.增加雲連線並提供FQDN和憑證。

注意：請確保您以前在CCE元件之間交換過證書，或者實施了CA簽名的證書。有關UCCE證書交換和實施：UCCE 12.6中的Exchange自簽名證書，以及實施：在12.6中實施CA簽名證書，請參閱以下文檔。

步驟 3.在CVP操作控制檯(OAMP)中配置雲連線。有關詳細資訊，請參閱Cisco統一客戶語音門戶管理指南中的配置雲連線的CVP裝置部分。

步驟 4.驗證Google CCAI預設配置。檢視預設CCAI配置（作為Webex Control Hub中CCAI配置的一部分建立）。如果需要，請在CVP操作控制檯（適用於Cisco Unified CCE的NOAMP）中同步配置(使用Sync選項)。

步驟4a.在CCE Admin上，導航到功能卡，然後選擇Contact Center AI。

步驟4b.選擇思科計費的人工智慧服務。

步驟4c.您將看到虛擬代理的預設配置。

CVP配置

步驟 1.在CVP Call Studio上，打開Call Studio應用程式。您可以使用Cisco sample call studio應用程式在實驗室環境中進行測試。您可以從此處下載：Call Studio VAV Sample Application。

步驟 2.按一下Virtual Agent Voice元素，然後選擇settings頁籤以打開元素設定。

步驟 3.在配置ID上，從您建立的Webex Control Hub CCAI功能複製ID。如果您已在Webex Control Hub功能配置中選擇了預設虛擬代理，請將其留空。

步驟 4.在之前將Dialogflow CX與思科聯絡中心整合時，您需要建立一個歡迎活動。如果使用內部聯結器，CCE 12.6.2版本中仍需要此功能。但是，對於基於雲的聯結器，您可以選擇指定自己的事件和傳遞到Google Dialogflow的引數。按一下「事件名稱」，然後指定要傳遞至Google Dialogflow的事件名稱。確保在Dialogflow CX代理中建立此事件。

在此範例中，事件名稱會以先前元素中定義的區域變數傳遞。

變數是在set variable事件中定義的。

Dialogflow CX Agent中的事件。

步驟 5.在「事件資料」上，增加要與「事件名稱」一起傳遞到Google Dialogflow CX的引數。 按一下...打開「事件資料」欄位。在本示例中，傳遞了三個變數：「名稱」、「位置」和「json」型別欄位值。

步驟 6.SIP報頭限制允許您過濾從SIP消息傳送到Google Dialogflow CX代理的資訊。這是為了防止個人或關鍵資訊透過雲傳遞。

步驟 7.為了改善自動語音辨識(ASR)、文本到語音轉換(TTS)和自然語言理解(NLU)與Google Dialogflow的互動，已增加了一組VXML引數。

辨識模型

這用於指定機器學習模型，用於雲端語音到文本轉錄以改善辨識結果。

您可以在以下檔案中找到更多資訊：

增強型型號

選擇增強型號

辨識模型變體

包含模型變體名稱.StringRecognize.modelVariant。例如，支援將這四個值做為模型。

· USE_STANDARD
· SPEECH_MODEL_VARIANT_UNSPECIFIED
· 使用_增強
· USE_BEST_AVAILABLE（預設）

綜合語調性別

設定「合成」作業的性別型別。

合成語音名稱

設定合成作業的語音名稱。幫助選擇必須播放提示的聲音和輔色。

下面是Google支援的語音和語言：Google語音和語言支援。

在Dialogflow CX中配置部分響應

當webhook響應在後台處理請求時，部分響應功能播放臨時消息並接洽呼叫方。Dialogflow CX中的Webhook請求通常需要更長的時間才能收到響應。如果Webhook響應正在處理請求時沒有臨時響應呼叫方，則呼叫方將保持完全靜音，並可能掛斷電話。要避免這種情況，請使用部分響應來通知呼叫方，他們的請求仍在處理中。

• 如果Webhook在部分響應之前或期間返回實際響應，則系統會停止部分響應，並向呼叫方播放最終響應。
• 從Dialogflow CX代理收到的第一個提示響應不支援部分響應。
• 無法為部分響應提示啟用強插，以允許呼叫方中斷代理響應。

注意：在Google Dialogflow CX代理上配置了部分響應。只有12.6(2) VVB基礎版本的ES1提供此支援。有關詳細資訊，請參閱此文檔：Google部分響應

有關部分響應的詳細資訊，您可以檢視以下文檔：https://help.webex.com/en-us/article/nzlot2u/Configure-Partial-Response-in-Dialogflow-CX

驗證

目前沒有適用於此組態的驗證程序。

疑難排解

目前沒有適用於此組態的疑難排解程式。

相關資訊

• UCCE功能指南12.6.2
• UCCE 12.6中的Exchange自簽名證書 
• 在12.6中實施CA簽名的證書
• 在PCCE 12.6中交換自簽名證書
• 使用CCE調配Google CCAI混合服務
• Google - Dialogflow CX簡介
• Google -使用預構建的代理模板建立Dialogflow CX代理
• Google - Dialogflow CX中的頁面和轉換簡介
• Google -建立單流通話代理
• Cisco Unified Contact Center Enterprise安裝和升級指南12.6.2
• Call Studio VAV示例應用程式
• VXML元素規格指南
• 增強型型號
• 選擇增強型號
• Google語音和語言支援
• 技術支援與文件 - Cisco Systems