Embabel Agent Documentation/com.embabel.agent.api.annotation/LlmTool

LlmTool

@Target(allowedTargets = [AnnotationTarget.FUNCTION])

annotation class LlmTool(val description: String = "", val name: String = "", val returnDirect: Boolean = false)

Marks a method as a tool that can be invoked by an LLM. Use with com.embabel.agent.api.tool.Tool.Companion.fromInstance or com.embabel.agent.api.tool.Tool.Companion.fromMethod to create Tool instances.

Types

Param

@Target(allowedTargets = [AnnotationTarget.VALUE_PARAMETER])

annotation class Param(val description: String, val required: Boolean = true)

Describes a tool parameter. Apply to method parameters. Parameters don't need to be annotated: If they are, the purpose is to provide description and required information.

Properties

description

val description: String

Description of what the tool does. Used by LLM to decide when to call it.

name

val name: String

Tool name. Defaults to method name if empty.

returnDirect

val returnDirect: Boolean = false

Whether to return the result directly without further LLM processing.