Call function node and custom utilities

The Call function node is used for calling Python functions in your workflows. This page explains how you can build your own workflow utilities.

Built-in functions

There is a number of built-in functions for you to implement. They allow you to retrieve user-related data, such as a user name or email, retrieve dialog-related data, such as attachments, and much more.

To view the reference material on these functions, view the help page. It is available on your instance as https://<yourinstance>.konverso.ai/doc/Call-Function-reference_781418611.html. Just substitute <yourinstance> with the actual name of your host.

ITSM Jira Service Management

You can use Jira Service Management (Cloud) specific functions in your workflows. To view the list of such functions and their details, see the JSM utility workflow functions.

Custom utilities

You can build custom utilities for interacting with users, invoking requests on external systems, and returning results.

Creating and editing custom functions

Editable files allow you to modify code that can be used to leverage Koji functionalities. There is no access to source code of the software, but editable files help you modify some parts.

To view and modify editable files:

1. Go to Development.

2. In the Configuration section, click one of the Workflow utilities files.

3. Modify its content in the window and click Save.

Sample

Creating a function

Here is a sample demonstrating a function that asks a user whether they are satisfied with the support and stores the reply in a keyword key.

def ask_support_feedback(key=''): """ Ask user for his satisfaction with a support and store the response into keyword key""" dialog = Bot.Bot().GetDialog() response = dialog.UserAsk("Tell us how you are satisfied with out JSM support?") if key: dialog.AddKeyword(key, response.text) return "Success"

You can copy this code and paste it into one of Workflow Utility files. Make sure to click Save and Apply.

Using the function in a workflow

1. Open your workflow in Content > Workflows and add the Call function node.

2. In the Function name field, specify the function. Our ask_support_feedback function is created in my1 file, so it is referred to as wf.my1.ask_support_feedback.

Testing a workflow

To test your workflow, go to chat and enter the #workflow <your-workflow-name> command.

Debug

To view the debug information, type the #debug on command in a chat. It turns on the debug mode, so you can view processing and messaging details right in the chat.

 

 

 

Â