Agent Browser

The Agent Browser lets an AI agent navigate websites and use application controls on your behalf. It runs as a headless browser on the server, rather than as a normal browser window on your computer. You can open a remote view from an agent conversation to see what it is doing and provide input.

Controlling browser access

Use Web Browser Access in Agent Settings to choose whether the agent may browse. None disables access. This App Only limits browsing to the current application. Whitelisted Sites permits only domains listed under the agent's Whitelisted Sites area. Any Site allows the agent to visit other sites without a domain whitelist.

When using Whitelisted Sites, add the required domains on the agent's page before starting the task. Choose the smallest scope that supports the work. Access to a site does not grant a login or replace that site's permissions.

Viewing and interacting with the browser

Click Agent Browser in the conversation window to open the remote view. You can inspect the page and use supported mouse and keyboard interaction. Because the view is refreshed from screenshots, it can respond more slowly than a local browser.

Use Enter Text to send a block of text more efficiently than typing it character by character. To navigate directly, enter an address in the address bar and click Go. Show Raw displays the text extraction available to the agent and can help diagnose content it cannot see.

Click Return to Chat to resume the conversation. The browser viewport can be taller than a normal browser window, so scroll down if a centered dialog or control is not initially visible.

Signing in

Browser Login in Agent Settings determines how the agent signs in to the main application. Ask User lets you sign in through the remote browser and then tell the agent to continue. Same As User uses the current conversation user's session. Associated User uses the user account configured for the agent.

Cookies and authenticated sessions can remain in the agent's browser. Do not assume that returning to chat signs out of a site. Sign out of sessions you do not want the agent to continue using. Consider administrator access to conversations when deciding which accounts to use.

Oversight and troubleshooting

Training Mode lets a supervisor check browser forms before submission. Record Browser can retain screenshots after clicks for auditing, with additional storage requirements.

If a control is not visible to the agent, inspect the page and its Show Raw output. Some sites restrict automated access or require additional authentication. Check the site's access requirements and terms before using it with an agent.

Server resources

Each browser session consumes server memory. Concurrent agents and conversations can increase memory use and affect application performance. Plan capacity for the expected workload, and investigate resource limits if browser sessions fail or the server becomes slow.

Installing the browser helper

For an on-premise WorkflowFirst application, the agent browser requires the cfagentbrowser helper tool and a compatible browser on the server. Google Chrome is recommended. Ensure the required .NET Core runtime is installed.

The helper is available from http://myworkflowfirst.com/installs/cfagentbrowser.zip. Extract cfagentbrowser.exe into its own folder, preferably under Program Files. The tool can run as a Windows service so it remains available after Windows restarts, even when no user is signed in.

From a command prompt or PowerShell window, run cfagentbrowser service install, followed by cfagentbrowser service start. Use cfagentbrowser service status to check it. The service can also be managed through Windows service-management tools.

Command-line reference

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>]


Next Topic:
v8.1.0.21127
Up Since 11/4/2026 5:22:39 PM