Subject: System

Keywords: ::bot

Title: Bots

--------------------------------------------------

A bot is a process that iteratively dispatches evaluation 
requests to a pool of refiners.

The result of a evaluation request is either good, bad, or fail.
  - good : evaluated to suitable result.
  - bad  : was able to evaluate but did not work as expected.
  - fail : was not able to be evaluated.
      * Primarily :
          - Bot failed while assembling the args for the evaluation request.
          - Refiner failed while interpeting the request before
            performing the evaluation. 

A bot will have a control panel used to interactively manage the bot.
The control panel includes buttons for interactionad a status display
area for feedback.

Bots are implemented as a process state combined with a function which
produces a new process state when passed a process state and an input request.
Evaluating the process function generally causes side effects such as
dispatching an evaluation to a refiner and updating the status display.

A core component of the process state is a data list. Each evaluation 
request is constructed from a data element. Bots may be initialized
with the data list and some may add elements to the list in response to
input requests.

Another component of the process state is a (token # term) property list.
Properties can be used to specify parameters such as how many refiners
to use, verbosity, which editors to display control panels, and more.
Some bots can save properties persistently such that a process state
can be reproduced to restart the bot.

The buttons available on the control panel can differ for different 
kinds of bots. Common buttons include:
  - Start : start or resume dispatching evaluation requests.
  - Stop  : pause dispatching evaluation requests.
  - Abort : delete process state without saving properties.
  - Exit  : if no pending requests or remaining evalution requests
            then save properties, delete process state, and close 
            command panels.
  - Edit  : open dialog to modify bot properties. 
  - Save  : persistently store some subset of the properties. 

Control panels show a status, the status will show state properties such
as number of good, bad, and fail results and the list of pending evaluation 
requests. Status properties differ for different kinds of bots.  
⋅
--------------------------------------------------

Authors: 

Contributors: RICH:t

⋅

Home