Embabel Agent Documentation/com.embabel.agent.tools.math/MathTools

MathTools

class MathTools : ToolGroup

Math-related tools exposed as an UnfoldingTool.

When used as a tool group, exposes a single "math" UnfoldingTool. When the LLM invokes this tool, it reveals the individual math operations (add, subtract, multiply, divide, mean, min, max, floor, ceiling, round).

Can be used in two ways:

As a tool group - register with the platform for automatic resolution
Directly - use unfoldingTool or innerTools with PromptRunner

Example usage:

// As a tool group (exposes single UnfoldingTool)
val toolGroup: ToolGroup = MathTools()

// Direct use of the UnfoldingTool
ai.withTool(MathTools().unfoldingTool)

// Direct use of inner tools (bypasses UnfoldingTool)
ai.withTools(MathTools().innerTools)

Constructors

constructor()

Properties

groupDescription

val groupDescription: ToolGroupDescription

val innerTools: List<Tool>

The inner tools - individual math operations. These are the tools that get revealed when the UnfoldingTool is invoked.

open override val metadata: ToolGroupMetadata

open val name: String

val permissions: Set<ToolGroupPermission>

open val provider: String

open override val tools: List<Tool>

As a tool group, exposes only the UnfoldingTool. The LLM sees a single "math" tool; when invoked, the inner tools are revealed.

val unfoldingTool: UnfoldingTool

The UnfoldingTool facade that wraps all math operations.

open val version: <Error class: unknown class>

Functions

fun add(a: Double, b: Double): Double

fun ceiling(number: Double): Double

fun create(): UnfoldingTool

Create the UnfoldingTool for math operations. Convenience method for Java interop.

fun divide(a: Double, b: Double): String

fun floor(number: Double): Double

open fun infoString(verbose: Boolean?, indent: Int): String

fun max(numbers: List<Double>): Double

fun mean(numbers: List<Double>): Double

fun min(numbers: List<Double>): Double

fun multiply(a: Double, b: Double): Double

fun round(number: Double): Double

fun subtract(a: Double, b: Double): Double