Skip to main content

Robots

robot is an intelligent agent designed to understand user questions and provide meaningful answers.

Robots act as an interface between the user and the Natural Language Processing (NLP) engine, using trained models to classify queries and extract key information. The platform provides a default robot is named Mentor, but you may create your ones dedicated to specific areas.

How Robots Work

Each robot is configured with two core NLP models:

  • Classifier: categorizes the user’s question into a specific action or intent (e.g., GETDOC, SEARCHFILE, UNKNOWN).
  • Tokens Detector: extracts specific values from the text, such as document IDs or filenames.

When a user asks a question, the robot:

  • Classifies the sentence using the classifier.
  • Extracts tokens using the tokens detector.
  • Executes a matching automation script (called an “answer”) associated with the identified category.
  • If the classification or token extraction fails, a default fallback answer is used.

Robot Configuration

Robots are configured through the Robot Management Interface.

classifier_properties_specs
 

The most relevant aspect of a robot's configuration is the Answer section, where each category (e.g., GETDOC, SEARCHDOC, SEARCHFILE) is mapped to an Automation script. These scripts define how the robot responds to a user query once the classifier and tokens detector have done their job.

Using these scripts, you can:

  • Retrieve and open documents by ID
  • Perform keyword-based full-text searches
  • Look up files by name
  • Handle unknown queries gracefully

These answers are stored as Automation scripts, allowing advanced conditional logic, data access, and dynamic rendering of results. 

Dictionary available for the Automation in this context

AUTOMATION CONTEXT: ROBOT
VariableJava ClassDescription
robot

Robot

The current robot instance (e.g., A.I.D.A.).
transaction

RobotHistory

Contains metadata about the current query, user ID, tenant, and session.
categoryStringThe category assigned by the classifier (e.g., GETDOC, SEARCHDOC etc.)
tokens

Map<String, List<Result<String>>>

Extracted tokens from the input
answer

Value<String>

Value holder used to carry the answer, put here your answer

Read the Automation manual for more information.