Skip to main content
Version: Next — Unreleased

Spring Boot configuration

The Spring Boot starter configuration properties, generated from the Spring configuration metadata the configuration processor emits at build time (16 properties).

PropertyTypeDescription
agentforge4j.agents-pathStringfilesystem directory of agent YAML (or blank to skip filesystem agent loading)
agentforge4j.integrations.dirStringfilesystem directory of integration definition JSON ({@code agentforge4j.integrations.dir}; or blank to skip integration loading)
agentforge4j.llm.cache.enabledBoolean
agentforge4j.llm.fake.enabledBooleanopt-in toggle evaluated by {@linkplain FakeProviderAutoConfiguration}
agentforge4j.llm.fake.max-runsIntegeroptional dev/demo cap on concurrent tracked runs; {@code 0} (the default) disables the cap. Leave off (or high) for verification so an in-flight run is never evicted; when exceeded the least-recently-used run is evicted with a {@code WARN} log
agentforge4j.llm.fake.ttljava.time.Durationstale-run time-to-live for the leak guard; {@code null} disables TTL eviction (the default) — a registered run is held until {@code deregister}
agentforge4j.llm.model-tiersMap<java.lang.String,java.util.Map<java.lang.String,java.lang.String>>provider name to (tier name to model string) overrides; {@code null} or empty leaves the shipped defaults in place. Tier names are case-insensitive.
agentforge4j.load-shipped-agentsBooleanwhen {@code true}, merges agents from the starter's shipped classpath resources
agentforge4j.load-shipped-workflowsBooleanwhen {@code true}, merges workflows from shipped classpath resources
agentforge4j.max-nesting-depthIntegerwhen non-null, forwarded through {@link com.agentforge4j.runtime.WorkflowRuntimeBuilder}; when {@code null} construction keeps framework defaults
agentforge4j.mcp.serversList<com.agentforge4j.starter.mcp.McpProperties$ServerProperties>configured MCP servers; {@code null} or empty disables MCP wiring
agentforge4j.tools.egress.allow-private-networksBooleandevelopment-only escape hatch lifting the private/loopback/link-local/cloud-metadata egress blocks; defaults to {@code false} (fail-closed) when {@code null}
agentforge4j.tools.max-retriesIntegermaximum retry attempts; defaults to 0 when {@code null}
agentforge4j.tools.retry-backoffjava.time.Durationdelay between retries; defaults to zero when {@code null}
agentforge4j.tools.timeoutjava.time.Durationhard per-invocation timeout; defaults to 30s when {@code null}
agentforge4j.workflows-pathStringfilesystem directory of workflow YAML (or blank to skip filesystem workflow loading)