Google Dialogflow CX integreren

Vereisten

Om Google Dialogflow CX virtuele agentenGesloten Een softwareapplicatie die klantinteracties afhandelt in plaats van een live (menselijke) agent. met CXone Mpower te gebruiken, hebt u het volgende nodig:

  • Een Google Cloud-platformaccount.

  • Een Google Dialogflow CX virtuele agent die geconfigureerd en getraind is om de aanvragen van contacten te beantwoorden. De naam van de virtuele agent uit de instellingen voor de virtuele agent in de Google Dialogflow CX-console, om de integratie in CXone Mpower te voltooien.

Alpha Visibility in Google

Alpha Visibility is een Google-programma dat Google Cloud-projecten toegang biedt tot functies die anders niet beschikbaar zouden zijn. Alpha Visibility is niet vereist voor gebruik van Dialogflow CX met CXone Mpower. Er zijn echter enkele gevallen waarin u alfazichtbaarheid moet inschakelen. Alfazichtbaarheid is vereist als u het volgende wilt:

  • Om de laatste gebruikersuiting van de Dialogflow virtuele agent te laten retourneren, samen met de intentie-informatie. U kunt deze informatie terugvinden in een script. Als de lastUserUtterance-variabele leeg is terwijl er gegevens in moeten staan, dan is Alpha Visibility mogelijk niet ingeschakeld voor uw project. Als u deze informatie nodig hebt, moet voor uw Google Cloud-project alfazichtbaarheid zijn ingeschakeld.

  • Om de huidige pagina te laten retourneren als onderdeel van de aangepaste payload van het antwoord.

  • Om het transcriptieveld Dialogflow te laten retourneren als onderdeel van de responspayload.

Een script aanmaken

Vereiste machtigingen: Studioscript weergeven, maken/bewerken

U hebt minimaal één Studio script nodig om interacties naar uw virtuele agent te routeren. Volg de scriptrichtlijnen. Uw script moet beschikken over het telefoonmediatypeGesloten Een kanaal zoals spraak, e-mail of chat, waarmee een klant communiceert met een beoogde ontvanger. voor een spraakgebaseerde virtuele agent of het digitale mediatype voor een tekstgebaseerde virtuele agent. De ondersteunde virtuele-agentacties voor deze provider zijn:

Als u een virtuele spraakagent instelt en een CXone Mpower Cloud TTS Hub-service gebruikt, neemt u de CLOUD TTS actie op in uw script.

Raadpleeg de secties Basiselementen en Technische referentiegids in de online Help voor meer informatie over Studio-scripts.

Best practices voor aangepaste payloads

Volg de onderstaande best practices bij het integreren van aangepaste payload-gegevens van Google Dialogflow CX in CXone Mpower:

  • Dialogflow CX gebruikt geen contexten om gegevens door te geven aan Dialogflow-intentiesGesloten De betekenis of het doel achter hetgeen een contact zegt of typt; datgene wat de klant wil communiceren of bereiken.., in tegenstelling tot Dialogflow ES.
  • U kunt aangepaste gegevens aan Dialogflow CX doorgeven met behulp van JSON sleutel/waarde-paren. Maak een dynamisch customPayload-object in een Snippet-action in uw script en voeg daar de sleutel/waardeparen aan toe. Bijvoorbeeld:

    DYNAMIC customPayload
    customPayload.ani = ani
    customPayload.contactID = contactId
    customPayload.masterContactId = masterId
    customPayloadJSON = "{customPayload.asJSON()}"	
  • Configureer in de actie Exchange in uw script de eigenschap customPayload met een variabele die de functie asJSON() in zijn waarde heeft. U vindt deze waarde in het customPayload-object.
  • Geef de customPayload-JSON door aan de virtuele agent via de Payload-eigenschap van QueryParameters. Zie de Google-documentatie over QueryParameters Een vierkant met een pijl die uit het midden naar de rechterbovenhoek wijst. voor Google Dialogflow CX.
  • Gegevens die via QueryParameters worden doorgegeven, worden ontvangen door een Webhook in Dialogflow CX. U kunt in de Dialogflow CX-console code schrijven om de doorgegeven gegevens te verwerken.
  • Nest geen objecten binnen het customPayload-object. Geneste objecten worden verzonden als letterlijke strings.
  • Om aangepaste gegevens van uw virtuele Dialogflow CX-agent te retourneren naar het script, gebruikt u het veld Aangepaste payload in de Dialogflow CX-console. Zorg dat u zich bevindt in de console voor de virtuele agent die u gebruikt met CXone Mpower. Koppel dit aan uw script met behulp van de variabele customPayloadVarName (out) in de actie VOICEBOT EXCHANGE  of TEXTBOT EXCHANGE Studio in uw script. U kunt dit bijvoorbeeld gebruiken om het gedrag van de volgende prompt in te stellen.
  • Als u aangepaste gegevens vanuit het script naar Dialogflow CX wilt doorgeven, gebruikt u session_params in het customPayload-object in een Snippet-actie. Bijvoorbeeld:

    DYNAMIC customPayload
    customPayload.session_params.name = "Winnie le Pooh" 
    customPayload.session_params.job = "Food critic" 
    customPayload.session_params.location = "Hundred Acre Wood"	

    U krijgt toegang tot de sessieparameters in de Dialogflow CX-agentintentie met behulp van de volgende syntax:

    $session.params.name = Winnie Le Pooh
    $session.params.job = Food critic
    $session.params.location = 100 Acre Wood
                    

    Sessieparameters worden alleen gebruikt met virtuele Dialogflow CX-agents. U gebruikt contexten om een vergelijkbaar resultaat te bereiken met Dialogflow ES.

  • Configureer hints voor spraakcontext en een aangepaste gespreks-IDom het gesprek over te dragen naar een andere Dialogflow virtuele CX-agent in het aangepaste payload-fragment.

  • Als u VOICEBOT EXCHANGE gebruikt: Voeg de parametermaxPostEnergySilenceMS toe aan de Next Prompt Behaviors-actie Default Next Prompt Behaviors of Snippet om te bepalen hoelang de virtuele agent moet wachten wanneer het contact stil is tijdens het gesprek.

Een app toevoegen aan Virtual Agent Hub

Vereiste machtigingen: Automatisering & AI > Automatisering & AI starten

Door een configuratie-app aan Virtual Agent Hub toe te voegen, wordt de verbinding tot stand gebracht tussen CXone Mpower en uw virtuele agentprovider.

  1. Klik in CXone Mpower op de app-kiezer en selecteerOverige > Automatisering & AI en klik daarna op Virtual Agent Hub. U kunt ook dubbelklikken op de virtuele-agentactie die u in uw Studio-script gebruikt om Virtual Agent Hub te starten.
  2. Klik op Bot toevoegen.
  3. Voer een Naam van virtuele agent (bot) in en klik op Dialogflow CX in de lijst met aanbieders van virtuele agenten.

  4. Klik op Volgende.

  5. Vul de velden in het configuratieformulier in en klik op Volgende. Details over dit formulier vindt u in de sectie Details configuratiepagina op deze pagina.

  6. Klik op Volgende.

  7. Als u een tekstgebaseerde virtuele agent configureert, selecteer dan Alleen tekstgebaseerd (geen spraakondersteuning) op de pagina Spraak. Als u een spraakgebaseerde virtuele agent configureert, raadpleeg dan de sectie Spraakintegratieopties configureren op deze pagina.

  8. Ga naar de pagina Transcriptie en stel in of u de transcriptie van het gesprek en de intentiegegevens wilt vastleggen. Als dit tabblad niet beschikbaar is, is de functie niet ingeschakeld voor uw tenantGesloten Een organisatorische eenheid op hoog niveau die wordt gebruikt om technische ondersteuning, facturering en globale instellingen voor uw CXone Mpower-systeem te beheren.. Neem contact op met uw Accountmanager voor meer informatie over deze functie. Deze optie is alleen beschikbaar voor tekstgebaseerde virtuele agents en uitingsgebaseerde virtuele agents.

  9. Klik op Volgende.

  10. Op de pagina Testen en toevoegen kunt u de verbinding van de bot testen door audio- of tekstprompts te sturen. Als uw testberichten niet werken, klikt u op Terug om terug te keren naar de configuratiepagina en de instellingen te controleren.

  11. Klik op Toevoegen.

Configuratiepagina voor Google Dialogflow CX

Gebruik de informatie in de volgende tabel bij het voltooien van de Configuratiepagina. U ziet deze pagina wanneer u een app toevoegt in Virtual Agent Hub

Veld

Details

Integratieversie

Selecteer de versie van de Virtual Agent Hub die u wilt gebruiken. Met deze optie kunt u een eerdere versie van Virtual Agent Hub gebruiken totdat u klaar bent om over te schakelen naar een nieuw uitgebrachte versie. De beschikbare versies zijn:

  • Versie 1.0.0Dit is de eerste versie van Virtual Agent Hub. Het aangepaste payloadobject retourneert als customPayload.payload.xxxx.
  • Versie 2.0.0Deze versie heeft de schema's bijgewerkt die gebruikt worden met Google Dialogflow CX. Dit beïnvloedt de structuur van het customPayload-object.
  • Versie 3.0.0: deze versie introduceerde StandardBot, die standaardiseert hoe CXone Mpower communiceert met virtuele-agentproviders. Het customPayload-object retourneert als een array, als customPayloadscriptPayloads[n].xxxx. Deze versie is beschikbaar voor alle providers.
SIP geconfigureerd Schakel deze optie niet in. CXone Mpower ondersteunt geen SIP-backchannelconfiguratie met Google Dialogflow CX.
JSON-serviceaccount

Het sleutelbestand voor de serviceaccount, dat u hebt gemaakt en gedownload vanuit uw Google Cloud Console. Kopieer en plak de volledige inhoud van het sleutelbestand in dit veld, inclusief de accolades die om de sleutel staan. Dit veld is alleen zichtbaar als u uw eigen Google Dialogflow CX-account gebruikt. Als het veld niet zichtbaar is terwijl dat wel zou moeten, vraag dan uw CXone Mpower Accountmanager om de instellingen van uw systeem te controleren.

De serviceaccountsleutel is een JSON-object dat vergelijkbaar is met het onderstaande voorbeeld.

{

"type": "service_account",
"project_id": "ic-demo2-aai-gcp",
"private_key_id": "sdv80sdf08ssd9sdf0sdf8sdfsdf90sdf8",
"private_key": "-----BEGIN PRIVATE KEY-----
nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCzgrS8vp
<private key has been truncated for this example>
----END PRIVATE KEY-----\n",
"client_email": "your@client_email-gcp.iam.gserviceaccount.com",
"client_id": "123456789",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/dialogflow-dthjop%40ic-demo2-aai-gcp.iam.gserviceaccount.com"
}

De JSON-serviceaccount moet de Dialogflow API Admin-rol Een vierkant met een pijl die uit het midden naar de rechterbovenhoek wijst. hebben.

Taal

De taal die deze virtuele agent moet gebruiken. Dit is de taal die de virtuele agent begrijpt. Dit is een verplicht veld.

Regio De regio waar de Google Dialogflow CX virtuele agent is gehost die u toevoegt aan Virtual Agent Hub. Dit is een verplicht veld.
Agent De naam van de Google Dialogflow CX virtuele agent die u wilt toevoegen aan Virtual Agent Hub. U vindt de naam in de Dialogflow CX-console van de virtuele agent. Klik op Naam kopiëren om de naam naar het klembord te kopiëren. Dit is een verplicht veld.
Environment Voer de GUID in van de omgeving die deze Dialogflow-app moet gebruiken. In Dialogflow CX worden verschillende versies van dezelfde virtuele agent 'omgevingen' genoemd. U vindt de GUID voor uw omgevingen in de agentinstellingen in de Google Dialogflow CX Console.
TTS-uitvoer inschakelen

Stel de schuifregelaar in op Aan als u de tekst-naar-spraak-service (TTSGesloten Hiermee kunt u teksten invoeren en door een computerstem laten uitspreken.) van Google Dialogflow CX wilt gebruiken. Configureer de TTS (tekst-naar-spraak)-opties voor Google.

Als u de Google Dialogflow CX TTS (tekst-naar-spraak)-service niet wilt gebruiken, laat u dit veld op Uit staan. U kunt een CXone MpowerCloud TTS Hub service gebruiken.

Schakel deze optie uit als dit een tekstgebaseerde virtuele agent is.

Timeout-eventhandler De naam van de Google Dialogflow CX-gebeurtenis die u wilt triggeren bij een timeout.
DTMF-uitbraakpatroon Als de gespecificeerde tekens worden ingedrukt slaat het script alles over en gaat het direct door naar de OnDTMFBreakout -vertakking.
Sentimentanalyse uitvoeren

Zet de schuifregelaar op Aan als u de resultaten van de sentimentanalyse van Google wilt ontvangen. Voor deze optie is het vereist dat u deze optie in uw Google Cloud-project hebt ingeschakeld. U bent verantwoordelijk voor het configureren van hoe de sentimentanalysegegevens worden gebruikt met uw virtuele agent.

Time-out externe provider

Voer het aantal seconden in dat het script moet wachten op een reactie van Dialogflow CX. Wanneer de time-out wordt bereikt, neemt het script weer controle over en volgt de foutvertakking.

TTS (tekst-naar-spraak)-uitvoer van Google Dialogflow CX configureren

Vereiste machtigingen: Automatisering & AI > Automatisering & AI starten

Voltooi de stappen in deze sectie als u de TTS (tekst-naar-spraak)-service van Google wilt gebruiken. Als u de optie TTS-uitvoer inschakelen inschakelt op de pagina Dialogflow CX-configuratie in Virtual Agent Hub, worden de volgende velden in onderstaande afbeelding weergegeven op de configuratiepagina.

  1. Voeg in Virtual Agent Hub een nieuwe configuratie-app toe en configureer deze volgens de stappen in de sectie Een app toevoegen aan Virtual Agent Hub op deze pagina.
  2. Schakel TTS-uitvoer inschakelen in.
  3. Als u een aangepast spraakmodel wilt gebruiken, schakelt u Aangepaste stem gebruiken in en voert u de naam van het AutoML-model dat u wilt gebruiken in in het veld Aangepast spraakmodel.

  4. Selecteer de naam van de TTS (tekst-naar-spraak)-stem in de vervolgkeuzelijst Naam TTS-stem als u een Google-spraakmodel wilt gebruiken.

  5. Selecteer het machine learning Model en de Modelvariant die de Google TTS (tekst-naar-spraak)-services moeten gebruiken om spraak samen te stellen.

  6. Voer het aantal milliseconden stilte in het veld Aanloopstilte toevoegen in om een stilte toe te voegen aan de audioreactie van de virtuele agent. De aanbevolen lengte van de stilte is 500 milliseconden.

  7. Voer de Spraaksnelheid, Toonhoogte, en Volumeversterking in om te configureren hoe u de TTS (tekst-naar-spraak)-stem wilt laten klinken.

  8. Ga terug naar de sectie Een app toevoegen aan Virtual Agent Hub  op deze pagina om het toevoegen van de configuratie-app te voltooien.

Spraakintegratieopties configureren

Vereiste machtigingen: Automatisering & AI > Automatisering & AI starten

Als u een tekstgebaseerde virtuele agent configureert, kunt u deze sectie overslaan.

  1. Voeg in Virtual Agent Hub een nieuwe configuratie-app toe en configureer deze volgens de stappen in de sectie Een app toevoegen aan Virtual Agent Hub op deze pagina.
  2. Klik op Volgende op de configuratiepagina.

  3. Selecteer op de pagina Stem onder Opties voor stemintegratie de optie Turn-by-turn-besturing (CXone Voicebot Gateway).
  4. Selecteer onder Transcriptieopties de optie voor de transcriptieservice die u wilt gebruiken.

  5. Als u ervoor kiest om een Turn-by-Turn Transcription-profiel te gebruiken, klikt u op Turn-by-Turn TranscriptionProfiel om het gewenste profiel te selecteren. Klik op Nieuw Turn by Turn transcriptieprofiel toevoegen om een nieuw profiel te maken.
  6. Ga naar de transcriptie-opties en selecteer een Transcriptieprofiel of klik op Nieuw Turn by Turn transcriptieprofiel toevoegen om een nieuw profiel te maken.
  7. Klik op Volgende.
  8. Ga terug naar de sectie Een app toevoegen aan Virtual Agent Hub  op deze pagina om het toevoegen van de configuratie-app te voltooien.

De Google Dialogflow CX-app aan een actie toewijzen

Vereiste machtigingen: Studioscript weergeven, maken/bewerken

Wanneer de virtuele agentGesloten De betekenis of het doel achter hetgeen een contact zegt of typt; datgene wat de klant wil communiceren of bereiken..-app is ingesteld en geconfigureerd in Virtual Agent Hub, moet u deze toewijzen aan de virtuele agentactie in uw script. Dit verbindt de actie en het script met uw virtuele-agentprovider.

  1. Open in Studio het script dat u wilt bewerken.
  2. Als u dit nog niet hebt gedaan, klikt u op het tabblad Tools, vouwt u de categorie Automatisering en AI uit en voegt u de virtuele agent-actie toe die u wilt gebruiken. Let erop dat u de actie op de juiste plek in uw script zet. Als u de gewenste actie niet ziet, controleert u of het scriptmediatype klopt. Als u bijvoorbeeld een script maakt voor een spraakgebaseerde virtuele agent, moet ook het telefoonscript gebruiken.

  3. Dubbelklik op de actie om Virtual Agent Hub te openen.

  4. Zoek in de linkerkolom de virtuele agent die u wilt toewijzen aan de actie en klik op het vinkje Pictogram van een cirkel met een vinkje. dat ernaast staat.

    Een alternatief voor het gebruik van het vinkje is om een variabele te maken in uw Studio script. Gebruik de variabele om de naam van de virtuele agent-app door te geven aan de eigenschap Virtuele agent-ID van de actie Virtual Agent Hub die u gebruikt.

  5. Klik op Sluiten.

Het transcriptieprofiel wijzigen

Vereiste machtigingen: Automatisering & AI > Automatisering & AI starten

Met een transcriptieprofiel kunt u een andere transcriptieservice gebruiken dan de service die de virtuele-agentprovider aanbiedt. Elke virtuele agent kan maar één transcriptieprofiel hebben. U hoeft de stappen in deze sectie alleen uit te voeren als u met een spraakgebaseerde virtuele agent werkt en het transcriptieprofiel moet wijzigen.

  1. Klik in CXone Mpower op de app-kiezer en selecteerOverige > Automatisering & AI en klik daarna op Virtual Agent Hub. U kunt ook dubbelklikken op de virtuele-agentactie die u in uw Studio-script gebruikt om Virtual Agent Hub te starten.
  2. Ga naar de lijst met configuratie-apps voor virtuele agents links van de Virtual Agent Hub-pagina en klik op degene die u wilt wijzigen.
  3. Ga naar het midden van de pagina Eigenschappen voor de virtuele-agentapp en klik op het tabblad Spraak.
  4. Selecteer onder Transcriptie-opties de optie Gebruik Turn-by-Turn Transcription Profiel als deze nog niet is geselecteerd.

  5. Selecteer het Turn by Turn-transcriptieprofiel dat deze virtuele-agentintegratie moet gebruiken. Als de gewenste optie er niet is, kunt u deze toevoegen.

  6. Klik op Opslaan.
  7. Test uw transcriptieservice met de microfoonoptie in de sectie Test op de pagina Eigenschappen van uw virtuele-agentapp.

De virtuele agent testen

Vereiste machtigingen: Automatisering & AI > Automatisering & AI starten

U kunt veel aspecten van uw virtuele agent testen om er zeker van te zijn dat alles werkt zoals bedoeld. U kunt tests uitvoeren vanaf de pagina Eigenschappen van de virtuele-agentapp in Virtual Agent Hub. Bij het testen kunt u:

  • Controleer of de virtuele-agentapp correct is geconfigureerd om te communiceren met de virtuele-agentprovider.
  • Aangepaste payload-JSON toevoegen om de afhandeling van aangepaste payloadgegevens door de virtuele agent te testen.
  • Een welkomstintentiegebeurtenis triggeren om te testen hoe de virtuele agent een conversatie begint.
  • Een aangepaste intentiegebeurtenis triggeren om alle aangepaste gebeurtenissen die u voor uw virtuele agent hebt gemaakt te testen.
  • Een timeoutgebeurtenis triggeren om te testen hoe de virtuele agent reageert wanneer het contact een timeout krijgt.
  • Testen hoe de virtuele agent DTMFGesloten Toetstonen die worden gegenereerd wanneer een contact op een toets van de telefoon drukt.-toetstonen verwerkt.

De volgende afbeelding toont een voorbeeld van de pagina Eigenschappen voor een virtuele-agentapp in Virtual Agent Hub. Het toont de tabbladen Configuratie en Spraak en het paneel Test.

  1. Klik in CXone Mpower op de app-kiezer en selecteerOverige > Automatisering & AI en klik daarna op Virtual Agent Hub. U kunt ook dubbelklikken op de virtuele-agentactie die u in uw Studio-script gebruikt om Virtual Agent Hub te starten.
  2. Klik hier om de configuratie-app voor de virtuele agent die u wilt testen te selecteren in de lijst aan de linkerkant.
  3. Typ in het Test-paneel een testbericht in het veld Typ een bericht en druk op Enter om dit te verzenden. U kunt ook op Microfoon Een pictogram in de vorm van een microfoon. klikken en in de microfoon van uw computer spreken.

  4. Klik op Starten met welkomstintentie om een testgesprek vanaf het begin te starten. De virtuele agent stuurt een respons met het standaard welkomstbericht. U kunt testberichten invoeren.
  5. Klik op Meer opties Een pictogram met drie punten boven elkaar. om andere aspecten van uw virtuele agent te testen.

  6. Klik op Resetten om de test opnieuw te starten.
  7. Als u wijzigingen wilt aanbrengen op basis van de resultaten van uw tests, kunt u het volgende doen:

    • De Studio-scripts voor de virtuele agent aanpassen.
    • De configuratie-instellingen van de virtuele-agentapp aanpassen in Virtual Agent Hub.
    • De configuratie-instellingen van de virtuele agent aanpassen in de console van de provider. Klik op de grote vierkante knop op de pagina Eigenschappen van de app in Virtual Agent Hub. Het voorbeeld aan het begin van deze sectie toont de Google Dialogflow CX-app met de knop van de provider. Het pictogram Een pictogram met een vierkant en een pijl bovenop. De pijl wijst vanuit het midden naar rechtsboven. geeft aan dat de link een externe site opent.
  8. Test de virtuele agent grondig na elke wijziging in uw scripts of configuratie-instellingen.
  9. Wanneer u klaar bent met testen, klikt u op Sluiten.