t6 Features > Decision Rules

Decision Rules

Sat, Nov 6, 2021 Read in 4 minutes

Decision-Rule is the event-based engine that trigger Actions following matching Conditions. Engine is watching for fact matching conditions on payloads coming from Datapoints POST, and handle Action(s) according to rules.

Tagged on #feature, #resource, #engine, #rules,

Fact measured from datapoint

The fact is actually the payload POSTed to Datapoints endpoint. This contains some attributes that can be used in the matching Conditions

datatype: This can take one of the following value: “integer”, “time”, “date”, “float”, “json”, “geo”, “string”, “boolean” see Data-Types page
datetime
dtepoch: The timestamp
environment: Either “production” or “development” depending on your settings
flow: The Flow uuid-v4
latitude: (optional) latitude coming from your payload
longitude: (optional) longitude coming from your payload
object_id: (optional) Object uuid-v4 from the payload
text: (optional) Object text meta from the payload
value: The measurement/value from the payload

NEWS : Since july 2023, Rules can be sent on the datapoint payload directly hence this is not necessary to use saved rules. This new feature is adding the custom Rule from the payload to the user Rules saved in database.

Conditions matching operators

Conditions supports combination by using all and any boolean operators. This give the ability for Rules to match multiple complex Conditions.

The following Condition will match when a datapoint is POSTed to flow_id cb518da8-xxxx-xxxx-xxxx-95b3b2bbfd8f and only when the environment is “development”.

{
    "all": [
        {
            "fact": "environment",
            "operator": "equal",
            "value": "development"
        },
        {
            "fact": "flow",
            "operator": "equal",
            "value": "cb518da8-xxxx-xxxx-xxxx-95b3b2bbfd8f"
        }
    ]
}

Operators

Operators allows to compare the value of Facts and so determine when the Rule is matching Conditions.

isDayTime: will match only when data-timestamp according to geolocalization is during daylight.

{"all":[{"fact":"dtepoch","operator":"isDayTime","value":true}]}

lastEventGreaterThanInclusive: will match only when last event occurs more than the threashold value in seconds.

{"all":[{"fact":"value","operator":"lastEventGreaterThanInclusive","value":3600}]}

lastEventLessThanInclusive: will match only when last event occurs less than the threashold value in seconds.

{"all":[{"fact":"value","operator":"lastEventLessThanInclusive","value":3600}]}

anomalyGreaterThanInclusive: will match only when measured value is greater than predicted value.

{"all":[{"fact":"value","operator":"anomalyGreaterThanInclusive","value":1234}]}

anomalyLessThanInclusive: will match only when measured value is less than predicted value.

{"all":[{"fact":"value","operator":"anomalyLessThanInclusive","value":1234}]}

changeGreaterThanInclusive: will match only when the difference in time with previous value is greater than threashold value in seconds

{"all":[{"fact":"value","operator":"changeGreaterThanInclusive","value":1234}]}

changeLessThanInclusive: will match only when the difference between in time with previous value is less than threashold value in seconds

{"all":[{"fact":"value","operator":"changeLessThanInclusive","value":1234}]}

sentimentScoreGreaterThanInclusive: Compare the value (must be set as string) with the sentiment score

{"all":[{"fact":"value","operator":"sentimentScoreGreaterThanInclusive","value":2}]}

sentimentScoreLessThanInclusive: Compare the value (must be set as string) with the sentiment score

{"all":[{"fact":"value","operator":"sentimentScoreLessThanInclusive","value":-1}]}

distanceGreaterThan: Return true when the distance (in meters) from the object is farest from the latitude/longitude defined in payload position.

Geofencing special behaviour : distanceGreaterThan operator used in combination with replaceWithDistance action will substitute the payload value with the distance calculated in meters.

{"all":[{"fact":"value","operator":"distanceGreaterThan","value":100}]}

distanceLessThan: Return true when the distance (in meters) from the object is closer from the latitude/longitude defined in payload position.

Geofencing special behaviour : distanceGreaterThan operator used in combination with replaceWithDistance action will substitute the payload value with the distance calculated in meters.

{"all":[{"fact":"value","operator":"distanceLessThan","value":100}]}

All logical Math operators listed: https://github.com/CacheControl/json-rules-engine/blob/master/docs/rules.md#operators

Action types

Please contact us, by openning a new issue, if any other Actions would be relevant to your use-case.

Here is the available Action list :

annotate

This trigger action is used on Data-annotation process and require an additional category_id on its event parameters.

email

email action will send an email message to custom recipients and custom body.

Some variable can be used inside body :

${value}

httpWebhook

This trigger a call to a custom url with custom parameters, so that you can handle the response on your own server.

Ifttt:

TODO

model_classify

The model_classify will trigger the payload to be evaluated on a model (the model_id must be passed as event parameter)

mqttCommand

The mqttCommand will trigger aspecial mqtt message to be sent as a command to a specific Object (the object_id must be passed as event parameter).

mqttPublish

The mqttPublish will trigger an mqtt message to be sent.

openAiChatCompletion

openAiChatCompletion action will call openAI GPT and instantiate a chat dscussion from the payload value. As a response the value can optionaly be substituted from the openAI response. Some extra parameters can be used to customize the openAI chat discussion:

model: The open AI model to be used,
prompt: The open AI initial prompt to give context on discussion
substituteValueWithResponse: The boolean true|false value to sustitute the actual value if necessary, open AI response is always a text string dataType
temperature: The temperature as a float value
max_tokens
top_p
apiKey: Your own OpenAI apiKey

replaceWithDistance

The special replaceWithDistance action is used on geofencing situation, and will trigger the value to be substituted with the distance between Object and longitude/latitude passed on payload; calculated in meters.

serial

This will send a specific command as a serial command. the Object must be connected to t6 physically - this feature is disabled on t6 Saas.

slackMessage:

TODO

sms:

TODO

sockets

WebSockets will allows to customize and send a command to one specific Arduino device or broadcast the same message to multiple connected devices.

webPush

This action will send a custom push-notification to your own user.

Tagged on #feature, #resource, #engine, #rules,