External 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
App() macro. With CSML Apps, 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.
1
findweather:
2
say "Let me query the weather in {{location}} for you..."
3
do weather = Fn("weatherchannel", location = location)
4
say "It will be {{weather.temperature}}°C tomorrow."
Copied!
Deprecation notice: the original
Fn() notation for calling Apps (formerly called Functions) in your CSML code has been replaced by the newer App() built-in as of CSML v1.5. Both notations will continue to work until CSML v2 is released, but this documentation will only reference the new App() usage from now on.Running App on CSML Studio
App on CSML StudioWhen using the CSML Studio, the heavy setup of creating an
App 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.Executing App calls
App callsTo execute external functions in any programming language when provided a
fn_endpoint.For example, when a
App is called, a HTTP POST request will be performed to the provided fn_endpoint with the following payload:1
{
2
"client": {
3
"bot_id": "unique-bot-id",
4
"user_id": "unique-user-id",
5
"channel_id": "unique-channel-id"
6
},
7
"function_id": "name_of_fn",
8
"data": {
9
"example": "somevalue",
10
"someparam": 123,
11
"obj_val": { "hi": "there" }
12
}
13
}
Copied!
The endpoint should return a JSON payload, formatted as follows:
1
{
2
"data": data_to_return<JSON>
3
}
Copied!
If the function fails, or returns an invalid payload, CSML will convert it as a
Null value.Installing a custom nodejs App 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 apps!
Last modified 8mo ago
Export as PDF
Copy link