Weik.io

Agents

Workers that execute integration flows in a distributed architecture

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.