--- sourceDocument: Xanadu-Konversations-Schnittstellen sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/conversational-interfaces Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu-Konversations-Schnittstellen ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # Erstellen Sie ein anwenderdefiniertes Virtual Agent Steuerelement # Erstellen Sie ein anwenderdefiniertes Virtual Agent Steuerelement {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer Erstellen Sie ein anwenderdefiniertes Eingabe- oder Antwortsteuerelement, das Themenautoren in Themen oder Themenblöcken verwenden können. In Virtual Agent -Konversationen sammelt ein Eingabesteuerelement Informationen von Endanwendern, während ein Antwortsteuerelement Endanwendern Informationen anzeigt. ## Vorbereitungen [Erstellen Sie die Definition der anwenderdefinierten Steuerung](https://servicenow-prod.fluidtopics.net/32gPwsdWHXChyBtsqAjGlA "Definieren Sie eine anwenderdefinierte Eingabe- oder Antwortsteuerungsdefinition, die einer anwenderdefinierten Komponente zugewiesen ist."). Wichtig: Um sichere (password2) Eingaben in Ihrem anwenderdefinierten Steuerelement Virtual Agent zu implementieren, müssen Sie die Anforderungen für bereichsbezogene Anwendungen in Workflow-Studioerfüllen. Details finden Sie unter [Workflow-Studio bereichsbezogene Anwendungsanforderungen für sichere Eingaben](https://servicenow-prod.fluidtopics.net/OroqhfNJok5Cn4t9_uU0rw "Halten Sie sich an die folgenden bereichsbezogenen Anwendungsanforderungen, um sichere (password2) Eingaben in Ihren Virtual Agent -Themen zu implementieren."). Tipp: Entwickler und Themenautoren müssen möglicherweise auf anwenderdefinierte Steuerungen zugreifen, die in anderen Anwendungsbereichen erstellt wurden. Wie Sie ihnen Zugriff gewähren, erfahren Sie unter [Erstellen Sie bereichsübergreifende Zugriffsrechte für Themenblöcke und anwenderdefinierte Steuerungen](https://servicenow-prod.fluidtopics.net/eLRgXWQ8NEXxXSgD0Au1dw "Ermöglichen Sie Themenautoren und -entwicklern den Zugriff auf Virtual Agent -Themenblöcke und anwenderdefinierte Steuerungen aus anderen bereichsbezogenen Anwendungen."). Erforderliche Rolle: virtual_agent_admin oder admin ## Prozedur 1. Navigieren zu AlleKonversations-SchnittstellenVirtual AgentDesigner. 2. Klicken Sie auf der Seite „Themen" auf + Erstellen. 3. Füllen Sie die Felder des Formulars aus. {#create-custom-control__table_dzy_15h_cmb__entry__2} | Feld | Beschreibung | |-|-| | Typ | Liste der Objekte, die Sie in Virtual Agent-Designererstellen können. Wählen Sie den Typ der anwenderdefinierten Steuerung aus: * Anwenderdefinierte Eingabesteuerung * Anwenderdefinierte Antwortsteuerung {#create-custom-control__ul_yly_pfg_dmb} | | Name | Eindeutiger Name für das anwenderdefinierte Steuerelement, der seinen Zweck widerspiegelt. | | Beschreibung | Kurze Erläuterung des Zwecks und der Funktionalität des Steuerelements. | | Erweiterte Eigenschaften (optional) || | Eingaben schützen \[Nur anwenderdefinierte Eingabesteuerelemente\] || | Aktivieren | Umschalter, mit dem ein anwenderdefiniertes Eingabesteuerelement sichere Eingaben wie Passwörter übergeben kann. | | Verfügbar auf der Palette || | Aktivieren | Umschalter, der bestimmt, ob das anwenderdefinierte Steuerelement als eigenes Symbol im Abschnitt Dienstprogramme der Palette auf der Registerkarte Flow angezeigt wird. Dies bietet anderen Autoren einen einfachen Zugriff auf das Steuerelement. | | Zusätzlich || | Kategorien | Liste der Kategorien. Kategorien identifizieren und gruppieren zugehörige Themen, Themenblöcke oder anwenderdefinierte Steuerelemente. Wählen Sie ggf. eine Kategorie für Ihre Steuerung aus. | [Tabelle : 1. Formular „Eigenschaften".] {#create-custom-control__table_dzy_15h_cmb} 4. Klicken Sie auf Erstellen. Die Registerkarte Flow wird geöffnet und zeigt einen anfänglichen Flow an, der einen anwenderdefinierten Steuerungsknoten enthält. 5. Klicken Sie auf den Startknoten, und definieren Sie die Eingabeparameter für das Steuerelement. Themenautoren stellen diese Eingabeparameter und -werte aus dem aufrufenden Thema bereit. 1. Klicken Sie auf + Hinzufügen. 2. Füllen Sie die Felder des Formulars aus. {#create-custom-control__id_n4c_4sz_gpb__entry__2} | Feld | Beschreibung | |-|-| | Name | Name der Eingabevariablen, die den Eingabewert speichert. | | Typ | Typ der Daten, die an den Themenblock übergeben werden. Zum Beispiel Zeichenfolge, boolescher Wertusw. Die Felder ändern sich entsprechend Ihrer Auswahl. Weitere Informationen finden Sie unter [Eingabedatentypen in Virtual Agent -Themen](https://servicenow-prod.fluidtopics.net/LC3dOEdw6EbL8noqqOKK~A "Sie können Eingaben von häufig verwendeten Glide-Datentypen Virtual Agent (com.glide.cs.chatbot) in Virtual Agent-Designer definieren, ohne ein Skript zu schreiben. Definieren Sie den Eingabedatentyp auf dem Startknoten eines anwenderdefinierten Steuerelements oder Themenblocks."). | | Erforderlich | Option zum Festlegen des Parameters nach Bedarf. | | Tipp | Tooltip, der beim Erstellen eines aufrufenden Themas sichtbar ist. Siehe folgendes Beispiel: | | Tabelle | ServiceNow Tabelle, die zum Abfragen von Eingaben verwendet wird. Dieses Feld ist nur verfügbar, wenn Referenz oder Array.Reference im Feld Typ ausgewählt wird. | | Max. Anzahl von Zeilen | Maximale Anzahl von Zeilen, die der Themenblock definieren darf. Dieses Feld ist nur verfügbar, wenn Array im Feld Typ ausgewählt wird. | | Standardwert | Standardwert für die Variable Dieser Wert kann bei der Vorschau des Blocks verwendet werden. Doppelte Standardwerte sind für Array-Datentypen nicht zulässig. | [Tabelle : 2. Dialogfeld „Eingabe hinzufügen".] {#create-custom-control__id_n4c_4sz_gpb} 3. Klicken Sie auf Speichern. 4. Wiederholen Sie diese Schritte für zusätzliche Parameter. {#create-custom-control__substeps_j5d_fbw_3mb} 6. Klicken Sie auf den Endknoten, und definieren Sie die Ausgabeparameter und -werte, die vom anwenderdefinierten Steuerelement zurückgegeben werden. Themenautoren können den Ausgabewert im aufrufenden Thema verwenden. 1. Klicken Sie auf + Neu hinzufügen. 2. Geben Sie den Namen und Wert des Parameters ein. 3. Wiederholen Sie diese Schritte für zusätzliche Parameter. 4. Klicken Sie auf Speichern. {#create-custom-control__substeps_v3h_mmc_bpb} 7. Klicken Sie auf den Knoten des anwenderdefinierten Steuerelements, und füllen Sie das Eigenschaftsblatt wie folgt aus: * Für ein anwenderdefiniertes Eingabesteuerelement geben Sie [Blatt mit anwenderdefinierten Eingabeeigenschaften](https://servicenow-prod.fluidtopics.net/UJH7VZMsi_E6D_WOETYjDA "Verwenden Sie dieses Blatt, um ein anwenderdefiniertes Eingabesteuerelement in Virtual Agentzu definieren.")ein. * Für eine sichere anwenderdefinierte Eingabesteuerung geben Sie das Feld [Sicheres anwenderdefiniertes Eingabeeigenschaftenblatt](https://servicenow-prod.fluidtopics.net/UtJBlmsr1CG1qJn9pIoafw "Verwenden Sie dieses Blatt, um sichere Eingaben, z. B. ein Passwort, in einem anwenderdefinierten Eingabesteuerelement in Virtual Agentanzugeben.")ein. * Für ein anwenderdefiniertes Antwortsteuerelement geben Sie [Blatt mit anwenderdefinierten Ausgabeeigenschaften](https://servicenow-prod.fluidtopics.net/SCS0rgRwwDiDchccueuDug "Verwenden Sie dieses Blatt, um ein anwenderdefiniertes Antwortsteuerelement in Virtual Agentzu definieren.")ein. 8. Um das Steuerelement zu erstellen, klicken Sie auf Speichern und dann auf Veröffentlichen. {#create-custom-control__steps_egn_xm2_dmb} ## Ergebnisse Wenn Sie in der Palette auf der Seite „Eigenschaften" Verfügbar ausgewählt haben, wird das Symbol „Anwenderdefinierte Steuerung" als eigenes Symbol im Abschnitt „Dienstprogramme" der Palette angezeigt. Das Steuerelement wird auf der Seite „Themen" aufgeführt, und Sie können das Menü Typ verwenden, um nur anwenderdefinierte Steuerelemente anzuzeigen. ## Nächste Maßnahme [Fügen Sie einem Thema oder Themenblock Virtual Agent ein anwenderdefiniertes Steuerelement hinzu](https://servicenow-prod.fluidtopics.net/rJ41Jj21HpNZd_HPS~BgQg "Fügen Sie einem Thema oder Themenblock Virtual Agent ein anwenderdefiniertes Steuerelement hinzu. Während der Konversation können Sie Eingaben von dem Anwender sammeln oder Ausgaben für den Anwender anzeigen.").