Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Customers with dedicated Koji instances can develop new integration scenarios using the SDK, a software development kit. This page helps you understand which tools you can use and where to start.

Table of Contents

Key points

There are a few powerful tools and approaches that help you create new integration scenarios:

  • Workflow node for working with APIs;

  • Workflow

...

  • node for implementing Python functions;

  • Python callbacks that Koji sends to users as a response.

Let’s dive into these approaches to understand when and how to use them.

Workflow

Workflow is a dialog model that allows users to go through a dialog using the predefined scheme. This is a tool that helps you design conversations.

With workflows you can ask users questions and keep the received answers, perform actions, such as ticket creation, or running search in a knowledge base. Create scenarios that involve knowledge base resourcedresources, conversations (including asking questions, clarifications, and so on), and external integrations.

To learn more about the workflow concept, its usage, and view the reference materials (including help pages on nodes), see the Workflow chapter in the documentation. It is available on your instance (substitute <yourinstance> with the actual name of your host): https://<yourinstance>.konverso.ai/doc/Workflow_781451265.html

...

Workflow nodes

Nodes are the building blocks of a workflow. There are many types of nodes: search nodes, interaction nodes, AI nodes, and so on. Each type has its own purpose.

...

Web service node

This node sends a request requests to a web service , obtains, and parses the returned result. Use

As Atlassian offers a lot of APIs designed for Jira Service Management, you can use Web service node to leverage JSM REST such APIs and integrate Jira Service Management with Koji.

...

There are nodes and built-in functions for you to implement in your workflows, but . But you can build custom Python utilities as well. A set of libraries make it possible to fit your organization’s needs. Create utilities to interact with users, invoke requests on external systems, and return results.

To implement custom Python code, you must use editable files. They allow you to add your own code into Koji in order to use it in Call function node, for example.

...

Custom Python callbacks

Intent in Kbot Koji is the primary logical unit of a conversation. Basically, the The main idea of a conversation processing is extracting an intent and delivering a corresponding proper response to a user. Intents  

Intents can have Python callbacks defined as their response. This Python code allows That means that once a given intent is detected by Koji, it replies to a user with the defined callback.

Callbacks allow you to run any kind of interaction with users, send requests to external systems, and eventually end the intent with particular return code (completed, failed, etc.).

...