Google Dialogflow ES integreren

Voordat u de taken op deze pagina uitvoert, moet u zeker weten dat aan de vereisten voor de integratie is voldaan.

Een script aanmaken

Vereiste machtigingen: Scripts weergeven, Scripts maken/bewerken

U hebt ten minste één Studio-script nodig om interacties naar uw virtuele agent te routeren. Volg de scriptrichtlijnen en -vereisten. De ondersteunde virtuele-agentactie voor deze provider is VoiceBot Exchange en uw script moet beschikken over het telefoonmediatypeGesloten Een kanaal zoals spraak, e-mail of chat, waarmee een klant communiceert met een beoogde ontvanger..The supported virtual agent action for this provider is Voicebot Conversation and your script must have the phone media typeGesloten Een kanaal zoals spraak, e-mail of chat, waarmee een klant communiceert met een beoogde ontvanger..

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

Als uw virtuele agent klaar is voor productie, wijs dan het script toe aan één of meer contactpunten.

Best practices voor aangepaste payloads

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

  • CustomPayload wordt gebruikt om context door te geven voor een intentieGesloten De betekenis of de bedoeling van wat een klant zegt of typt; datgene wat de klant wil communiceren of bereiken.. De context helpt de virtuele agent om de intentie van de gebruiker te begrijpen. Contextgegevens zijn niet vereist, maar ze helpen de virtuele agent om een uitingGesloten Iets wat een contact zegt of typt. te koppelen aan een intentie.
  • Maak in een Snippet -actie in uw script een customPayload-object volgens de indeling die is beschreven in de Google Dialogflow ES-documentatie Pictogram dat een link naar een externe website aanduidt voor REST Resource: projects.agent.sessions.context. De online help voor Studio biedt extra informatie over dynamische gegevensobjecten.
  • U kunt ook aangepaste gegevens zonder contextgegevens doorgeven met customPayload. Voeg hiervoor standaard JSON sleutel/waarde-paren toe aan een dynamisch gegevensobject.
  • Spraakcontexten worden als aangepaste payload doorgegeven in de parameter speech_contact. U kunt de inhoud van deze parameter terugzien in Studio-traces en applicatielogs.
  • Het dynamische customPayload-object wordt als virtual-agentparameter doorgegeven met JSON-indeling, zoals in het voorbeeldscript.
  • Spraakcontexthints kunnen doorgegeven worden met aangepaste payload in de parameter speechContexts. De waarde van speechContexts.phrases moet een Google-klassetoken Een vierkant met een pijl die uit het midden naar de rechterbovenhoek wijst. zijn voor de hint die u wilt geven. Het token moet overeenkomen met de taal en de landinstellingen van uw contacten. Bijvoorbeeld:

    DYNAMIC customPayload
    customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
    customPayload.speechContexts.boost=10		

Een app toevoegen aan Virtual Agent Hub

Vereiste machtigingen: Scripts weergeven, Scripts maken/bewerken

Door een configuratie-app toe te voegen aan Virtual Agent Hub kunt verbinding maken tussen CXone en uw virtuele-agentprovider.

  1. Open of maak in Studio een script en voeg een virtuele-agentactie toe als het script er nog geen bevat.
  2. Dubbelklik op de virtuele agent-actie om Virtual Agent Hub te openen.
  3. Klik op Bot toevoegen.
  4. Voer een Naam voor virtuele agent (bot) in en klik op Google Dialogflow ES in de lijst met virtuele-agentproviders.

  5. Klik op Volgende.

  6. 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.

  7. Klik op Volgende.

  8. 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.

  9. Klik op Volgende.

  10. Ga naar de pagina Transcriptie en stel in of u de transcriptie van het gesprek en de intentiegegevens wilt vastleggen.

  11. Klik op Volgende.

  12. 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. Mogelijk moet u ook de configuratie in de beheerconsole van uw virtuele-agentprovider controleren.

  13. Klik op Toevoegen.

Configuratiepagina voor Google Dialogflow ES

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.0in deze versie zijn de schema's bijgewerkt die worden gebruikt met Google Dialogflow ES. Dit beïnvloedt de structuur van het customPayload-object.
  • Versie 3.0.0: deze versie introduceerde StandardBot, die standaardiseert hoe CXone communiceert met virtuele-agentproviders. Het customPayload-object wordt geretourneerd als een matrix, als customPayloadscriptPayloads[n].xxxx. Deze versie is beschikbaar voor alle providers.
GCP Project-ID van klant

De Google Cloud Project-ID van uw organisatie. Dit is de identificatiecode voor uw virtuele agent. U vindt deze ID in de Google Dialogflow ES Console-instellingen.

Dit veld is alleen zichtbaar als u een OEM-serviceaccount gebruikt.

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. Dit veld is alleen zichtbaar als u uw eigen Google Dialogflow ES-account gebruikt.

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"
}

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 uw Google Dialogflow ES virtuele agent wordt gehost.
Environment De naam van de aangepaste omgeving waarin uw virtuele agent wordt gepubliceerd. Als u dit veld leeg laat, wordt de conceptomgeving gebruikt.
TTS-uitvoer inschakelen

Schakel deze optie in als u de Google Dialogflow ES-tekst-naar-spraak-service (TTSGesloten Hiermee kunt u teksten invoeren en door een computerstem laten uitspreken.) wilt gebruiken. De TTS-uitvoerinstellingen configureren.

Als u de TTS-service van Google niet wilt gebruiken, kunt u CXone Cloud TTS Hub gebruiken. U kunt deze optie configureren op de pagina Spraak van de configuratie-app.

Timeoutgebeurtenis De naam van de Google Dialogflow ES-gebeurtenis die u wilt triggeren bij een timeout.
DTMF-uitbraakpatroon

Voer de tekens in die de virtuele agent tijdens een oproep dwingen over te gaan naar de DTMFBreakout -vertakking van het Studio-script.

Vul dit veld alléén in voor een spraakgebaseerde virtuele agent.

Google Protobuf JSON Serializer gebruiken

Schakel deze optie in om Google Protobuf Serializer te gebruiken. Geserialiseerde reacties verbeteren de prestaties doordat de grootte van de reacties en de benodigde hoeveelheid geheugen kleiner worden. Deze verkleining maakt het minder waarschijnlijk dat reacties groter dan 32 KB zullen worden (de algemene limiet voor scriptvariabelen).

NICE CXone adviseert u deze optie in te schakelen. Als u de optie om welke reden dan ook moet uitschakelen, moet u de optie opnieuw activeren zodra het probleem is opgelost.

Als u uw Google Dialogflow ES-integratie uitvoert vóór de Voorjaar 2022-versie van CXone, is het belangrijk dat u uw scripts controleert op payload-ontleding. Overal waar u dit vindt, moet u het vervangen door ontleding volgens het nieuwe schema voordat u deze optie inschakelt in de integratie. Bijvoorbeeld: als uw script op dit moment verwijst naar dit: 

{parameters.fields.myfield.stringValue}

dan wijzigt u het in:

{parameters.myfield}

Timeout externe provider

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

TTS-uitvoer van Google Dialogflow ES configureren

Vereiste machtigingen: Scripts weergeven, Scripts maken/bewerken

Voltooi de stappen in deze sectie als u de TTS-service van Google wilt gebruiken. Als u de optie TTS-uitvoer inschakelen inschakelt op de pagina Dialogflow ES-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 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 TTS-stemnaam uit de vervolgkeuzelijst als u een Google-spraakmodel wilt gebruiken.

  5. Selecteer het machine learning Model en de Modelvariant die de Google TTS-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-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: Scripts weergeven, Scripts maken/bewerken

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

  3. Selecteer Turn by Turn-bediening (CXone-spraakbotgateway) op de pagina Spraak onder Opties voor spraakintegratie.
  4. Als u Gebruik CXone Cloud TTS niet kunt selecteren in het formulier, klikt u op Terug om terug te gaan naar de Configuratiepagina. Schuif de schuifregelaar TTS-uitvoer inschakelen naar Uit in . U kunt nu Cloud TTS Hub inschakelen op de pagina Spraak.

  5. Selecteer een TTS-leverancier als u gebruikmaakt van Cloud TTS Hub. Als u de TTS-service van de provider van de virtuele agent gebuikt, is dit veld niet zichtbaar en kunt u deze stap overslaan.
  6. Selecteer onder Transcriptieopties de optie voor de transcriptieservice die u wilt gebruiken.

  7. Als u ervoor kiest om een CXone-transcriptieprofiel te gebruiken, klik dan op Transcriptieprofiel om het profiel te selecteren dat u wilt gebruiken. Klik op Nieuw Turn by Turn transcriptieprofiel toevoegen om een nieuw profiel te maken.
  8. Klik op Volgende.
  9. 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 ES-app aan een actie toewijzen

Vereiste machtigingen: Scripts weergeven, Scripts maken/bewerken

Wanneer de virtuele-agentappGesloten De betekenis of de bedoeling van wat een klant zegt of typt; datgene wat de klant wil communiceren of bereiken. ingesteld en geconfigureerd is in Virtual Agent Hub, moet u deze toewijzen aan de virtuele-agentacties 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.
  5. Klik op Sluiten.

Het transcriptieprofiel wijzigen

Vereiste machtigingen: Scripts weergeven, Scripts maken/bewerken

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. Open of maak in Studio een script en voeg een virtuele-agentactie toe als het script er nog geen bevat.
  2. Dubbelklik op de virtuele agent-actie om Virtual Agent Hub te openen.
  3. 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.
  4. Ga naar het midden van de pagina Eigenschappen voor de virtuele-agentapp en klik op het tabblad Spraak.
  5. Selecteer onder Transcriptieopties CXone-transcriptieprofiel gebruiker, als u dat nog niet had gedaan.

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

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

De virtuele agent testen

Vereiste machtigingen: Scripts weergeven, Scripts maken/bewerken

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 iemand op een toets van de telefoon drukt of tikt.-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. Open of maak in Studio een script en voeg een virtuele-agentactie toe als het script er nog geen bevat.
  2. Dubbelklik op de virtuele agent-actie om Virtual Agent Hub te openen.
  3. Klik hier om de configuratie-app voor de virtuele agent die u wilt testen te selecteren in de lijst aan de linkerkant.
  4. 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 het microfoonpictogram Een pictogram in de vorm van een microfoon. klikken en in de microfoon van uw computer spreken.

  5. 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.
  6. Klik op Meer opties Een pictogram met drie punten boven elkaar. om andere aspecten van uw virtuele agent te testen.

  7. Klik op Resetten om de test opnieuw te starten.
  8. 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.
  9. Test de virtuele agent grondig na elke wijziging in uw scripts of configuratie-instellingen.
  10. Wanneer u klaar bent met testen, klikt u op Sluiten.