Leitfäden schreiben und veröffentlichen

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 .

Nach Ihnen Erstellen Sie einen Leitfaden Mithilfe einer der verfügbaren Optionen zur Erstellung von Anleitungen können Sie Anweisungen hinzufügen oder die vorhandenen Anweisungen auf der Anweisungen Tab.

Erstellen oder Öffnen einer Anleitung

Klicken Sie auf Admin.
Klicken Sie unter AI Studio auf Anleitungen .
Klicken Speisekarte > Orchestrierung > AI Studio > Anleitungen .
Um nach einem bestimmten Leitfaden zu suchen, geben Sie den Namen des Leitfadens in das Suchfeld ein. Während Sie tippen, werden die passenden Hilfslinien angezeigt.
Um eine Anleitung zu öffnen, klicken Sie auf ihren Namen.
Wählen Sie die Anweisungen Tab.
Im Anweisungen Mit der Tabulatortaste können Sie die Schritte der Anleitung hinzufügen oder ändern.

Schreiben Sie Anweisungen für den Leitfaden

Befolgen Sie beim Schreiben und Formatieren Ihrer Anweisungen diese grundlegenden Richtlinien:

Gestalten Sie Ihren Leitfaden so, dass er sich auf eine einzige Aufgabe oder Absicht konzentriert.
Teilen Sie Ihre Aufgabe in Haupt- und Teilschritte auf. Diese Art der Strukturierung stellt sicher, dass Ihr KI-Agent den Kontext und die Referenz versteht, wenn Sie ihn auffordern, zwischen Schritten zu springen.
1. Weisen Sie jedem Hauptschritt einen eindeutigen Namen zu. Wählen Sie einen Namen, der eine genaue Beschreibung dessen liefert, was innerhalb des Schritts und seiner Teilschritte geschieht.
2. Verwenden Sie die verfügbaren vordefinierten Befehle als Bausteine für Ihre Anleitung.

Vordefinierte Befehle

Notiz : Schreiben Sie den Befehlsnamen auf Englisch; der Rest der Befehlssyntax kann jedoch in jeder unterstützten Sprache der Stufe 1 erfolgen. Zum Beispiel,

- Say "Bienvenido al registro de nuestro Programa de Lealtad {{Variable.programa_lealtad}}. Te guiaré a través del proceso."

Befehl	Nutzungsbeschreibung	Syntax	Beispiele
Sagen	Mit diesem Befehl können Sie eine Ausgabenachricht eingeben, die der KI-Agent an den Benutzer senden muss. Dazu gehören einfache Variablen, die im Leitfaden erfasst oder vom Datenfluss als Eingabe an den Leitfaden übergeben werden.	`- Say "Exactly what you want the AI agent to say”`	`- Say "Welcome to ACME insurance."` Oder `- Say "Your current rewards balance for your card_type is points_balance points."` Oder `- Say "Hello contact_username."`
Fragen	Verwenden Sie diesen Befehl, um eine Eingabe vom Benutzer anzufordern. Sie können auch einfache Variablen einbeziehen. Der KI-Agent kann dem Benutzer beispielsweise Fragen stellen, indem er dessen Namen verwendet oder auf zuvor getroffene Entscheidungen Bezug nimmt. A Store statement must always follow the Ask command to save customers’ answers as variables. You can use these variables later in the guide, for example, to call a data action or to pass values to an Architect flow.	`- Ask "The question that your AI agent must ask"` `- Store in {{Variable name}} [ { and \| , } ... ]`	`- Ask "Please provide the email address."` `- Store in email_address` Oder `- Ask "Are you sure you want to book a flight to trip_destination?"` `- Store in booking_confirmation`
Ask and Confirm	Use this command to request input from the user and then confirm that the provided value is correct. It works like an Ask command, but includes a confirmation step that allows the user to revise their answer if their initial input is incorrect. This command supports all types of variables. A Store statement must always follow the Ask and Confirm command to save customers’ confirmed answers as variables. You can use these variables later in the guide, for example, to call a data action or to pass values to an Architect flow.	`- Ask and Confirm "The question that your AI agent must ask"` `- Store in {{Variable name}} [ { and \| , } ... ]`	Example A with single variable: `- Ask and Confirm "Can you please provide your order number?"` `- Store in order_number` Example B with multiple variables: `- Ask and Confirm "Can you please provide your order number and email address?"` `- Store in order_number and email_address`
Anruf	Mit diesem Befehl rufen Sie eine Datenaktion mit Eingabeparametern auf und speichern die Ausgabe in Variablen. Wenn mehrere Parameter aufgerufen werden sollen, können diese durch Kommas und andere Trennzeichen gekennzeichnet werden. Wenn Sie die Ausgabe speichern möchten, können Sie anschließend den Befehl „Store“ verwenden. Aktuell werden Datenaktionen unterstützt, die einfache Datentypen wie Zeichenketten, Zahlen und boolesche Werte zurückgeben.	`- Call [Data action name] with [variable name]`	`- Call VerifyUserDetails_Action with card_type` `- Call VerifyCustomer_Action with customer_ID and customer_email` Beispiel A mit Store: `- Call VerifyUserDetails_Action with card_type` `- Store in verification_status` Beispiel B mit Geschäft: `- Call VerifyCustomer.Action with customer_ID and customer_email` `- Store in verification_status`
Speichern	Use this command to save data to variables. You can then use the variables in other areas of the guide. You can store multiple variables at a time from Ask, Ask and Confirm, and Call commands. Notiz : Eine genaue Beschreibung der Variablen ist wichtig. Aktualisieren Sie diese Beschreibungen in der Variablen Tab.	`- Store in {{Variable name}} [ { and \| , } ... ]`	`- Store in variable_name` Oder `- Store in variable1_name and variable2_name`
Gehe zu	Mit diesem Befehl können Sie zu einem anderen Schritt in der Anleitung navigieren. Stellen Sie sicher, dass Sie die Schrittnamen korrekt zuordnen.	`- Go To [step_name]`	`- Go To Email Collection` Oder `- Go To Escalation`
If:Then:Else	Verwenden Sie diesen Befehl, um bedingte Verzweigungslogik auszuführen. Es ermöglicht Ihnen, den KI-Agenten je nach den Antworten des Kunden auf unterschiedliche Pfade zu lenken. Die If-Bedingung muss eine Aussage sein, die entweder wahr oder falsch ist, und sie muss von einer Then-Anweisung gefolgt werden. Die Else-Anweisung ist optional.	Ohne Else-Anweisung: `- If CONDITION` `- Then Go To [step_name]` Mit der Else-Anweisung: `- If CONDITION` `- Then Go To [step_name]` `- Else Go To [Other_step_name]`	`- If router_model == "A100"` `- Then Go To Troubleshoot A100` Oder `- If router_model is A100` `- Then Go To Troubleshoot A100` Oder `- If is_VIP_customer is true` `- Then Go To VIP Customer Handling` `- Else Go To Standard Customer Handling` Oder `- If customer is a VIP type` `- Then Go To VIP Customer Handling` `- Else Go To Standard Customer Handling` Oder `- If account_type == Checking` `- Then Go To Checking Balance` `- If account_type == Savings` `- Then Go To Savings Balance` `- Else Go To Other Account Balance`
Beendet	Verwenden Sie diesen Befehl, um die Ausführung des Leitfadens zu beenden. Standardmäßig endet der Leitfaden, wenn es nichts mehr zu tun gibt. Dieser optionale Befehl ermöglicht es Ihnen jedoch, Folgendes festzulegen den Exit-Status oder die Weiterleitung bestimmter Antworten zu spezifischen Exit-Pfaden.	`- Exit with { Completion \| Failure \| Escalation }`	`- Exit with Completion` Oder `- Exit with Escalation`

Formatierung von Befehlen

Um die Zuverlässigkeit und Konsistenz der Anleitungen zu verbessern, stellen Sie sicher, dass jede Befehlszeile mit einem Bindestrich (-) gefolgt von einem Leerzeichen beginnt. Außerdem muss der erste Buchstabe des Befehls großgeschrieben sein.

Beispiel

...
– Say “text”
...
– Ask and Confirm “text”
...

Durch die Generierung einer Anleitung mithilfe einer KI-gestützten Eingabeaufforderung oder eines Dokumenten-Uploads werden Anweisungen in diesem Format erstellt.

Alle Abschnitte (Hauptschritte) im Leitfaden müssen eine Überschrift haben, zu der der KI-Agent navigieren kann. Weitere Richtlinien und bewährte Vorgehensweisen zum Verfassen von Anleitungen finden Sie unter Bewährte Methoden zum Schreiben von Leitfäden Die

Zeigen Sie mir

Variable hinzufügen

Erstellen Sie einen Leitfaden oder öffnen Sie einen vorhandenen.
Wählen Sie die Variablen Tab.
Im Variablen Tab, Leitvariablen erstellen die Sie in Ihrem Handbuch verwenden möchten.
Wählen Sie die Anweisungen Tab.
Im Anweisungen Drücken Sie die Tabulatortaste, platzieren Sie den Cursor an der Stelle, an der Sie eine Variable einfügen möchten, und geben Sie / ein. In einem Dialogfeld werden alle verfügbaren Variablen angezeigt.
Wählen Sie die gewünschte Variable aus.

Der Editor hebt Variablen in Ihrem Leitfaden durch einen grauen Hintergrund hervor.

Zeigen Sie mir

Datenaktionen hinzufügen

Sie können Ihrem Leitfaden eine zuvor konfigurierte Datenaktion hinzufügen. Weitere Informationen zum Erstellen einer benutzerdefinierten Datenaktion finden Sie unter Erstellen Sie eine benutzerdefinierte Aktion für Integrationen .

Erstellen Sie einen Leitfaden oder öffnen Sie einen vorhandenen.
Wählen Sie die Anweisungen Tab.
Im Anweisungen Drücken Sie die Tabulatortaste, platzieren Sie den Cursor an der Stelle, an der Sie eine Datenaktion einfügen möchten, und geben Sie / ein. In einem Dialogfeld werden alle verfügbaren Datenaktionen angezeigt.
Wählen Sie die gewünschte Datenaktion aus.

The editor emphasizes variables present in your guide with a gray background and the data action icon . For more information about how to use data actions in guides, see Connect guides to external services with data actions.

Zeigen Sie mir

Speichern und veröffentlichen Sie den Leitfaden

Wenn Sie mit der Bearbeitung fertig sind, klicken Sie auf Speichern , um die Anleitung als Entwurf zu speichern.
Führen Sie den Guide-Checker aus. Falls die Überprüfung Syntaxfehler meldet, beheben Sie diese. Weitere Informationen zum Reiseführer-Prüfer finden Sie unter Überprüfen Sie Ihren Leitfaden mithilfe des Prüfers. Die
Klicken 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, aber Sie können neue Variablen hinzufügen.
Wenn Sie eine Anleitung veröffentlichen, die bereits mit einem Architect-Bot-Flow verknüpft ist, der mit Virtual Agent aktiviert ist, aktualisiert der Flow sofort seine Konfiguration, um während seiner Ausführung die zuletzt veröffentlichte Anleitung aufzurufen.
Die Leistung des virtuellen Agenten kann je nach Sprache variieren. Genesys empfiehlt, vor der Live-Schaltung mit bevorzugten Programmiersprachen zu testen.
Wenn Sie einen Leitfaden veröffentlichen, führt der Redakteur automatisch die Leitfadenprüfung durch. Bevor Sie den Leitfaden veröffentlichen können, müssen Sie alle vom Prüfprogramm angezeigten Fehler beheben. Außerdem werden Sie jedes Mal, wenn Sie die Anleitung ändern und speichern, aufgefordert, die Überprüfung erneut auszuführen.

Nach der Veröffentlichung eines Leitfadens können Sie diesen mit einem Architect-Bot-Flow oder einem digitalen Bot-Flow verbinden, der mit Virtual Agent aktiviert ist, indem Sie die Aktion „Leitfaden aufrufen“ verwenden. Weitere Informationen finden Sie unter Verknüpfen Sie Guides mit Ihren Virtual Agent-Flows. Die Weitere Informationen zum Duplizieren oder Löschen einer Anleitung finden Sie unter Anleitungen duplizieren oder löschen Die