Projekt anlegen

TIPP

info

Anlegen von Projekten

Projekte werden pro Kunde oder Abteilungskonto angelegt. Wenn das VIER Customer Success Management noch kein Projekt für Sie angelegt hat, dann legen Sie einen Kunden und anschließend ein Abteilungskonto für diesen Kunden an.

Im Folgenden erfahren Sie, wie Sie ein Projekt anlegen. Ein vollständiges Projekt besteht aus folgenden Informationen:

TIPP

info

Anonymisierte Rufnummern anzeigen

Wenn es für einen Bot oder ein:e Bot-Entwickler:in nicht erforderlich ist, die Rufnummer des Kunden zu kennen, dann kann VIER Cognitive Voice Gateway diese jetzt anonymisieren (siehe erweiterte Optionen > Datenschutz > Rufnummern für Bot und Integrationen anonymisieren). D. h. Conversational AIs wie Boost, Cognigy, Dialogflow, Rasa, Ubitec, andere API-Benutzer:innen und Integrationen sehen nur eine anonymisierte Rufnummer.

So legen Sie ein Projekt an:

  1. Klicken Sie unter Projekte auf .
  1. Die Seite Projekt anlegen öffnet sich. Für Details zu den weiteren Schritten siehe Projekt-Basisdaten eintragen, siehe Internationale Zugangsrufnummern einrichten, siehe Sprachdienste einrichten und siehe Bot einrichten.

Die Provisionierungs-API bietet Contact Centern eine Möglichkeit, einen Anruf bei VIER Cognitive Voice Gateway anzukündigen, bevor der Anruf tatsächlich an VIER Cognitive Voice Gateway übergeben wird. Bei dieser Anrufankündigung gibt es zwei bedeutende Vorteile gegenüber Direktanrufen bzw. dem Direkttransfer von Anrufen:

  • Das Projekt in VIER Cognitive Voice Gateway (Bot-Konfiguration, Auswahl der Bot-Stimme des Anbieters, Audiokonfiguration etc.) kann für den angekündigten Anruf über die Provisionierungs-API dynamisch konfiguriert werden.
  • Zwischen der Ankündigung des Anrufs und dem tatsächlichen Transfer des Anrufs zu VIER Cognitive Voice Gateway gibt es ein kurzes Zeitfenster, in dem VIER Cognitive Voice Gateway schon Kenntnis vom bevorstehenden Dialog hat. Dieses Zeitfenster kann vom Contact Center dazu genutzt werden, über die Dialog-API Kunden-Datenfelder an den Anruf zu fixieren. Diese Kunden-Datenfelder können vom Bot oder von anderen Anschlusssystemen verwendet werden.

So tragen Sie die Projekt-Basisdaten ein:

Voraussetzung

  1. Sie haben die Seite Projekt anlegen geöffnet.
  1. Geben Sie unter Projekt einen aussagekräftigen Projektnamen ein.
  2. Fügen Sie für Ihren Bot eine Rufnummer der Plattform hinzu. Die Rufnummer der Plattform ist die Rufnummer, unter der Ihr Bot erreichbar sein wird.
  3. Wenn Sie eine weitere Plattform-Rufnummer hinterlegen möchten, dann geben Sie diese unter Rufnummer der Plattform ein.

    Tipp: Ein Anwendungsfall für mehrere Plattform-Rufnummern ist beispielsweise, dass der Voicebot eingehende Anrufe je nach gewählter Rufnummer unterschiedlich behandeln soll.
  4. Wenn Sie eine Plattform-Rufnummer kopieren möchten, dann klicken Sie im Bearbeitungsmodus Ihres Projektes mit der linken Maustaste auf die hinterlegte Rufnummer im Feld Rufnummer der Plattform.
  5. oder
    Um eine Rufnummer der Plattform anlegen zu lassen, wenden Sie sich an das VIER Customer Success Management.
  6. Wenn Sie Rufnummernblöcke zur Provisionierung benötigen, dann geben Sie diese unter Rufnummernblöcke zur Provisionierung ein.
  7. Wenn Sie nur eine Möglichkeit suchen, Anrufdaten von Ihrem Contact Center an Ihren Bot zu übergeben, und wenn Sie SIP-Telefonie verwenden, dann kann dies ebenfalls dadurch gelöst werden, dass dem Anruf bei der Übergabe Custom-SIP-Header hinzugefügt werden. Da dies innerhalb des Contact Centers initialisiert werden muss, wenden Sie sich dazu an eine:n Administrator:in Ihres Contact Centers.
  8. VIER Cognitive Voice Gateway gibt diese Custom-SIP-Header während der Session-Initialisierung an den Bot weiter.

    WARNUNG! Beachten Sie, dass SIP-Header im Netzwerk durch manche Komponenten, wie z. B. Router oder Firewalls, abgeschnitten sein könnten. Aus diesem Grund kann die Übertragung von SIP-Headern nicht garantiert werden, sondern erfolgt nach bestem Bemühen. Für weitere Informationen zur Übertragung von SIP-Headern siehe https://cognitivevoice.io/docsWARNUNG! .
  9. Um ausgehende Anrufe zu erlauben, aktivieren Sie den Schalter.
  1. Sie haben die Projekt-Basisdaten für das Projekt eingetragen.

So richten Sie internationale Zugangsrufnummern ein:

Voraussetzung

  1. Sie haben die Seite Projekt anlegen geöffnet.
  1. Klicken Sie unter Internationale Zugangsrufnummern auf .
  2. Wählen Sie den Typ der internationalen Zugangsrufnummer. Wählen Sie zwischen folgenden Typen:
  3. Geografisch: Einwahl-Rufnummer mit Landes- und Gebiets-Code
  4. Gebührenfrei: für Anrufer:innen gebührenfreie Einwahl-Rufnummer (0800-Rufnummer in Deutschland)
  5. Geteilte Kosten: Rufnummer mit geteilten Gebühren (0180x-Rufnummer in Deutschland)
  6. Andere: Anderer Rufnummerntyp
  7. Geben Sie Ihre Rufnummer ein.
  8. oder
    Lassen Sie sich von dem VIER Customer Success Management eine Rufnummer zuweisen.

    Tipp: Das tatsächliche Routing findet außerhalb von VIER Cognitive Voice Gateway statt. Die Registrierung ist für die Information notwendig, die in der Projektansicht angezeigt wird.
  1. Sie haben internationale Zugangsrufnummern eingerichtet.

So richten Sie Sprachdienste ein:

Voraussetzung

  1. Sie haben die Seite Projekt anlegen geöffnet.
  1. Wenn Sie dieselbe Sprache für den Speech-to-Text- und Text-to-Speech-Dienst verwenden möchten, dann wählen Sie unter Sprachdienst eine Sprache der Sprachdienste.
  2. Wählen Sie einen Speech-to-Text-Dienst.
  3. Wählen Sie einen Text-to-Speech-Dienst.
  4. oder
    Wenn Sie verschiedene Sprachen für den Speech-to-Text- und Text-to-Speech-Dienst verwenden möchten, dann aktivieren Sie den Schalter.
  5. Wählen Sie eine Speech-to-Text-Sprache.
  6. Wählen Sie einen Speech-to-Text-Dienst.
  7. Wählen Sie eine Text-to-Speech-Sprache.
  8. Wählen Sie einen Text-to-Speech-Dienst.
  1. Sie haben die Sprachdienste für Ihr Projekt eingerichtet.

TIPP

info

Anzeige der Felder

Die angezeigten Felder sind abhängig von der gewählten Bot-Vorlage.

Einen botario-Bot einrichten

So richten Sie einen botario-Bot ein:

Voraussetzung

  1. Sie haben die Seite Projekt anlegen geöffnet.
  1. Wählen Sie unter Bot > Vorlage botario.
  2. Geben Sie die folgenden Daten an:
  3. Satellite-URL: Die Satellite-URL, die von botario für die Instanz bereitgestellt wird, auf der der Bot gehostet wird.
  4. Bot-Token: Der Bot-Token wird jedes Mal übermittelt, wenn VIER Cognitive Voice Gateway die Bot-API aufruft. Der Bot kann den Bot-Token zur Authentifizierung verwenden.
  5. Klicken Sie auf Speichern.
  1. Sie haben den botario-Bot für Ihr Projekt eingerichtet.
  2. Sie haben Ihr Projekt angelegt. Für Einzelheiten zu erweiterten Optionen siehe Projekt anlegen - Erweiterte Optionen.

Einen ChatGPT- oder VIER Smart Dialog-Bot einrichten

So richten Sie einen ChatGPT- oder VIER Smart Dialog-Bot ein:

Voraussetzung

  1. Sie haben die Seite Projekt anlegen geöffnet.
  1. Wählen Sie unter Bot > Vorlage ChatGPT oder VIER Smart Dialog.
  2. Geben Sie die folgenden Daten an:
  1. Anbieter: Wählen Sie den ChatGPT-Anbieter, den Sie für Ihren Voicebot verwenden möchten.
  1. API-Schlüssel von OpenAI: Geben Sie den API-Schlüssel ein, den OpenAI bereitstellt. Für detaillierte Informationen siehe https://platform.openai.com/account/apikeys bereitstellt.
  2. HINWEIS! Das Feld API-Schlüssel von OpenAI ist nur sichtbar, wenn Sie im Feld Anbieter OpenAI gewählt haben.

    Tipp: Sobald Sie im Feld API-Schlüssel von OpenAI einen API-Schlüssel eingegeben und Ihre Einstellungen gespeichert haben, wird der API-Schlüssel im Bearbeitungs- oder Lesemodus der Einstellungen nicht mehr angezeigt. Dadurch wird verhindert, dass der API-Schlüssel von OpenAI aus VIER Cognitive Voice Gateway kopiert und für andere Anwendungen verwendet wird.

    Tipp:     Wenn Sie eine neue OpenAI-API verwenden möchten, dann klicken Sie im Bearbeitungsmodus auf API-Schlüssel von OpenAI ersetzen und geben Sie den neuen API-Schlüssel ein.
  3. API-Schlüssel von Microsoft Azure: Geben Sie den API-Schlüssel ein, den Microsoft bereitstellt. Für detaillierte Informationen siehe https://learn.microsoft.com/en-us/azure/cognitive-services/openai/quickstart?tabs=command-line&pivots=programming-language-studio.

    HINWEIS! Das Feld API-Schlüssel von Microsoft Azure ist nur sichtbar, wenn Sie im Feld Anbieter Microsoft Azure gewählt haben.
  4. API-Schlüssel von Microsoft Azure: Geben Sie den API-Schlüssel ein, den Microsoft bereitstellt. Für detaillierte Informationen siehe https://learn.microsoft.com/en-us/azure/cognitive-services/openai/quickstart?tabs=command-line&pivots=programming-language-studio.

    HINWEIS! Das Feld API-Schlüssel von Microsoft Azure ist nur sichtbar, wenn Sie im Feld Anbieter Microsoft Azure gewählt haben.
  5. Sprachmodell: Wählen Sie das ChatGPT-Modell, das Sie für Ihren Bot verwenden möchten.

  6. Tipp: Das Feld Sprachmodell ist nur sichtbar, wenn Sie im Feld Anbieter OpenAI gewählt haben.
  7. Bereitstellungs-URL von Microsoft Azure: Um zu ermöglichen, dass VIER Cognitive Voice Gateway die entsprechende ChatGPT-Instanz ansprechen kann, geben Sie die Bereitstellungs-URL von Microsoft Azure ein. Für detaillierte Informationen siehe https://stage.cognitivevoice.io/docs/conversational-ai/conversational-ai-ChatGPT.html#using-your-azure-openai-subscription.

    HINWEIS! Das Feld Bereitstellungs-URL von Microsoft Azure ist nur sichtbar, wenn Sie im Feld Anbieter Microsoft Azure gewählt haben.
  8. Bereitstellungs-URL von Microsoft Azure: Um zu ermöglichen, dass VIER Cognitive Voice Gateway die entsprechende ChatGPT-Instanz ansprechen kann, geben Sie die Bereitstellungs-URL von Microsoft Azure ein. Für detaillierte Informationen siehe https://stage.cognitivevoice.io/docs/conversational-ai/conversational-ai-ChatGPT.html#using-your-azure-openai-subscription.

    HINWEIS! Das Feld Bereitstellungs-URL von Microsoft Azure ist nur sichtbar, wenn Sie im Feld Anbieter Microsoft Azure gewählt haben.
  9. Disclaimer-Nachricht: Geben Sie optional eine Disclaimer-Nachricht ein. Die Disclaimer-Nachricht wird vom Bot zu Beginn des Dialoges vorgelesen.

Beispiel

Ihre eingegebenen Daten werden gespeichert und an OpenAI zur weiteren Bearbeitung weitergegeben.

  1. Text-to-Speech-Dienst für die Disclaimer-Nachricht: Wählen Sie den Text-to-Speech-Dienst oder den Text-to-Speech-Dienst in Kombination mit der entsprechenden Stimme, über den die Disclaimer-Nachricht ausgegeben wird.

    Tipp: Wenn Sie für die Disclaimer-Nachricht eine Stimme wählen, die von der eingestellten Voicebot-Stimme abweicht, dann kann der:die Gesprächspartner:in einfacher zwischen Vorab-Informationen und dem eigentlichen Voicebot unterscheiden.

    Tipp: Wenn Sie nur den Text-to-Speech-Dienst ohne Stimme wählen, dann wird die Stimme vom Text-to-Speech-Dienst gewählt.
  2. Instructions: Geben Sie die Anweisungen an, wie ChatGPT sich im Gesprächsverlauf verhalten und auf welches Wissen es zugreifen soll.

Beispiel

Du bist Jo, ein freundlicher und humorvoller Kundenbetreuer für ein Unternehmen namens Jobo. Jobo vertreibt NFT-Kunst. Du antwortest so kurz wie möglich in maximal 3 Sätzen. Sag deinen Namen, Jo, nur, wenn du ausdrücklich dazu aufgefordert wirst.

  1. Prompt für Begrüßung: Geben Sie den Prompt ein, der ChatGPT dazu auffordert, den:die Kund:in zu begrüßen.

    Tipp: Bei der Begrüßung wird auch das Feld Instructions berücksichtigt.

Beispiel

Du bist Jo, ein freundlicher und humorvoller Kundenbetreuer für eine Firma namens Jobo. Begrüße den:die Anrufer:in abhängig von der Tageszeit, stelle dich kurz vor, weise darauf hin, dass dieser Anruf zu Qualitätssicherungszwecken aufgezeichnet wird und frage den:die Anrufer:in, was du für ihn:sie tun kannst. Die aktuelle Zeit ist {time, Europe/Berlin}.

  1. Anrufe weiterleiten: Für die Weiterleitung von Anrufen gibt es zwei unterschiedliche Möglichkeiten: Anrufe können durch die Erzeugung von JSON-Ausdrücken weitergeleitet werden oder Anrufe können mit Hilfe von Funktionsaufrufen weitergeleitet werden. Hinterlegen Sie mögliche Weiterleitungsziele im Feld Instructions.
  2. Wenn Sie für die Anrufweiterleitung Funktionsaufrufe verwenden möchten, dann stellen Sie den Schalter auf Anrufe weiterleiten aktiviert.
  3. Wenn Sie für die Anrufweiterleitung JSON-Ausdrücke verwenden möchten, dann stellen Sie den Schalter auf Anrufe weiterleiten deaktiviert.

    HINWEIS! Funktionsaufrufe werden nur bei den neueren OpenAI-Modellen unterstützt, die ab dem 13.06.2023 released wurden.Für detaillierte Informationen zur Anrufweiterleitung mit Funktionsaufrufen siehe https://cognitivevoice.io/docs/releases/1.31.0/index.html#function-callsHINWEIS! und https://cognitivevoice.io/docs/releases/1.35.0/index.html.

    Tipp: Die Anrufweiterleitung mit JSON-Ausdrücken kann sowohl mit älteren als auch mit neueren GPT-Modellen verwendet werden. Weitere Informationen dazu finden Sie unter https://cognitivevoice.io/docs/releases/1.30.0/index.html#json-output-from-chatgpt-for-call-control.

    Tipp: Um die Funktion Anrufe weiterleiten nutzen zu können, aktivieren Sie außerdem die ausgehenden Anrufe unter Erweiterte Optionen anzeigen > Ausgehende Anrufe.

HINWEIS

notice

GPT-Modelle in Microsoft Azure

Beispiel

Die Funktion Anrufe weiterleiten können Sie beispielsweise verwenden, um dem Voicebot Aufgaben wie die Vorqualifizierung oder das Routen zur richtigen Abteilung zuzuweisen.

  1. Anrufe beenden: Wenn Sie möchten, dass ChatGPT Anrufe selbstständig beenden darf, dann stellen Sie den Schalter auf Anrufe beenden aktiviert. Dies setzt voraus, dass das verwendete GPT-Modell Funktionsaufrufe unterstützt. Alternativ können Sie auch über die Begriffe zum Beenden des Anrufs vorgeben, nach welchen Benutzerphrasen der Bot den Anruf beendet.

    Tipp: Geben Sie im Feld Instructions die Szenarien an, in denen ChatGPT Anrufe beenden soll.
  2. Wenn Sie möchten, dass ChatGPT die Gesprächsinformationen mit benutzerdefinierten Daten ergänzen darf, dann stellen Sie den Schalter auf Benutzerdefinierte Daten hinzufügen aktiviert.

    HINWEIS! Benutzerdefinierte Daten werden innerhalb von VIER Cognitive Voice Gateway gespeichert und können von nachfolgenden Systemen gelesen werden, z. B. nach einem Handover an eine:n menschliche:n Agenten:Agentin.
  3. Prompt für Weiterleiten eines Anrufs: Geben Sie einen Text ein, den der Voicebot sagen soll, sobald er einen Anruf weiterleitet.
  4. Prompt für Beenden eines Anrufs: Geben Sie einen Text ein, den der Voicebot sagen soll, sobald er einen Anruf beendet.
  5. Prompt für Speichern von benutzerdefinierten Daten: Geben Sie einen Text ein, den der Voicebot sagen soll, sobald er benutzerdefinierte Daten speichert.
  6. Audiodatei zum Bestätigen von Eingaben: Geben Sie eine gültige HTTP-URL zu einer Audiodatei ein, die abgespielt wird, wenn ChatGPT eine neue User-Eingabe erhält und wenn der:die User:in auf eine Antwort wartet.

Beispiel

Ein Geräusch von Wellen und Möwen, wenn Sie eine:n virtuelle:n Reiseassistenten:Reiseassistentin entwickeln.

  1. Begriffe zum Stoppen des Bots: Geben Sie einen oder mehrere Begriffe ein, die die Text-to-Speech-Ausgabe der ChatGPT-Antwort stoppen sollen. Bestätigen Sie jeden eingegebenen Begriff mit der Enter-Taste.

Beispiele

„Stopp“

„Halt“

„Es reicht“

„Ruhe“

  1. Begriffe zum Beenden des Anrufs: Geben Sie einen oder mehrere Begriffe ein, die den Anruf beenden sollen. Bestätigen Sie jeden eingegebenen Begriff mit der Enter-Taste.

Beispiele

„Ciao

„Tschüss“

„Auf Wiedersehen“

  1. Mindestkonfidenz für Barge-in: Der Wert der Übereinstimmung zwischen der Äußerung, die der:die Kund:in gesagt hat und der Äußerung, die der STT-Dienst daraus transkribiert hat. Stellen Sie den Wert ein, ab dem die übereinstimmenden Äußerungen ein Barge-in auslösen sollen.
  2. Sprech-Geschwindigkeit: Stellen Sie die Geschwindigkeit ein, mit der der Text-to-Speech-Dienst den Text sprechen soll.
  3. Max tokens: Geben Sie die maximale Anzahl der Token ein, die in der Completion erzeugt werden dürfen.
  4. Temperature: Stellen Sie die Sampling-Temperature ein. Stellen Sie einen Wert zwischen 0 und 2 ein.

    Tipp:     Um Halluzinationen möglichst auszuschließen, verwenden Sie einen Wert von < 0,7.
  5. Top P: Stellen Sie einen Top-P-Wert als Alternative zu Temperature ein.
  6. Presence penalty: Stellen Sie einen Wert für Presence penalty ein. Positive Werte bewerten neue Token, je nachdem, ob sie bereits im Text vorkommen und erhöhen die Wahrscheinlichkeit, dass ChatGPT über neue Themen spricht.
  7. Frequency penalty: Stellen Sie einen Wert für Frequence penalty ein. Positive Werte bewerten neue Token auf der Grundlage ihrer bisherigen Häufigkeit im Text und verringern die Wahrscheinlichkeit, dass ChatGPT dieselbe Zeile wortwörtlich wiederholt.
  8. Antwort von ChatGPT: Wenn Sie möchten, dass ChatGPT seine Rückmeldung Satz für Satz ausgibt, bevor eine Gesamtantwort vorliegt, dann stellen Sie den Schalter auf Antwort von ChatGPT Satz für Satz ausgeben, sobald ein vollständiger Satz als Teilergebnis von ChatGPT vorliegt.

    HINWEIS! Wenn Sie die Satz-für-Satz-Antwort von ChatGPT eingestellt haben, dann antwortet ChatGPT schneller, jedoch gegebenenfalls mit kurzen Pausen zwischen den Sätzen. Wenn Sie hingegegen eingestellt haben, dass ChatGPT die Ausgabe erst startet, sobald eine Gesamtantwort vorliegt, dann ist die Antwort etwas verzögerter, jedoch ergeben sich keine Pausen zwischen den einzelnen Sätzen.
  9. Antwort von ChatGPT: Wenn Sie möchten, dass ChatGPT seine Rückmeldung Satz für Satz ausgibt, bevor eine Gesamtantwort vorliegt, dann stellen Sie den Schalter auf Antwort von ChatGPT Satz für Satz ausgeben, sobald ein vollständiger Satz als Teilergebnis von ChatGPT vorliegt.

    HINWEIS! Wenn Sie die Satz-für-Satz-Antwort von ChatGPT eingestellt haben, dann antwortet ChatGPT schneller, jedoch gegebenenfalls mit kurzen Pausen zwischen den Sätzen. Wenn Sie hingegegen eingestellt haben, dass ChatGPT die Ausgabe erst startet, sobald eine Gesamtantwort vorliegt, dann ist die Antwort etwas verzögerter, jedoch ergeben sich keine Pausen zwischen den einzelnen Sätzen.
  10. Aufzeichnung von Dialogen: Wenn Sie möchten, dass Dialoge aufgezeichnet werden, dann stellen Sie den Schalter auf Dialoge werden aufgezeichnet.
  11. Klicken Sie auf Speichern.
  1. Sie haben den ChatGPT- oder VIER Smart Dialog-Bot für Ihr Projekt eingerichtet.
  2. Sie haben Ihr Projekt angelegt. Für Einzelheiten zu erweiterten Optionen siehe Projekt anlegen - Erweiterte Optionen.

Einen VIER Smart Dialog Assistant (Beta)-Bot einrichten

So richten Sie einen VIER Smart Dialog Assistant (Beta)-Bot ein:

Voraussetzung

  1. Sie haben die Seite Projekt anlegen geöffnet.
  1. Wählen Sie unter Bot > Vorlage VIER Smart Dialog Assistant (Beta).
  2. Geben Sie die folgenden Daten an:
  1. Anbieter: Wählen Sie den ChatGPT-Anbieter, den Sie für Ihren Voicebot verwenden möchten.
  1. API-Schlüssel von OpenAI: Geben Sie den API-Schlüssel ein, den OpenAI bereitstellt. Für detaillierte Informationen siehe https://platform.openai.com/account/apikeys bereitstellt.
  2. HINWEIS! Das Feld API-Schlüssel von OpenAI ist nur sichtbar, wenn Sie im Feld Anbieter OpenAI gewählt haben.

    Tipp: Sobald Sie im Feld API-Schlüssel von OpenAI einen API-Schlüssel eingegeben und Ihre Einstellungen gespeichert haben, wird der API-Schlüssel im Bearbeitungs- oder Lesemodus der Einstellungen nicht mehr angezeigt. Dadurch wird verhindert, dass der API-Schlüssel von OpenAI aus VIER Cognitive Voice Gateway kopiert und für andere Anwendungen verwendet wird.

    Tipp:     Wenn Sie eine neue OpenAI-API verwenden möchten, dann klicken Sie im Bearbeitungsmodus auf API-Schlüssel von OpenAI ersetzen und geben Sie den neuen API-Schlüssel ein.
  3. API-Schlüssel von Microsoft Azure: Geben Sie den API-Schlüssel ein, den Microsoft bereitstellt. Für detaillierte Informationen siehe https://learn.microsoft.com/en-us/azure/cognitive-services/openai/quickstart?tabs=command-line&pivots=programming-language-studio.

    HINWEIS! Das Feld API-Schlüssel von Microsoft Azure ist nur sichtbar, wenn Sie im Feld Anbieter Microsoft Azure gewählt haben.
  4. API-Schlüssel von Microsoft Azure: Geben Sie den API-Schlüssel ein, den Microsoft bereitstellt. Für detaillierte Informationen siehe https://learn.microsoft.com/en-us/azure/cognitive-services/openai/quickstart?tabs=command-line&pivots=programming-language-studio.

    HINWEIS! Das Feld API-Schlüssel von Microsoft Azure ist nur sichtbar, wenn Sie im Feld Anbieter Microsoft Azure gewählt haben.
  5. Bereitstellungs-URL von Microsoft Azure: Um zu ermöglichen, dass VIER Cognitive Voice Gateway die entsprechende ChatGPT-Instanz ansprechen kann, geben Sie die Bereitstellungs-URL von Microsoft Azure ein. Für detaillierte Informationen siehe https://stage.cognitivevoice.io/docs/conversational-ai/conversational-ai-ChatGPT.html#using-your-azure-openai-subscription.

    HINWEIS! Das Feld Bereitstellungs-URL von Microsoft Azure ist nur sichtbar, wenn Sie im Feld Anbieter Microsoft Azure gewählt haben.
  6. Bereitstellungs-URL von Microsoft Azure: Um zu ermöglichen, dass VIER Cognitive Voice Gateway die entsprechende ChatGPT-Instanz ansprechen kann, geben Sie die Bereitstellungs-URL von Microsoft Azure ein. Für detaillierte Informationen siehe https://stage.cognitivevoice.io/docs/conversational-ai/conversational-ai-ChatGPT.html#using-your-azure-openai-subscription.

    HINWEIS! Das Feld Bereitstellungs-URL von Microsoft Azure ist nur sichtbar, wenn Sie im Feld Anbieter Microsoft Azure gewählt haben.
  7. Beschreibung: Geben Sie eine Beschreibung für den Assistenten ein.
  8. Sprachmodell: Wählen Sie das ChatGPT-Modell, das Sie für Ihren Bot verwenden möchten.
  9. Instructions: Geben Sie die Anweisungen an, wie ChatGPT sich im Gesprächsverlauf verhalten und auf welches Wissen es zugreifen soll.

Beispiel

Du bist Jo, ein freundlicher und humorvoller Kundenbetreuer für ein Unternehmen namens Jobo. Jobo vertreibt NFT-Kunst. Du antwortest so kurz wie möglich in maximal 3 Sätzen. Sag deinen Namen, Jo, nur, wenn du ausdrücklich dazu aufgefordert wirst.

  1. Prompt für Begrüßung: Geben Sie den Prompt ein, der ChatGPT dazu auffordert, den:die Kund:in zu begrüßen.

    Tipp: Bei der Begrüßung wird auch das Feld Instructions berücksichtigt.

Beispiel

Du bist Jo, ein freundlicher und humorvoller Kundenbetreuer für eine Firma namens Jobo. Begrüße den:die Anrufer:in abhängig von der Tageszeit, stelle dich kurz vor, weise darauf hin, dass dieser Anruf zu Qualitätssicherungszwecken aufgezeichnet wird und frage den:die Anrufer:in, was du für ihn:sie tun kannst. Die aktuelle Zeit ist {time, Europe/Berlin}.

  1. Dateiverwaltung öffnen: Wenn Sie möchten, dass Ihr Voicebot bei Sprachausgaben auf eine Wissensbasis zurückgreift, dann klicken Sie auf Dateiverwaltung öffnen und laden Sie die gewünschte Datei hoch.
  2. Dateien für Wissensgrundlage: Wählen Sie die hinterlegte Datei, auf die Ihr Voicebot bei Sprachausgaben als Wissensbasis zurückgreifen soll.
  3. Anrufe weiterleiten: Für die Weiterleitung von Anrufen gibt es zwei unterschiedliche Möglichkeiten: Anrufe können durch die Erzeugung von JSON-Ausdrücken weitergeleitet werden oder Anrufe können mit Hilfe von Funktionsaufrufen weitergeleitet werden. Hinterlegen Sie mögliche Weiterleitungsziele im Feld Instructions.
  4. Wenn Sie für die Anrufweiterleitung Funktionsaufrufe verwenden möchten, dann stellen Sie den Schalter auf Anrufe weiterleiten aktiviert.
  5. Wenn Sie für die Anrufweiterleitung JSON-Ausdrücke verwenden möchten, dann stellen Sie den Schalter auf Anrufe weiterleiten deaktiviert.

    HINWEIS! Funktionsaufrufe werden nur bei den neueren OpenAI-Modellen unterstützt, die ab dem 13.06.2023 released wurden.Für detaillierte Informationen zur Anrufweiterleitung mit Funktionsaufrufen siehe https://cognitivevoice.io/docs/releases/1.31.0/index.html#function-callsHINWEIS! und https://cognitivevoice.io/docs/releases/1.35.0/index.html.

    Tipp: Die Anrufweiterleitung mit JSON-Ausdrücken kann sowohl mit älteren als auch mit neueren GPT-Modellen verwendet werden. Weitere Informationen dazu finden Sie unter https://cognitivevoice.io/docs/releases/1.30.0/index.html#json-output-from-chatgpt-for-call-control.

    Tipp: Um die Funktion Anrufe weiterleiten nutzen zu können, aktivieren Sie außerdem die ausgehenden Anrufe unter Erweiterte Optionen anzeigen > Ausgehende Anrufe.

HINWEIS

notice

GPT-Modelle in Microsoft Azure

Beispiel

Die Funktion Anrufe weiterleiten können Sie beispielsweise verwenden, um dem Voicebot Aufgaben wie die Vorqualifizierung oder das Routen zur richtigen Abteilung zuzuweisen.

  1. Anrufe beenden: Wenn Sie möchten, dass ChatGPT Anrufe selbstständig beenden darf, dann stellen Sie den Schalter auf Anrufe beenden aktiviert. Dies setzt voraus, dass das verwendete GPT-Modell Funktionsaufrufe unterstützt. Alternativ können Sie auch über die Begriffe zum Beenden des Anrufs vorgeben, nach welchen Benutzerphrasen der Bot den Anruf beendet.

    Tipp: Geben Sie im Feld Instructions die Szenarien an, in denen ChatGPT Anrufe beenden soll.
  2. Wenn Sie möchten, dass ChatGPT die Gesprächsinformationen mit benutzerdefinierten Daten ergänzen darf, dann stellen Sie den Schalter auf Benutzerdefinierte Daten hinzufügen aktiviert.

    HINWEIS! Benutzerdefinierte Daten werden innerhalb von VIER Cognitive Voice Gateway gespeichert und können von nachfolgenden Systemen gelesen werden, z. B. nach einem Handover an eine:n menschliche:n Agenten:Agentin.
  3. Prompt für Weiterleiten eines Anrufs: Geben Sie einen Text ein, den der Voicebot sagen soll, sobald er einen Anruf weiterleitet.
  4. Prompt für Beenden eines Anrufs: Geben Sie einen Text ein, den der Voicebot sagen soll, sobald er einen Anruf beendet.
  5. Prompt für Speichern von benutzerdefinierten Daten: Geben Sie einen Text ein, den der Voicebot sagen soll, sobald er benutzerdefinierte Daten speichert.
  6. Disclaimer-Nachricht: Geben Sie optional eine Disclaimer-Nachricht ein. Die Disclaimer-Nachricht wird vom Bot zu Beginn des Dialoges vorgelesen.

Beispiel

Ihre eingegebenen Daten werden gespeichert und an OpenAI zur weiteren Bearbeitung weitergegeben.

  1. Text-to-Speech-Dienst für die Disclaimer-Nachricht: Wählen Sie den Text-to-Speech-Dienst oder den Text-to-Speech-Dienst in Kombination mit der entsprechenden Stimme, über den die Disclaimer-Nachricht ausgegeben wird.

    Tipp: Wenn Sie für die Disclaimer-Nachricht eine Stimme wählen, die von der eingestellten Voicebot-Stimme abweicht, dann kann der:die Gesprächspartner:in einfacher zwischen Vorab-Informationen und dem eigentlichen Voicebot unterscheiden.

    Tipp: Wenn Sie nur den Text-to-Speech-Dienst ohne Stimme wählen, dann wird die Stimme vom Text-to-Speech-Dienst gewählt.
  2. Audiodatei zum Bestätigen von Eingaben: Geben Sie eine gültige HTTP-URL zu einer Audiodatei ein, die abgespielt wird, wenn ChatGPT eine neue User-Eingabe erhält und wenn der:die User:in auf eine Antwort wartet.

Beispiel

Ein Geräusch von Wellen und Möwen, wenn Sie eine:n virtuelle:n Reiseassistenten:Reiseassistentin entwickeln.

  1. Begriffe zum Stoppen des Bots: Geben Sie einen oder mehrere Begriffe ein, die die Text-to-Speech-Ausgabe der ChatGPT-Antwort stoppen sollen. Bestätigen Sie jeden eingegebenen Begriff mit der Enter-Taste.

Beispiele

„Stopp“

„Halt“

„Es reicht“

„Ruhe“

  1. Begriffe zum Beenden des Anrufs: Geben Sie einen oder mehrere Begriffe ein, die den Anruf beenden sollen. Bestätigen Sie jeden eingegebenen Begriff mit der Enter-Taste.

Beispiele

„Ciao

„Tschüss“

„Auf Wiedersehen“

  1. Mindestkonfidenz für Barge-in: Der Wert der Übereinstimmung zwischen der Äußerung, die der:die Kund:in gesagt hat und der Äußerung, die der STT-Dienst daraus transkribiert hat. Stellen Sie den Wert ein, ab dem die übereinstimmenden Äußerungen ein Barge-in auslösen sollen.
  2. Sprech-Geschwindigkeit: Stellen Sie die Geschwindigkeit ein, mit der der Text-to-Speech-Dienst den Text sprechen soll.
  3. Aufzeichnung von Dialogen: Wenn Sie möchten, dass Dialoge aufgezeichnet werden, dann stellen Sie den Schalter auf Dialoge werden aufgezeichnet.
  4. Klicken Sie auf Speichern.
  1. Sie haben den VIER Smart Dialog Assistant (Beta)-Bot für Ihr Projekt eingerichtet.

Sie haben Ihr Projekt angelegt. Für Einzelheiten zu erweiterten Optionen siehe Projekt anlegen - Erweiterte Optionen

Einen Cognigy-Bot einrichten

So richten Sie einen Cognigy-Bot ein:

Voraussetzung

  1. Sie haben die Seite Projekt anlegen geöffnet.
  1. Wählen Sie unter unter Bot > Vorlage Cognigy.
  2. Kopieren Sie unter Cognigy-Endpunkt-URL direkt die original Endpunkt-URL eines Cognigy-Endpunktes und fügen Sie diese ein.
  3. Unter Cognigy-Kanal konfigurieren Sie optional ein Suffix für den Kanalnamen.
  4. Dieser wird in der Analytics-Ansicht von Cognigy angezeigt.
  5. Wenn das Feld nicht befüllt wird, dann wird als Standard VIER verwendet.

    Tipp: Verwenden Sie innerhalb von Cognigy die VIER Voice Extension für Cognigy, um einfach den Anruf zu steuern (z. B. Gesprächsaufzeichnungen starten/stoppen oder den Anruf weiterleiten) oder Sprachausgaben mit SSML zu tunen. Für weitere Informationen siehe VIER Voice Extension für Cognigy.
  6. Klicken Sie auf Speichern.
  1. Sie haben den Cognigy-Bot für Ihr Projekt eingerichtet.
  1. Sie haben Ihr Projekt angelegt. Für Einzelheiten zu erweiterten Optionen siehe Projekt anlegen - Erweiterte Optionen

Einen Dialogflow CX-Bot einrichten

So richten Sie einen Dialogflow CX-Bot ein:

Voraussetzung

  1. Sie haben die Seite Projekt anlegen geöffnet.
  1. Wählen Sie unter Bot > Vorlage Dialogflow CX.
  2. Geben Sie die folgenden Daten an:
  3. Ort: Ort, an dem Ihr:e Dialogflow CX-Agent:in ruhende Daten speichert, z. B. „europe-west1” oder „global”.
  4. Agent:in: ID der:des Dialogflow CX-Agenten:Agentin. Für detaillierte Informationen zum Einfügen von Dialogflow CX-Agent:innen siehe ID von Dialogflow-CX-Agent:innen einfügen.
  5. Zugangsdaten: Zusätzliche Bot-Konfiguration, die in der Session-Initialisierungsanfrage enthalten ist. Für detaillierte Informationen zum Import der Zugangsdaten siehe Anmeldeinformationen aus Dialogflow CX oder Dialogflow ES via JSON-Datei importieren.
  6. Klicken Sie auf Speichern.
  1. Sie haben den Dialogflow CX-Bot für Ihr Projekt eingerichtet.
  2. Sie haben Ihr Projekt angelegt. Für Einzelheiten zu erweiterten Optionen siehe Projekt anlegen - Erweiterte Optionen.

Einen Dialogflow ES-Bot einrichten

So richten Sie einen Dialogflow ES-Bot ein:

Voraussetzung

  1. Sie haben die Seite Projekt anlegen geöffnet.
  1. Wählen Sie unter Bot > Vorlage Dialogflow ES.
  2. Geben Sie die folgenden Daten an:

    Tipp: Um mit der Google-Dialogflow ES-Integration von VIER Cognitive Voice Gateway zu arbeiten, erstellen und konfigurieren Sie das Google-Dialogflow-Dienstkonto. Erstellen Sie in der Google-Cloud-Platform-Konsole ein neues Projekt und dann ein Dienstkonto für das Projekt. Stellen Sie sicher, dass Sie mindestens die Rolle Dialogflow Service Agent zuweisen, um die Intent-Erkennung zu ermöglichen. Erstellen Sie einen Dienstkonto-Schlüssel und laden Sie die JSON-Version davon herunter.
  3. Umgebung: Mit Google-Dialogflow-Umgebungen können Sie mehrere Versionen Ihres Dialogflow-Agenten erstellen und diese dann in separaten Umgebungen veröffentlichen. Um eine bestimmte Umgebung zu wählen, geben Sie hier den Namen ein. Wenn Sie keine Umgebung eingeben, dann wird die Standardumgebung „Entwurf“ für Ihre Google-Dialogflow ES-Integration mit VIER Cognitive Voice Gateway gewählt.
  4. Benutzer-ID: Geben Sie Ihre Benutzer-ID in der Google Cloud Platform ein.
  5. Zugangsdaten: Geben Sie eine zusätzliche Bot-Konfiguration ein, die in der Session-Initialisierungsanforderung enthalten ist. Für detaillierte Informationen zum Import der Zugangsdaten siehe Anmeldeinformationen aus Dialogflow CX oder Dialogflow ES via JSON-Datei importieren.
  6. Klicken Sie auf Speichern.
  1. Sie haben den Dialogflow ES-Bot für Ihr Projekt eingerichtet.
  2. Sie haben Ihr Projekt angelegt. Für Einzelheiten zu erweiterten Optionen siehe Projekt anlegen - Erweiterte Optionen.

Einen benutzerdefinierten Bot einrichten

Implementieren Sie die REST-Endpunkte der Bot-API (Client) in Ihrer Infrastruktur [siehe https://cognitivevoice.io/specs/?urls.primaryName=Bot%20API%20(Client)]. Die Vorlage Benutzerdefiniert ermöglicht den direkten Gebrauch der API für VIER Cognitive Voice Gateway mit Ihren eigenen Frameworks und Ihrer eigenen integrierten Conversational AI.

So richten Sie einen benutzerdefinierten Bot ein:

Voraussetzung

  1. Sie haben die Seite Projekt anlegen geöffnet.
  1. Wählen Sie unter Bot > Vorlage Benutzerdefiniert.
  2. Geben Sie die folgenden Daten an:
  3. Bot-URL: Die Basis-URL der REST-Endpunkte Ihres Bots.

Beispiel

[https://<yourBot>.<yourCompany>.<yourTopLevelDomain>/<yourPathToTheBot].

https://<yourBot>.<yourCompany>.<yourTopLevelDomain>/<yourPathToTheBot>.
Cognitive Voice Gateway will call e. g. [https://<yourBot>.<yourCompany>.<yourTopLevelDomain><cyourPathToTheBot>/session]https://<yourBot>.<yourCompany>.<yourTopLevelDomain>/<yourPathToTheBot>/session.

  1. Bot-Token: Das Bot-Token, das in Ihrer Infrastruktur verwendet wird, um den Zugriff per VIER Cognitive Voice Gateway auf Ihre REST-Endpunkte zu autorisieren.
  2. Tipp: Das Feld Bot-Token zeigt den Bot-Token unverschlüsselt an. Um den Bot-Token zu verbergen, klicken Sie auf . Um den Bot-Token wieder sichtbar zu machen, klicken Sie auf .
  3. Zeige benutzerdefinierte Konfiguration: Klicken Sie auf Zeige benutzerdefinierte Konfiguration und fügen Sie optional eine erweiterte Konfiguration hinzu, die mit jeder Anfrage an Ihren Bot gesendet wird.
  4. oder
    Wenn Sie eine erweiterte Konfiguration importieren möchten, dann klicken Sie auf Lade benutzerdefinierte Konfiguration aus JSON-Datei und fügen Sie Ihre gewünschte JSON-Datei ein.
  5. Klicken Sie auf Speichern.
  1. Sie haben den benutzerdefinierten Bot für Ihr Projekt eingerichtet.
  2. Sie haben Ihr Projekt angelegt. Für Einzelheiten zu erweiterten Optionen siehe Projekt anlegen - Erweiterte Optionen.

Einen Rasa-Bot einrichten

So richten Sie einen Rasa-Bot ein:

Voraussetzung

  1. Sie haben die Seite Projekt anlegen geöffnet.
  1. Wählen Sie unter Bot > Vorlage Rasa.
  2. Geben Sie die folgenden Daten ein:
  3. Basis-URL des Rasa-Servers: Die Basis-URL Ihres Rasa-Servers, auf dem der Rasa-Channel für VIER Cognitive Voice Gateway installiert ist.
  4. Bot-Token: Das Bot-Token, das in Ihrer Infrastruktur verwendet wird, um den Zugriff per VIER Cognitive Voice Gateway auf Ihre REST-Endpunkte zu autorisieren.
  5. Klicken Sie auf Speichern.
  1. Sie haben den Rasa-Bot für Ihr Projekt eingerichtet.
  2. Sie haben Ihr Projekt angelegt. Für Einzelheiten zu erweiterten Optionen siehe Projekt anlegen - Erweiterte Optionen.

Einen Boost-, Jovo-, VIER Conversational AI-, Ubitec- oder Neohelden-Bot einrichten:

So richten Sie einen Boost-, Jovo-, VIER Conversational AI-, Ubitec- oder Neohelden-Bot ein:

Voraussetzung

  1. Sie haben die Seite Projekt anlegen geöffnet.
  1. Wählen Sie unter Bot > Vorlage Boost, Jovo, VIER Conversational AI, Ubitec oder Neohelden.
  2. Geben Sie die folgenden Daten ein:
  3. Bot-URL: Die Bot-URL ist die Adresse, unter der Ihr Bot erreichbar ist.
  4. Bot-Token: Das Bot-Token, das in Ihrer Infrastruktur verwendet wird, um den Zugriff per VIER Cognitive Voice Gateway auf Ihre REST-Endpunkte zu autorisieren.

    Tipp: Das Feld Bot-Token zeigt den Bot-Token unverschlüsselt an. Um den Bot-Token zu verbergen, klicken Sie auf . Um den Bot-Token wieder sichtbar zu machen, klicken Sie auf .
  5. Klicken Sie auf Speichern.
  1. Sie haben den Boost -, Jovo-, VIER Conversational AI-, Ubitec- oder Neohelden-Bot für Ihr Projekt eingerichtet.
  2. Sie haben Ihr Projekt angelegt. Für Einzelheiten zu erweiterten Optionen siehe Projekt anlegen - Erweiterte Optionen.

So fügen Sie die ID von Dialogflow-CX-Agent:innen ein:

Voraussetzungen

  1. Sie haben ein Google-Dialogflow-Dienstkonto erstellt und konfiguriert.
  2. Sie haben in der Google-Cloud-Platform-Konsole ein neues Projekt erstellt.
  3. Sie haben in der Google-Cloud-Platform ein Dienstkonto für das Projekt erstellt.
  4. Um die Intent-Erkennung zu ermöglichen, haben Sie mindestens die Rolle Dialogflow Service Agent zugewiesen bekommen.
  5. Sie haben einen Dienstkonto-Schlüssel erstellt und die JSON-Version davon heruntergeladen.
  1. Um eine Liste Ihrer Dialogflox-CX-Agent:innen zu erhalten, wählen Sie Ihr Projekt unter https://dialogflow.cloud.google.com/cx/projects/.
  2. Klicken Sie auf die drei Punkte rechts neben Ihrem:Ihrer Agenten:Agentin.
  3. Klicken Sie auf Namen kopieren und fügen Sie diesen Inhalt in einen Editor ein. Die UUID am Ende dieser Zeichenfolge ist die benötigte Agenten-ID: projects/<your-Dialogflow-project>/locations/<location> /agents/<agent-ID>.
  4. Fügen Sie den Inhalt in VIER Cognitive Voice Gateway unter Projekte > Projekt > Projekt anlegen > Bot > Vorlage > Dialogflow CX > Agent:in ein.
  1. Die ID wurde eingefügt.

So importieren Sie Anmeldeinformationen aus Dialogflow CX oder Dialogflow ES via JSON-Datei:

Voraussetzungen

  1. Sie haben ein Google-Dialogflow-Dienstkonto erstellt und konfiguriert.
  2. Sie haben in der Google-Cloud-Platform-Konsole ein neues Projekt erstellt.
  3. Sie haben in der Google-Cloud-Platform ein Dienstkonto für das Projekt erstellt.
  4. Sie haben mindestens die Rolle Dialogflow Service Agent zugewiesen, um die Intent-Erkennung zu ermöglichen.
  5. Sie haben einen Dienstkonto-Schlüssel erstellt und die JSON-Version davon heruntergeladen.
  1. Klicken Sie auf Lade Zugangsdaten aus JSON-Datei.
  2. Wählen Sie im Dateimanager Ihre gewünschte JSON-Datei. Diese JSON-Datei enthält die für die Integration mit VIER Cognitive Voice Gateway erforderlichen Anmeldeinformationen.
  3. Klicken Sie Öffnen.
  1. Sie haben die Anmeldeinformationen in VIER Cognitive Voice Gateway importiert.