Umfassende Standardsteuerelemente für Eingabe und Ausgabe für eine anwenderdefinierte Chat-Integration

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • Umfangreiche Eingaben- und Ausgabesteuerungen müssen Ihrer anwenderdefinierten Chat-Integration in der Tabelle „Anwenderdefinierte Adapterkonfigurationen“ [sys_cs_custom_Adapter_config] zugeordnet werden. Wenn einer umfassenden Steuerung eine ausgehende Umwandlerimplementierung fehlt, wird dem Endanwender keine Antwort zugestellt, und dieser Anwender erhält möglicherweise eine unbefriedigende Chat-Experience.

    Die folgenden Standard-Rich-Steuerungen sind Eingabe- und Ausgabe-Rich-Steuerungen zugeordnet. Die uiTypeParameter bezieht sich auf ein Themensteuerelement, das zum Erstellen von Konversationen in verwendet wird Virtual Agent-Designer.

    Tabelle : 1. Umfassende Standardsteuerungen für Eingabe und Ausgabe
    Umfassende Kontrolle Beschreibung
    ActionRichControl Diese Komponente verarbeitet die verschiedenen Ereignisse und Aktionen, die in einer Konversation auftreten. Einige Aktionen gelten möglicherweise nicht für alle Kanäle. Beispielsweise wird StartSpinnerActionMsg in SMS ignoriert.

    ServiceNow® Virtual Agent Erstellt die folgenden Arten von Aktionsnachrichten über dieses Framework. Die anwenderdefinierte Chat-Schnittstelle erkennt nur bestimmte Aktionsmeldungstypen.

    • SeparatorActionMsg ||actionMsg-Instanz
    • SystemActionMsg ||actionMsg-Instanz von
    • TopicFinishedActionMsg ||actionMsg-Instanz von
    • SwitchToVirtualAgentActionMsg ||actionMsg-Instanz von
    • SwitchConversationActionMsg ||actionMsg-Instanz von
    • ChatSubHeaderActionMsg ||actionMsg-Instanz
    • StartSpinnerActionMsg ||actionMsg-Instanz von EndSpinnerActionMsg
    • SubscribetoSupportQueue ||actionMsg instanceof
    • SubscribeToChatPresence ||actionMsg-Instanz von
    • SwitchToLiveAgentActionMsg ||actionMsg-Instanz von

    ActionRichControl umschließt diese Nachrichten in actionMsgElement. Daher kann ein einzelner ausgehender Umwandler für ActionRichControl alle diese Nachrichten verarbeiten. Für diese Komponente ist kein eingehender Umwandler erforderlich.
    agentInfo Parameter Wenn die umfassende Steuerung von einem Servicemitarbeiter gesendet wird, dann wird agentInfoAttribut wird der Rich-Steuerung hinzugefügt.
    Beispiel:
    {
     uiType: "someType",
     group: "someGroup"
     agentInfo: { sentFromAgent: true }  // please note that this object may contain more info in subsequent releases.
     ...
}
    Standardauswahl Ordnet zu zu Dateiauswahl , Themenauswahl und Boolescher Wert Steuerungen.
    Beispiel:
    {
    uiType: "Picker/TopicPicker/Boolean",
    group: "DefaultPicker",  
    nluTextEnabled: true/false,
    promptMsg: "", // optional (needed for TopicPicker)
    label: "The question for the list",   // always filled
    itemType: "Picture/List"  // needed to user key to expect picture attached
    options: [
        {
            label: "display label prompt",
            value: "the value required to satisfy the question",
            description: "a description of value_1 item"
	    attachment: "www.foo",
            enabled: true/false
        }, 
	...
    ]
}

    Optional orderMit dem Parameter können Sie die Reihenfolge angeben, in der heraufgestufte Themen angezeigt werden sollen. Zum Beispiel:

    "options": [
    {
      label: "Check IT Ticket Status",
      value: "55720b465bf0201024f11fc40a81c72d",
      order: 100,
      enabled: true
    },
    {
      label: "Live Agent Support",
      value: "ce2ee85053130010cf8cddeeff7b12bf",
      order: 200,
      enabled: true
    },
    {
      label: "Open IT Ticket 2",
      value: "2a46cffbc7602010v088bbf603c260a7",
      order: 300,
      enabled: true
    }
]
    Standardtext Ordnet zu zu Eingabetext , Ausgabetext Steuerungen für , und Dateiupload.
    Beispiel:
    {
    uiType: "InputText/OutputText/FileUpload/Picture",
    group: "DefaultText", 
    required: true/false,
    nluTextEnabled: true/false,
    itemType: "file/image/inputtext/outputtext",
    maskType: "SECURE/SENSITIVE/NONE"  // null except for InputText/OutputText
    label: "The Question?"        
}
    Standarddatum Ordnet zu zu Datum und Uhrzeit Steuerungen.
    {
    uiType: "Date/DateTime/Time",
    group: "DefaultDate", 
    required: true/false,
    nluTextEnabled: true/false,   
    label: "The Question?"
     
}
    DefaultOutputLink Ordnet zu zu Link-Antwort Steuerungen.
    Beispiel:
    {
    uiType: "OutputLink",
    group: "DefaultOutputLink",
    label: "link label",
    header: "link header",
    type: "link",
    value: {
        action: "www.foo",
    }	
}
     
}
    DefaultOutputImage Ordnet zu zu Image-Antwort Steuerungen.
    Beispiel:
    {
    uiType: "OutputImage",
    group: "DefaultOutputImage",
    value: "www.foo"
}
    Standardausgabekarte Ordnet zu zu Kartenantwort Steuerungen.
    Beispiel:
    {
    uiType: "OutputCard",
    group: "DefaultOutputCard",
    templateName: "Card",
    data: "some json data string"
}
    StandardausgabeHtml Ordnet zu zu HTML-Antwort Steuerungen.
    Beispiel:
    {
    uiType: "OutputHtml",
    group: "DefaultOutputHtml",
    style: "inline",
    height: 100,
    width: 100,
    value: "<div>html</div>"
}
    DefaultOutputTable Ordnet zu zu Tabellenantwort Steuerungen.
    Beispiel:
    {
    uiType: "OutputTable",
    group: "DefaultOutputTable",
    label: "Table Title",
    headers: ["Column 1", "Column 2"],
    navigationBtnLabel: "See next",
    data: [
        ["foo1", "foo2"],
        ["bar1", "bar2"]
    ]
}
    DefaultGroupedPartsOutputControl Ordnet zu zu Mehrfachantwort Steuerungen.
    Beispiel:
    {
    uiType: "GroupedPartsOutputControl",
    group: "DefaultGroupedPartsOutputControl"
    groupPartType: "Link",
    header: "header message",
    values: [
	{
	    action: "www.foo",
	    description: "description",
	    label: "link_1 label",
	    context: "ITSM"
	},
	...
    ]
}
    DefaultMultiPartOutput Ordnet zu zu Mehrfachantwort Steuerungen.
    Beispiel:
    {
    uiType: "MultiPartOutput",
    group: "DefaultMultiPartOutput"
    navigationBtnLabel: "Go next",
    content: {
        uiType: "OutputHtml",
        style: "inline",
        type: "html",
        height: 100,
        width: 100,
        value: "<div>html</div>"
     }
}
    StandardCustomControl Ordnet zu zu Anwenderdefinierte Steuerungen .
    Beispiel:
    {
    uiType: "CustomControl",
    group: "DefaultCustomControl",
    name: "The name of the Custom Control (sys_cs_custom_control.name)",
    required: true/false,
    uxComponentDefinitionSysId: "seismicComponentId" // or null if not
    isInput: true/false, // whether to wait for a response value or if just output
    serializedControlData: "User defined JSON from generateControlData function";    
}