Custom Code Execution

The CSML engine is able to automatically handle the execution of any payload, any code, in any language, thanks to the built-in Fn() macro. With CSML Functions, you can integrate your own business logic, on your own servers, in your language of choice.

When used together with custom serverless function runtimes (cloud-based such as AWS Lambda, Azure Functions, Google Cloud Functions), or on-premise with FnProject, OpenFaas or OpenWhisk), CSML Functions are a good way to execute custom business logic outside of the context of the conversation on the cheap.

findweather:
say "Let me query the weather in {{location}} for you..."
use Fn("weatherchannel", location = location) as weather
say "It will be {{weather.temperature}}°C tomorrow."

Running Fn on CSML Studio

When using the CSML Studio, the heavy setup of creating a Fn runtime is already done for you, which means that you can easily import functions in java, python, nodejs, go... without any additional setup, simply by uploading your code and calling the function in your CSML script.

CSML Studio also comes with many ready-to-use integrations that are installable in one-click.

Executing Fn calls

To execute external functions in any programming language when provided a fn_endpoint.

For example, when a Fn is called, a HTTP POST request will be performed to the provided fn_endpoint with the following payload:

{
"client": {
"bot_id": "unique-bot-id",
"user_id": "unique-user-id",
"channel_id": "unique-channel-id"
},
"function_id": "name_of_fn",
"data": {
"example": "somevalue",
"someparam": 123,
"obj_val": { "hi": "there" }
}
}

The endpoint should return a JSON payload, formatted as follows:

{
"data": data_to_return<JSON>
}

If the function fails, or returns an invalid payload, CSML will convert it as a Null value.

Installing a custom nodejs Function runtime

The following repository provides an easy way to run your own nodejs runtime: https://github.com/CSML-by-Clevy/csml-fn-endpoint-node

Follow the instructions to install and add your own functions!