Evidence Tree – Interaction History

Interaction History

A map’s interaction history will provide more comprehensive information about queries that are run against the map than the map’s invocation statistics, which only records the volume of queries that have started or finished.

When viewing a map’s interaction history, you will be able to see a record of:

  • when a query is started
  • any facts that have been injected
  • any facts retrieved by datasources
  • any questions Rainbird has asked
  • any responses that were given by the end user
  • any undo operations (when an end user selects the ‘Back’ button)
  • any answers Rainbird has returned. 

While invocation statistics are always captured and cannot be disabled by a user, interaction history can be enabled and disabled by knowledge authors on a per map version level. By default, no interaction history will be recorded.

To enable interaction history collection for a given version or versions, knowledge authors must version the knowledge map and then on the ‘Live Version’ screen under the ‘Publish’ tab, select the ‘Record interactions’ checkbox next to the version you wish to record interaction history for.

Figure 1: Deselecting the checkbox will no longer record interactions

Note: Unless a version is made ‘Live’, interaction histories will be captured against the draft version.

The interaction history can be viewed in the ‘Stats & Reporting’ section of the ‘Publish’ tab. It gives a detailed review of the interaction that has occurred in any given query session and is available to download.

Figure 2: Interaction history lives under the ‘Stats & Reporting’ section of the publishing tab

In the ‘Stats & Reporting’ tab, the columns in the interaction history table are as follows:

  • Date – the date when the query was started
  • Version – the version number or ‘Draft’
  • Subject – the query subject (limited to 42 characters)
  • Relationship – the query relationship (limited to 42 characters)
  • Object – the query object (limited to 42 characters)
  • Flag – a priority flag

With the exception of the Flag column, the columns can be sorted, and with the exception of the date column, the columns can be filtered.

The Version column filter allows the knowledge authors to specify a particular version number or ‘Draft’.

The Subject, Relationship, Object and Flag column are select boxes. They allow authors to choose a single predefined filter option. In the case of Subject, Relationship and Object this will be based on the instance values.

Within Subject and Object there are two special values ‘- All -’ and ‘- Empty Value -’. ‘All’ removes the filter restriction and ‘Empty Value’ applies the filter to null data entries such as when only a partial query triple is provided.

The flags are colour coded and allow knowledge authors to use them in whichever way they desire, for example, to indicate priority or flag attention to queries that require investigation.

Figure 3: Interaction History screen

Clicking on a given row in the interaction history table will bring up details of the entire session that the query was a part of:

Figure 4: Detailed query breakdown

A copy of the interaction can be downloaded by clicking the ‘Export to CSV‘ button.

The central column contains ‘chips’ representing the different events that occurred in the interaction. A timestamp will be provided for the first and last chip and additionally for any chip where there has been a gap of more than 30 seconds since the prior event.

Questions asked in the query are indicated by italics, and both questions and responses are a slightly bolder weight than the other events to help the author to focus on question/response events.

To avoid large chips some information is initially hidden from view. If this is the case the chip will be marked with a flag to the right of the chip indicating what additional information is available e.g. ‘2 known answers’.

Possible flags are:

  • Question has known facts.
  • Has too many responses (from the end user) to display.
  • Chip is an injection.
  • Chip is a datasource.
  • Result has too many answers to display.

If a chip with a flag is clicked an additional box will appear to the left of the chip stack with that information.

Clicking on the Injection extra info flag should display:

  • The injected facts

Clicking on the Datasource extra info flag should display:

  • The facts created by the API call

Each question can also be clicked on to see further question details:

Figure 5: Clicking on a question will display additional information about the question

Question details include:

Version 1.02 – Last Update: 04/05/2021