Agents

Agents are worker processes that execute integration flows in a distributed Weik.io setup. They connect to the central host, request work, run integration flows, and report the results.

Architecture#

Central host#

The main Weik.io instance acts as the orchestrator. It manages agent registrations, assigns work, and tracks the results.

Remote agents#

Remote agents are worker processes that run wherever you deploy them. They:

• Register with the central host
• Execute the integration flows assigned to them
• Stream execution results back to the host
• Keep a persistent connection open to the host so they are ready when needed

Managing agents#

List agents#

You can see all registered agents directly from the CLI:

# List all agents
weikio agents ls

Agent states#

An agent is in one of four states at any given time:

Online The agent is connected, sends regular heartbeats, and is ready to accept new work.

Offline The agent has lost its connection to the host, for example because of a crash or a network failure. It does not receive new work until it reconnects.

Pending The agent has registered with the host but requires manual approval before it can start processing tasks.

Deprecated The agent has been explicitly retired. It no longer receives work, but the system keeps its records so that historical execution logs remain intact.