Automation Basics

Learn how to format your automation and write in plain, natural English

Intro to Formatting Your Automations

No need to learn how to code or use drag-and-drop interfaces anymore. Kognitos allows you to write your automations in plain English!

When you are writing an automation, there is some basic grammar you need to follow in order to ensure your automation runs as intended. You'll notice this grammar should fall inline with how you would naturally write a statement in English, and we encourage you to first write it how you would normally communicate it, and give that a try first!


Remember Koncierge is there to help you build or troubleshoot!

If you are writing an automation, and are not sure what the next steps may look like OR you forgot what the grammar may look like for an action, you can use Koncierge to help you build more effectively!

Building Your Automation

When using Kognitos, we write our automations within the Playground. The playground has some nice suggestion features as well that will guide you when building the automation. As well, the playground visually helps you understand when steps are nested under another step by visually spacing out your automations.

Example of how the Playground formats your automation

Example of how the Playground formats your automation

Declaring Facts (Objects/Variables)

Kognitos allows you to declare Objects/Variables so that you have a name to reference them by when you want to use them. Within Kognitos, we refer to these objects or variables as 'Facts'. Facts can be text(string), a number, a table or even an object like a document. Think of this as defining a variable if you are familiar with software development.

Share facts with Kognitos by just telling it, like so:

The fname is "Pink Floyd"

in the above pattern 'The fname' is the fact (object/variable) name and the value within the double quotes in the text stored within it.

You can then check that Kognitos understands by asking:

The fname

The above should responds with "Pink Floyd" as the result value.

Facts can have adjectives to distinguish them from one another

#Text facts
The big fname is "Led Zeppelin"

the green booking is 5.3
the small red booking is 4.3

Facts can be in list form or plurals like 'Codes' or 'Addresses'

the coupon codes are "CVV", "COW23" and "SUM22"
John's email addresses are "[email protected]", "[email protected]" and "[email protected]"

Dates, numbers and strings are all supported as facts. Make sure to add the text, dates or string values within double quotes ("") - E.g. "Pink Floyd", however numbers should not

#Numeric facts
John's age is 21
John's bank balance is $120.20
the interest rate is 1.25

You can get the date facts like below

#Date facts
the deadline is "16th Dec 2023"


#Date timezone can also be set
the department's timezone is "US/Eastern"
get the current date

You can even declare an empty Fact to act as a placeholder

imagine a value
the value is "Windows"

Using something as something else

Here you can rename/assign a value to a field or a fact with a new name using the keyword 'as a' , 'as the' or 'is the'

get the document's date as the podate

today as the Ddate

use "01.01.2022" as the invoice's date

the Ddate is the podate

In the above example, ****the podate, the Ddate & the invoice's date**** are the new names for the facts.


Note: As a general rule of thumb, whenever possible use the X is the Y instead of use the Y as the X syntax