{"componentChunkName":"component---src-templates-default-template-tsx","path":"/ki-syntax/","result":{"data":{"asciidoc":{"id":"945b5a6a-9d9c-57f6-bb93-978712c90609","html":"
\n
Table of Contents
\n\n
\n
\n

1. Introduction

\n
\n
\n

KI Syntax is a formalization language for knowledge around automating processes. It is the basis for the Knowledge Items (KI).

\n
\n
\n

The assumption is, the system will have access to the same information as any (privileged) user and needs to be taught how to interact with the data in order to solve \"Issues\". KI Syntax describes logic that processes/gathers/generates data in a certain way to contribute to the overall problem solution. This logic is stored in the Knowledge Items. Bardioc Engine applies Knowledge Items to its tasks.

\n
\n
\n

Application of Knowledge Items works by matching data to KI that call for these conditions and associating the KI to these data points. This is called \"binding\". At any time many Knowledge Items can be \"bound\" to the same data.

\n
\n
\n

A task is stored in a theoretical data container called an \"Issue\", this includes the current state of data gathered/generated for this task and the history of steps and changes made to the data during processing.

\n
\n
\n

A very simplified Issue could look something like this:

\n
\n
\n
\n
{\n \"/Subject\": \"MyTestIssue\",\n \"/MyVariable\": [\"FirstValue\", \"SecondValue\"]\n}
\n
\n
\n
\n

Bardioc will apply Knowledge Items to an Issue until the task is completed or it runs out of applicable knowledge. In such a case Bardioc will attempt to draw in knowledge from surrounding nodes to further work on the Issue or in rare cases eject the Issue for processing by a human. A task is considered completed when all todo variables are empty/removed.

\n
\n
\n
\n
\n

2. A Note on KI design

\n
\n
\n\n\n\n\n\n
\n\n\nYou should have a look at our Useful tips section\n
\n
\n
\n

While KI Syntax borrows heavily from common programming language features like string expansion or comparison operators, it should not be confused with a programming language. KI Syntax purposefully does not natively support creation of large monolithic algorithms. The goal is to write atomized bits of knowledge that can be freely strung together by their inputs and outputs and are as re-usable for as many use cases as possible.

\n
\n
\n

You can, however use the included math, JavaScript and Regular Expression functions to manipulate data in your Knowledge Items.

\n
\n
\n
\n
\n

3. Syntax

\n
\n
\n

The syntax is defined by the structure of KI described in this document and the available KI Syntax functions.

\n
\n
\n

KI Syntax is written as simple text using a YAML-like approach with a 2 spaces (` `) indentation pattern.

\n
\n
\n

For example:

\n
\n
\n
\n
ki\n  name: \"Test\"\non\n  A\ndo\n  log(\"we have an A with value ${A}\")
\n
\n
\n
\n
","document":{"main":"Overview","title":"Overview: KI Syntax - Embedded Knowledge Item Syntax for Almato Bardioc","subtitle":"KI Syntax - Embedded Knowledge Item Syntax for Almato Bardioc"},"fields":{"toc":true,"location":["ki-syntax"]}},"sidebarYaml":{"id":"6f28bdca-d703-5e79-ae00-b0508f8ee82a","showIndex":true}},"pageContext":{"id":"945b5a6a-9d9c-57f6-bb93-978712c90609","parent":"ki-syntax"}},"staticQueryHashes":["1010459453","1010459453","2356112386","2356112386","2603905930","2603905930","3026652197","3026652197","3167850324","3167850324","63159454","63159454"]}