Agent Browser

The AI Agents in WorkflowFirst applications use a specific helper tool that gives them access to a browser. This helper tool is available to download from http://myworkflowfirst.com/installs/cfagentbrowser.zip. It requires that .Net Core is installed on the server (it usually is pre-installed).

The cfagentbrowser.exe file should be available in the same folder as wkhtmltopdf.exe file (typically the WorkflowFirst installation folder).

If this file is not running already, your WorkflowFirst application will attempt to run it at startup. 

You can also run the tool to install it as a Windows service. Please note the following available command-line tools (when you run from a cmd.exe or PowerShell prompt):

Usage:
  cfagentbrowser [options]
  cfagentbrowser service <command> [options]

Options:
  -?, -h, --help                 Show this help.
  --http [port]                  Run HTTP mode. Defaults to port 8876.
  --http=<port>                  Run HTTP mode on the specified port.
  --alt-debug [on|off|status]    Enable, disable, or show alternative snapshot debug logging.
  --alt-debug=<on|off|status>    Enable, disable, or show alternative snapshot debug logging.
  --temp-folder <path>           Set the root folder used for session downloads.
  --temp-folder=<path>           Set the root folder used for session downloads.

Service commands:
  service install [--port <port>] [--name <service-name>] [--service-exe <path>] [--start]
  service uninstall [--name <service-name>]
  service start|stop|restart|status [--name <service-name>]

By running cfagentbrowser service install you will tell the system to keep this running every time Windows starts up, regardless of whether a user is logged-in. Once installed you should start the service using cfagentbrowser service start (or status to check the status of the service).

Installing Google Chrome

The agent browser is a headless browser, meaning it uses the regular web browser but without a visible display. It is optimized to work best with Google Chrome, so it is recommended to ensure that Google Chrome is installed on the server where your WorkflowFirst application is running before using your AI agents.


Next Topic:
v4.2.0.4 (beta)
Up Since 7/8/2026 2:46:24 PM