Embabel Agent Documentation/com.embabel.agent.api.tool.config/ToolLoopConfiguration

ToolLoopConfiguration

data class ToolLoopConfiguration(val type: ToolLoopConfiguration.ToolLoopType = ToolLoopType.DEFAULT, val maxIterations: Int = 20, val parallel: ToolLoopConfiguration.ParallelModeProperties = ParallelModeProperties(), val toolNotFound: ToolLoopConfiguration.ToolNotFoundProperties = ToolNotFoundProperties())

Configuration for tool loop execution.

Externalized via properties:

embabel:
  agent:
    platform:
      toolloop:
        type: default              # default | parallel
        max-iterations: 20
        tool-not-found:
          max-retries: 3
          min-fuzzy-length: 3
        parallel:
          per-tool-timeout: 30s
          batch-timeout: 60s

Threading and context propagation

Parallel tool execution uses the com.embabel.agent.api.common.Asyncer bean, which is the single extension point for controlling threading behavior and propagating execution context (e.g., security context, MDC) to tool execution threads.

To customize threading, provide a custom Asyncer bean rather than using executor configuration properties.

Constructors

ToolLoopConfiguration

constructor(type: ToolLoopConfiguration.ToolLoopType = ToolLoopType.DEFAULT, maxIterations: Int = 20, parallel: ToolLoopConfiguration.ParallelModeProperties = ParallelModeProperties(), toolNotFound: ToolLoopConfiguration.ToolNotFoundProperties = ToolNotFoundProperties())

Types

ExecutorType

enum ~~ExecutorType~~ : Enum<ToolLoopConfiguration.ExecutorType>

Type of executor for parallel tool execution.

ParallelModeProperties

data class ParallelModeProperties(val perToolTimeout: Duration = Duration.ofSeconds(30), val batchTimeout: Duration = Duration.ofSeconds(60), val executorType: ToolLoopConfiguration.ExecutorType = ExecutorType.VIRTUAL, val fixedPoolSize: Int = 10, val shutdownTimeout: Duration = Duration.ofSeconds(5))

Properties for parallel mode tool execution. Only applicable when type is ToolLoopType.PARALLEL.

ToolLoopType

enum ToolLoopType : Enum<ToolLoopConfiguration.ToolLoopType>

Type of tool loop to use.

ToolNotFoundProperties