For the complete documentation index, see llms.txt. This page is also available as Markdown.

Agents

An Agent is a small piece of Heisenware software that you install on a machine inside a separated network, for example on a factory floor. It executes logic, like connectors for S7, Modbus, or OPC UA, directly where the systems and devices are, and exchanges data securely with your account. Agents distribute your App logic: parts of it run in the cloud, parts of it at the edge, next to the machines it talks to.

Heisenware Agent

How Agents work

  1. Build or download an Agent and install it on a machine inside the target network.

  2. The Agent connects to the Heisenware platform through an outbound-only MQTTS connection on port 8883. No inbound firewall rules or VPNs are required.

  3. Once online, the Agent appears in the Function Explorer as its own entry, holding the connectors it carries.

  4. Functions dragged from an Agent entry execute on the Agent's machine, directly at the edge.

Agents run as system services or containers. They start automatically after reboots and power cycles and stay available around the clock.

A function is a function

In the App Builder, you never notice that you are working on a machine in a different network. A function from an Agent looks and behaves like any other function: drag it onto the canvas, wire it, configure it. It just runs somewhere else. Only its address reveals where.

Types of Agents

Choose the Agent that matches your edge hardware:

Type
Choose when

You have a Windows, macOS, or Linux machine (including ARM64 industrial PCs). Installs as a background service directly on the operating system. Credentials are built into the installer.

Your edge infrastructure already runs Docker. Same functionality in an isolated container. Pass credentials as environment variables at startup.

Your edge device is an INSYS icom industrial router or gateway (MRX, MRO, ECR, SCR series). Distributed as a .tar update packet and installed via the router's web interface.

Every Native Agent you build is also stored in the File Explorer in the native-agents folder, ready to download again at any time.

Last updated

Was this helpful?