Anstelle des Übergangs return, um das Ende einer vollständigen Unterhaltung zu markieren, können Sie stattdessen mit der Eigenschaft insightsEndConversation die Stelle markieren, an der die Aufzeichnung der Unterhaltung für Insights-Berichte gestoppt werden soll. Mit dieser Eigenschaft können Sie den Schwerpunkt auf die Aspekte des Dialogablaufs legen, an denen Sie interessiert sind. Beispiel: Eine Unterhaltung muss möglicherweise nur bis zu der Stelle aufgezeichnet werden, an der ein Kunde eine Bestellung storniert, aber nicht danach (keine nachfolgenden Bestätigungsnachrichten oder Optionen, die die Unterhaltung verzweigen). Standardmäßig ist diese Eigenschaft auf false gesetzt. Das heißt, Insights führt die Aufzeichnung so lange fort, bis ein return-Übergang auftritt oder bis die Eigenschaft insightsEndConversation auf true (insightsEndConversation: true) gesetzt ist.

  cancelOrder:
    component: "System.Output"
    properties:
      text: "Your order is canceled."
      insightsEndConversation: true 
    transitions:
      next: "intent"

Da dieses Flag ändert, wie eine abgeschlossene Unterhaltung im Insights-Reporting angezeigt wird, ist die Anzahl der Unterhaltungen nach der Einführung dieses Flags im Dialogablauf möglicherweise nicht mit der Anzahl der Unterhaltungen für vorherige Versionen des Skills vergleichbar.

Mit der Eigenschaft insightsInclude können Sie Statusangaben, die Sie als überflüssig betrachten, von der Aufzeichnung in den Berichten ausschließen. Um einen Status aus dem Insights-Reporting auszuschließen, setzen Sie diese Eigenschaft auf false:

...
  resolveSize:
    component: "System.SetVariable"
    properties:
      variable: "crust"
      value: "${iResult.value.entityMatches['PizzaSize'][0]}" 
      insightsInclude: false      
    transitions:
      ...
...

Diese Eigenschaft gilt nur für das Insights-Reporting. Sie verhindert nicht, dass Statusangaben im Tester gerendert werden.

Der Status ShowMenu des CrcPizzaBot-Skills mit den Übergängen pizza, pasta und textReceived ist ein Beispiel für einen derartigen Status:

  ShowMenu:
    component: "System.CommonResponse"
    properties:
      processUserMessage: true
      metadata:
        responseItems:
          - type: "text"
            text: "Hello ${profile.firstName}, this is our menu today:"
            footerText: "${(textOnly.value=='true')?then('Enter number to make your choice','')}"
            name: "hello"
            separateBubbles: true
            actions:
              - label: "Pizzas"
                type: "postback"
                keyword: "${numberKeywords.value[0].keywords}"
                payload:
                  action: "pizza"
                name: "Pizzas"
              - label: "Pastas"
                keyword: "${numberKeywords.value[1].keywords}"
                type: "postback"
                payload:
                  action: "pasta"
                name: "Pastas"
    transitions:
      actions:
        pizza: "OrderPizza"
        pasta: "OrderPasta"
        textReceived: "Intent"

Wenn Sie die Eigenschaft insightsEndConversation: true dem Status ShowMenu hinzufügen, können Sie das Reporting nach folgenden Übergängen aufgliedern:

  ShowMenu:
    component: "System.CommonResponse"
    properties:
      processUserMessage: true
      insightsEndConversation: true
…

Aufgrund der Eigenschaft insightsEndConversation: true betrachtet Insights jede weitere Interaktion, die durch die Übergänge pizza, pasta oder textReceived aktiviert wird, als separate Unterhaltung. Das bedeutet, dass auf der Seite "Überblick" unter der Metrik "Unterhaltungen" zwei Unterhaltungen anstelle von einer gezählt werden. Außerdem werden im Bericht "Unterhaltungen" zwei separate Einträge erstellt. Der erste Eintrag gilt für den Ausführungspfad des ShowMenu-Intents, in dem die Unterhaltung mit dem Status ShowMenu endet.

Der zweite ist der übergangsspezifische Eintrag, der ein Intent benennt, wenn die Aktion textReceived ausgelöst wurde, oder "Kein Intent", wenn kein zweites Intent im Spiel ist. Wenn Sie im Listenmenü, das für den Status showMenu angezeigt wird, die Option "Pizzas" oder "Pastas" auswählen, enthält der Unterhaltungsbericht einen Eintrag ShowMenu und einen Eintrag "Kein Intent" für die Übergangsunterhaltung, weil der Benutzer keinen Text eingegeben hat, der in ein Intent aufgelöst werden musste.

Wenn Sie jedoch den Übergang textReceived durch Eingabe von Text auslösen, benennt der Bericht "Unterhaltung" das aufgelöste Intent (OrderPizza, OrderPasta).

Der Knoten states des Skills CrcPizzaBot beginnt mit einer Reihe von System.SetVariable-Status. Da diese Zustände am Anfang der Definition positioniert sind, beginnen sie mit der Wiedergabe jedes Pfads, wenn Sie sie nicht mit der Option "Status filtern" ausgeschlossen haben. Sie können solche Zustände als überladen betrachten, wenn Sie sich stattdessen auf die Transaktionsaspekte des Pfades konzentrieren. Sie können die Pfadwiedergabe manuell über das Menü "Status filtern" oder durch Hinzufügen der Eigenschaft insightsInclude: false zur Dialogablaufdefinition vereinfachen.

Sie können die Eigenschaft insightsInclude: false zu einem beliebigen Status hinzufügen, den Sie nicht im Paths-Bericht anzeigen möchten.

  setTextOnlyChannel:
    component: "System.SetVariable"
    properties:
      insightsInclude: false
      variable: "textOnly"
      value: "${(system.channelType=='webhook')?then('true','false')}"
  setAutoNumbering:
    component: "System.SetVariable"
    properties:
      insightsInclude: false
      variable: "autoNumberPostbackActions"
      value: "${textOnly}"
  setCardsRangeStart:
    component: "System.SetVariable"
    properties:
      insightsInclude: false
      variable: "cardsRangeStart"
      value: 0
    transitions:
      ...
...

Wenn Sie für CRCPizzaBotSkill die Eigenschaft insightsInclude: false zu jedem der Status System.SetVariable hinzufügen, werden die Transaktionsstatus am Anfang des Pfades platziert.