Tekos Flow

Welcome to Tekos Flow

Tekos Flow is an intuitive visual tool that enables you to create conversational agents or smart bots.

The platform provides a simple way create your prototype, iterate and improve through multiple versions, then deploy your application.

Tekos Flow offers nodes that are preconfigured to allow easy access to multiple data sources, cloud services, device profiles, and communication methods. The integrations are already done for you, so you only have to focus on wiring the building blocks together to create your conversational application. This Flow Desiner getting started guide will help you get up to speed fast.

Tekos Flow can be used in conjunction with Tekos NLP, our intuitive and interactive natural language processing engine.

Create your first project

  • Visit our bot manager to get started https://chat.tekos.co/#/user/@tekosapp:m.tekos.co

  • Create new account and follow the steps indicated by the bot

  • You will receive an access token to insert in tekos bot node in your flow if you are already using a flow, otherwise you need to create a new flow.

Create your first flow

There is two ways you can setup your flow

  1. Using docker, by pulling the image hitekos/flow

    You need set the following environment variables

    FLOW_LOGIN sould have the username needed in order to connect to the flow

    FLOW_PASSWORD the password needed for the user

    PORT the application will be running on the port you set, otherwise it will use the port 3000

  2. Deploy to heroku

Your project was created with a default first flow called ‘Flow1’. You can rename that flow to ‘My first flow’ by double clicking on the label and hitting Done.

Now, let’s write some code. Flow uses ‘nodes’ as the main building blocks and wires between these nodes to create the flow of the application. We’ll start with a few basic nodes.

  • Add the ‘Tekos In’ node. This node allows you to recieve messages into a flow.

  • Drag a ‘Tekos In’ node from the left palette onto the central workspace area..

  • Select the newly added node. You will see information about its properties and a description of what it does on the right Info pane..

  • Add a Debug node and place it to the right of the Hanna In node.. The Debug node causes any message to be displayed in the Debug sidebar. By default, it just displays the payload of the message, but it is possible to display the entire message object.

  • Wire the two together. Connect the Hanna In and Debug nodes together by dragging between the output port of one to the input port of the other.

  • Add the ‘Tekos Out’ node. This node allows you to send messages.

  • Wire Tekos In and Tekos out together. Connect the Tekos In and Tekos Out nodes together by dragging between the output port of one to the input port of the other.

Test your flow

At this point, the nodes only exist in the editor and must be deployed to the Tekos Platform as a Service (PaaS)

Deploy the Flow by clicking the ‘Deploy’ button on the top right of the canvas.

Use the test console:

The test console is a special version of the web messenger that offers a convenient (and free) way to test your flows.

The test console is accessible from the flow editor. Look for the icon at the top left of the screen.

Modify and retest your flow

Add a Text node. The Text node allows you to send a text message. Wire the Text node in between the Hanna In and Hanna out nodes.

You’ll need either to delete the existing wire (select it and hit delete on the keyboard) or drop the Text node on the existing wire between Hanna In and Hanna Out.

Double-click on the Text node to bring up the edit dialog.

  • Retest your flow. Your new flow is back in edit mode. Click the ‘Deploy’ button to rebuild and deploy it into Tekos PaaS environment. Wait for the build and deploy process to finish successfully.

Import a flow

It is sometimes useful to export or reuse a piece of code you or someone else wrote.

Export Flow:

In your Flow project, select the nodes that you want to export or select the entire Flow (Ctrl A on the keyboard)

click the menu -> Export… -> Clipboard.

Click on Export Clipboard. The Code is then copied. Go can then save it in a text file.

Import Flow:In order the test this functionality. we suggest to delete the existing test flow.

  • The JSON annotation below represent a simple ‘hello world!’ flow, much like your first flow. Copy it to your clipboard using the copy button below or by simply select and copy (Crtl+C for Windows, Cmd+C for Mac, etc.)

[{"id":"e6f1ba73.af91f8","type":"DS Message receive","z":"db4f1432.fda4b8","name":"","method":"chat/message","x":500, "y":280,"wires":[["46200373.f6cabc"]]},{"id":"46200373.f6cabc","type":"chatbot-message","z":"db4f1432.fda4b8", "name":"HelloWorld","message":[{"message":"Hello world!"}],"answer":false,"track":false,"x":740,"y":280,"wires": [["717f65b2.e6b6fc"]]},{"id":"717f65b2.e6b6fc","type":"DS Message send","z":"db4f1432.fda4b8", "name":"", "nextUri":"","nextAppName":"","x":970,"y":280,"wires":[]}]

  • In your Flow project, click the menu -> Import... -> Clipboard... (see example screenshot below)

  • Paste the JSON annotation from your clipboard and click OK

  • The flow will appear and will allow you to place it on your canvas. Make sure you place it on a clean spot, possibly below your existing flow.

  • Click Test in ‘Deploy’ button again to build and deploy the entire flow, including this new one. System will rebuild and deploy the code.

  • Once done, test the new Flow.

Next Steps:

  • Try some of the more Advanced Nodes

  • Explore Tekos Flow and add natural language processing to your bot