Variablen in Anleitungen

Voraussetzungen 
  • Virtueller Agent aktiviert in Ihrer Organisation. Für weitere Informationen wenden Sie sich bitte an Ihren zuständigen Customer Success Manager. .
  • AI Studio-Berechtigungen für Guides. Weitere Informationen zu allen erforderlichen Berechtigungen finden Sie unter AI Studio-Berechtigungen . 

Eine Guide-Variable ermöglicht es Ihrem KI-Agenten, Informationen innerhalb des Guides weiterzugeben. Nutzen Sie beispielsweise Verweise zwischen den Schritten im Leitfaden und tauschen Sie während des Gesprächs Daten mit Architect Flows aus, um die Interaktion des Kunden dynamischer zu gestalten.

Erstellen Sie Leitvariablen

  1. Klicken Sie auf Admin.
  2. Klicken Sie unter AI Studio auf Anleitungen . 
  3. Klicken Speisekarte > Orchestrierung > AI Studio > Anleitungen .
  4. Öffnen Sie eine vorhandene Anleitung oder erstelle ein neues .
  5. Öffnen Sie das Variablen und klicken Sie auf Erstellen . Das Fenster „Variable erstellen“ wird geöffnet.
  6. Führen Sie unter „Variable erstellen“ folgende Schritte aus:
    1. Im Name Geben Sie im Feld einen Variablennamen ein.
      Notiz: Die maximale Länge eines Variablennamens beträgt 80 Zeichen.
    2. vom Datentyp Wählen Sie aus der Liste einen der folgenden Datentypen aus:
      • Zeichenkette : Eine Standardtextzeichenfolge.
      • Boolean: Ein Boolescher Wert kann nur einen von zwei Werten haben: wahr oder falsch.
      • Nummer : Eine Zahl umfasst beliebige numerische Werte, einschließlich Dezimalzahlen.
      • Integer: Eine Ganzzahl ist eine ganze Zahl wie 987 oder 5.
        Notiz : Stellen Sie sicher, dass der Datentyp korrekt mit den beabsichtigten Werten übereinstimmt. Dieses Verhalten verbessert die Genauigkeit des großen Sprachmodells (LLM) bei der Identifizierung und Sammlung von Informationen.
         
    3. Im Beschreibung Geben Sie im Textfeld eine einfache und klare Beschreibung ein. Sie können auch ein Beispiel für die Daten angeben, die Sie in der Variablen speichern möchten. Eine Policennummer ist beispielsweise eine eindeutige Kennung im Format „XXX-####-YY##“.
    4. vom Verfügbarkeit Wählen Sie aus der Liste die passende Datenübertragungsrichtung aus. 
      • Eingang : Verwenden Sie diese Richtung, um Daten an den Architect-Flow zu senden. 
      • Ausgabe : Verwenden Sie diese Richtung, um Daten vom Architect-Flow zu empfangen. 
      • Eingang & Ausgang : Mit dieser Option können Sie Daten an den Architect-Flow senden oder von ihm empfangen.
        Notiz : Bei allen im Leitfaden verwendeten Informationen kann die Richtung sowohl Eingabe als auch Ausgabe sein.
  7. Klicken Erstellen . Sie können diese Variable jetzt in Ihren Anleitungen verwenden.

Beispiele und Beschreibungen von Variablen

Betrachten wir eine Variable = Variablenname + Beschreibung + Datentyp [+ Eingabe-/Ausgabeklassifizierung] Die Die Variable muss einen aussagekräftigen Namen, eine klare Beschreibung und einen geeigneten Datentyp haben, um sicherzustellen, dass der KI-Agent sie versteht und richtig verwendet.

Wenn Sie beispielsweise eine Reservierungsnummer erfassen möchten, funktioniert SEQ_1 + 8-stellige Zahl + Zeichenkette möglicherweise nicht wie erwartet. Stattdessen ist die Kombination aus Reservierungsnummer + 8-stelliger Reservierungsnummer zur Identifizierung der Buchung + numerischer Zeichenfolge besser geeignet, da sie dem KI-Agenten mehr Kontext darüber liefert, welche Daten er erfassen muss.

Stellen Sie sicher, dass der Datentyp der Variablen Ihren Geschäftsanforderungen entspricht.

Wichtig : Bei Verwendung der Eingabeaufforderungsgenerierung erstellt der Leitfaden Variablen, um die von Ihnen gestellte Aufgabe zu erfüllen. Sie müssen jedoch sicherstellen, dass Variablenname, Beschreibung und Typ Ihren Geschäftsanforderungen entsprechen.

Wenn Sie beispielsweise einen Reservierungscode erfassen möchten, der numerisch oder eine Zeichenkette sein kann, wählen Sie den entsprechenden Datentyp je nach Ihren Anforderungen aus.

  • Numerisch – 12345
  • String – 1234Oct

Wenn der Variablentyp für eine Zeichenkette auf numerisch eingestellt ist, kann der Leitfaden dies nicht erfassen, da der KI-Agent dies als falsche Information (vom Kunden) interpretiert.

Notizen:
  • Sobald Sie einen Leitfaden veröffentlicht und ihn mit einem Architect-Workflow verbunden haben, werden die Variablen gesperrt und Sie können dann nur noch deren Beschreibungen aktualisieren. Wenn Sie wesentliche Änderungen an der Variablen vornehmen müssen, z. B. an ihrem Datentyp, müssen Sie eine neue Variable erstellen oder die vorhandene duplizieren, um sie bearbeiten zu können.
  • Sie können Ihre Variable als Eingabe, Ausgabe oder beides klassifizieren. Bei allen im Leitfaden verwendeten Informationen kann die Richtung sowohl Eingabe als auch Ausgabe sein.
    • Eingang : Gibt die Informationen an, die Sie in den Reiseführer aufnehmen oder im Reiseführer verwenden möchten.
    • Ausgabe : Gibt die Informationen an, die Sie im Leitfaden speichern oder versenden möchten.
  • Wenn Ihre Zeichenkettenvariable eine Reihe spezifischer Optionen darstellt, empfiehlt es sich, diese in der Beschreibung oder der Frage anzugeben. Wenn Sie angeben, dass eine Option oder ein Wert aus der vorgegebenen Liste stammen muss, fordert der KI-Agent den Kunden auf, aus dieser Liste auszuwählen.
  • Achten Sie darauf, dass Sie die Datumsangaben korrekt formatieren. KI-Agenten sind nicht datumsbewusst, wenn man ihnen das aktuelle Datum nicht mitteilt. Die Frage sollte so angepasst oder formuliert werden, dass sie die Zielgruppe richtig erfasst. 
    • Geben Sie in der Beschreibung das gewünschte Datumsformat an, insbesondere wenn Sie diese Information an eine Datenaktion weitergeben möchten.
    • Beachten Sie, dass Datums- und Währungsangaben bei der Wiedergabe an den Kunden in der jeweiligen Laufzeitsprache lokalisiert werden. Wird der Leitfaden beispielsweise in Australien verwendet, werden die vom LLM generierten Währungssymbole in AUD$ umgerechnet.

Einige weitere Beispiele:

  • company_type: Die Größe des Unternehmens, zum Beispiel klein, mittel oder groß.
  • incident_location: Der Ort, an dem sich der Unfall ereignet hat, der den Versicherungsanspruch geltend gemacht hat, in Form einer Straßenadresse, Stadt und Ort.
  • branch_location: Der Standort der vom Kunden besuchten Filiale kann nur Dublin, Galway oder Cork sein.

    Verwenden von Variablen

    1. Öffnen Sie eine vorhandene Anleitung oder erstellen Sie eine neue.
    2. Im Anweisungen Platzieren Sie den Cursor an der Stelle, an der Sie eine Variable einfügen möchten, und geben Sie / ein. 
      Ein Popup-Dialogfeld mit Optionen zum Einfügen einer Datenaktion oder Variable wird angezeigt.
    3. Wählen Variablen . Das Dialogfeld listet nun die verfügbaren Variablen auf. 
    4. Wählen Sie die benötigte Variable aus. Der Editor hebt Variablen in Ihrem Leitfaden durch einen grauen Hintergrund hervor.
    5. Klicken Speichern , um die Anleitung zu speichern, oder klicken Sie auf Veröffentlichen um den Leitfaden zu veröffentlichen.
      Notizen:
      • Solange sich Ihr Leitfaden im Entwurfsmodus befindet, können Sie bei Bedarf die Leitfadenvariablen ändern. Nach der Veröffentlichung eines Leitfadens können Sie den Namen, den Typ oder die Verfügbarkeit einer bestehenden Variable nicht mehr ändern. Sie können jedoch neue Variablen hinzufügen oder die Beschreibung der bestehenden Variablen bearbeiten.
      • Die maximale Anzahl an Variablen, die in einem einzelnen Leitfaden enthalten sein können, beträgt 50.