Skip to content

Tokens

The Tokens feature allows Cognigyscript expressions to be packaged into a visual Token to provide non-technical platform creators with access to dynamic conversation data without writing code themselves.

Using Tokens

The example below shows two responses that access the user's last message. Both sentences produce the same output. The first message uses a default system token whereas the second sentence uses the coded CognigyScript format.

Tokens can be added to a dialog message from any text field displaying the AI symbol. Simply click the AI symbol to expand the tokens menu which displays a searchable list of available tokens. The tokens are sorted into categories based on the location of the data which they access i.e. Input, Context, Profile or Custom.

Cognigy.AI comes with a selection of default tokens that are associated with base input and profile variables.

Token "Answer" used in a Say Node

Creating Tokens

You can create Tokens either from flow node text fields showing the AI symbol or from the Token Management Menu (see below). From flow nodes, click the AI symbol to expand the token selector menu, then click the + icon at the end of the search field. If you are creating a token from the Token Management menu, simply click the "Create New Token" button at the top of the interface.

Creating a Token requires the following information:

  • Name - The name that will be shown on the token to platform users
  • Script - The CognigyScript path used to access the data
  • Type - The data location (used for sorting the token in the search window)
Curly Brackets not required here!

Tokens will automatically apply curly brackets to your script, therefore they must be omitted from the script field when creating tokens and from text fields when using tokens.

Token Management Menu

The Token Management Menu can be found under the Manage section of the Agent Resources menu. A full list of tokens that have been created in an Agent is accessible to view.

A token can be deleted by resting the cursor on a token, clicking the menu icon that appears on the right end of the interface and selecting "Delete ".

Script Persistance

Deleting Tokens will not remove the Cognigyscript from the Nodes that used the Token.

Back to top