Embabel Agent Documentation/com.embabel.agent.api.tool.progressive/ProgressiveTool

ProgressiveTool

interface ProgressiveTool : Tool

A tool implementing progressive disclosure - reveals additional capabilities beyond its initial interface.

Progressive tools present a simplified interface to the LLM initially, then reveal more specific tools when invoked. This reduces cognitive load and allows the LLM to discover capabilities on demand.

Implementations may vary what tools are revealed based on the current agent process context (permissions, state, phase, etc.).

See also

for a fixed set of inner tools

Inheritors

Properties

Link copied to clipboard
abstract val definition: Tool.Definition

Tool definition for LLM

Link copied to clipboard
open val metadata: Tool.Metadata

Optional metadata

Functions

Link copied to clipboard
abstract fun call(input: String): Tool.Result

Execute the tool with JSON input.

Link copied to clipboard
abstract fun innerTools(process: AgentProcess): List<Tool>

The inner tools available in this context.

Link copied to clipboard
inline fun <T : Any> Tool.requireType(message: String? = null): Tool

Wrap this tool to require a value of type T before execution (reified).

fun <T : Any> Tool.requireType(type: Class<T>, messageProvider: (String) -> String? = { null }): Tool

Wrap this tool to require a value of type T before execution.

Link copied to clipboard
fun Tool.toSpringToolCallback(): <Error class: unknown class>

Extension function to convert an Embabel Tool to a Spring AI ToolCallback.

Link copied to clipboard
inline fun <T : Tool> Tool.unwrapAs(): T?

Unwrap a tool to find a specific type, or return null if not found.

Link copied to clipboard
fun Tool.withAwaiting(decider: AwaitDecider): Tool

Wrap this tool to conditionally await before execution.

Link copied to clipboard
fun Tool.withConfirmation(messageProvider: (String) -> String): Tool
fun Tool.withConfirmation(message: String): Tool

Wrap this tool to always require confirmation before execution.

Link copied to clipboard
open fun withDescription(newDescription: String): Tool

Create a new tool with a different description. Useful for providing context-specific descriptions while keeping the same functionality.

Link copied to clipboard
fun Tool.withEventPublication(agentProcess: AgentProcess, action: Action?, llmOptions: <Error class: unknown class>): Tool

Extension function to wrap a Tool with event publication.

Link copied to clipboard
open fun withName(newName: String): Tool

Create a new tool with a different name. Useful for namespacing tools when combining multiple tool sources.

Link copied to clipboard
open fun withNote(note: String): Tool

Create a new tool with an additional note appended to the description. Useful for adding context-specific hints to an existing tool.