Agent Apps Docs

Execution modes

Choose between standalone, cluster, and on-demand execution modes.

Execution modes

standalone

One shared instance for all sessions. Simplest to operate, lowest resource usage. Best for apps that are stateless or where all users share the same context.

cluster

N replicas, load-balanced across sessions. Best for high-throughput apps that need horizontal scaling but don't require per-user isolation.

on-demand

One instance per installation, with idle teardown. This is the default mode. Best for apps that need per-user isolation, custom auth tokens, or tenant-specific state.

ModeInstancesIsolationBest for
standalone1 sharedNoneStateless apps
clusterN replicasSession-levelHigh-throughput stateless
on-demand1 per installPer-installationApps with per-user auth/state

Next steps