Package com.oracle.database.selectai.model.agent

Class ToolAttributes.Builder

java.lang.Object

com.oracle.database.selectai.model.agent.ToolAttributes.Builder

Enclosing class:

ToolAttributes

public static final class ToolAttributes.Builder
extends Object

Builder for ToolAttributes.

See Also:

• CreateToolWithInputsSample source

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
ToolAttributes	build()	Builds immutable tool attributes.
ToolAttributes.Builder	function(String functionName)	Sets the custom PL/SQL function or procedure name.
ToolAttributes.Builder	instruction(String instruction)	Sets the tool instruction.
ToolAttributes.Builder	toolInputs(List<ToolInput> toolInputs)	Copies tool input metadata into an immutable list.
ToolAttributes.Builder	toolParams(ToolParams toolParams)	Snapshots typed built-in tool parameters.
ToolAttributes.Builder	toolType(ToolType toolType)	Sets a known or database-defined tool type.
ToolAttributes.Builder	toolTypeValue(String toolType)	Sets a tool type directly from its database value.

Methods inherited from class java.lang.Object

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

Constructor Details

Builder

public Builder()

Method Details

instruction

public ToolAttributes.Builder instruction(String instruction)

Sets the tool instruction.

Parameters:

instruction - tool instruction

Returns:

this builder

See Also:

• CreateToolWithInputsSample source

function

public ToolAttributes.Builder function(String functionName)

Sets the custom PL/SQL function or procedure name.

Parameters:

functionName - function or procedure name

Returns:

this builder

See Also:

• CreateToolWithInputsSample source

toolType

public ToolAttributes.Builder toolType(ToolType toolType)

Sets a known or database-defined tool type.

Parameters:

toolType - tool type value object

Returns:

this builder

See Also:

• CreateSqlToolSample source

toolTypeValue

public ToolAttributes.Builder toolTypeValue(String toolType)

Sets a tool type directly from its database value.

Parameters:

toolType - database tool type value

Returns:

this builder

Throws:

IllegalArgumentException - when toolType is blank

See Also:

• CreateToolSample source

toolParams

public ToolAttributes.Builder toolParams(ToolParams toolParams)

Snapshots typed built-in tool parameters. Use a tool-specific builder for known fields or GenericToolParams for an extensible parameter object. Required fields are validated by the database.

Parameters:

toolParams - tool parameters, or null to omit them

Returns:

this builder

Throws:

IllegalArgumentException - when the value is not JSON-compatible

See Also:

• CreateSqlToolSample source
• SetSqlToolParamsSample source
• ToolParamsSample source

toolInputs

public ToolAttributes.Builder toolInputs(List<ToolInput> toolInputs)

Copies tool input metadata into an immutable list. Each entry supplies a name and optional description; the database validates their meaning. An empty list is serialized as an empty tool_inputs array.

Parameters:

toolInputs - input metadata, or null to omit it

Returns:

this builder

Throws:

IllegalArgumentException - when the list contains a null entry

See Also:

• ToolInputSample source
• CreateToolSample source
• CreateToolWithInputsSample source
• SetToolInputsSample source

build

public ToolAttributes build()

Builds immutable tool attributes.

Returns:

immutable tool attributes

See Also:

• CreateToolWithInputsSample source