Package com.axelor.ai.tool.builder

Class SaveSkillTool

java.lang.Object

com.axelor.ai.tool.builder.SaveSkillTool

All Implemented Interfaces:

SystemTool<SaveSkillTool.Input>

public class SaveSkillTool
extends Object
implements SystemTool<SaveSkillTool.Input>

Creates or updates a skill by code: its instructions, its text references and its procedures, laid out as a skill directory is — SKILL.md, references/*.md, procedures.yaml.

Procedures are checked as a bundle import checks them, against the application as it is now: one that does not check out refuses the call, naming the procedure and the step. A skill does nothing until an agent links it, so a new one is saved enabled; a change to one that agents use names them on the approval card.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	SaveSkillTool.Input
static final record	SaveSkillTool.Reference

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CODE

Method Summary

Modifier and Type	Method	Description
ToolResult	beforeApproval(SaveSkillTool.Input input, ToolContext context)	Looked at before the user is asked to approve a call, for a tool that needs approval: a refusal known up front should not cost the user a decision.
String	callTitle(SaveSkillTool.Input input, String name)	What to call one call of this tool, given what it was called with.
String	code()	Unique code matching AiTool.systemTool field.
String	description()	Brief description of what this tool does.
ToolResult	execute(SaveSkillTool.Input input, ToolContext context)	Execute with the given typed input and agent-scoped context.
Class<SaveSkillTool.Input>	inputType()	The input record class.
String	name()	Human-readable display name (e.g.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.axelor.ai.tool.system.SystemTool

provideContext, refusal, runsOutsideTransaction, safety, undoneByRollback

Field Details

CODE

public static final String CODE

See Also:

• Constant Field Values

Method Details

code

public String code()

Description copied from interface: SystemTool

Unique code matching AiTool.systemTool field.

Specified by:

code in interface SystemTool<SaveSkillTool.Input>

name

public String name()

Description copied from interface: SystemTool

Human-readable display name (e.g. "Search Records").

Specified by:

name in interface SystemTool<SaveSkillTool.Input>

description

public String description()

Description copied from interface: SystemTool

Brief description of what this tool does.

Specified by:

description in interface SystemTool<SaveSkillTool.Input>

inputType

public Class<SaveSkillTool.Input> inputType()

Description copied from interface: SystemTool

The input record class. Return Void.class for tools with no input.

Specified by:

inputType in interface SystemTool<SaveSkillTool.Input>

callTitle

public String callTitle(SaveSkillTool.Input input,
 String name)

Description copied from interface: SystemTool

What to call one call of this tool, given what it was called with.

One call of a tool is not like the next: a tool that takes one record or several cannot be named accurately by its configuration alone. The name it is configured with is passed in, and returning it — as the default does — is what leaves the tool named the way the administrator named it.

Specified by:

callTitle in interface SystemTool<SaveSkillTool.Input>

Parameters:

input - the call's input, or null when the tool takes none

name - the tool's configured display name

beforeApproval

public ToolResult beforeApproval(SaveSkillTool.Input input,
 ToolContext context)

Description copied from interface: SystemTool

Looked at before the user is asked to approve a call, for a tool that needs approval: a refusal known up front should not cost the user a decision. Return an ToolResult.Error to refuse the call without asking, a ToolResult.PendingApproval to ask with what its card should show, or null to ask as usual. The call itself checks again when it runs.

Specified by:

beforeApproval in interface SystemTool<SaveSkillTool.Input>

Parameters:

input - the call's input, or null when the tool takes none

context - the call's context

execute

public ToolResult execute(SaveSkillTool.Input input,
 ToolContext context)

Description copied from interface: SystemTool

Execute with the given typed input and agent-scoped context.

Specified by:

execute in interface SystemTool<SaveSkillTool.Input>