startAsyncAgent

fun startAsyncAgent(configFilename: String, exitOnMissingConfig: Boolean, logBanner: Boolean = true): EmbeddedAgentInfo(source)

Starts an Agent on a background thread and returns immediately, suitable for embedding inside another JVM application.

Unlike startSyncAgent, this does not block — the Agent's lifecycle is owned by the caller via the returned EmbeddedAgentInfo, which exposes the agent's launchId and agentName and a stop() method for graceful shutdown.

Return

An EmbeddedAgentInfo handle for inspecting and shutting down the launched Agent.

Parameters

configFilename

Path or URL to the HOCON config file. Forwarded to the AgentOptions config-filename constructor so it follows the same resolution rules as the --config CLI flag.

exitOnMissingConfig

When true, terminates the calling process if the config cannot be located. For embedded usage where the host application should handle config errors itself, pass false.

logBanner

When true (default), logs the Agent ASCII banner and version on startup. Pass false to suppress banner output when embedding inside an app that owns its own logging surface.