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

Class AgentAttributes.Builder

java.lang.Object

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

Enclosing class:

AgentAttributes

public static final class AgentAttributes.Builder
extends Object

Builder for AgentAttributes.

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
AgentAttributes	build()	Builds agent attributes without validating required database fields.
AgentAttributes.Builder	enableHumanTool(Boolean enableHumanTool)	Sets whether the agent can request human input.
AgentAttributes.Builder	profileName(String profileName)	Sets the AI profile name.
AgentAttributes.Builder	role(String role)	Sets the agent role.
AgentAttributes.Builder	shortTermMemoryLength(Integer shortTermMemoryLength)	Sets the short-term memory length.
AgentAttributes.Builder	supervisor(Boolean supervisor)	Sets whether the agent is a supervisor at creation time.
AgentAttributes.Builder	tools(List<String> tools)	Sets the names of tools available to the agent.

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

profileName

public AgentAttributes.Builder profileName(String profileName)

Sets the AI profile name.

Parameters:

profileName - AI profile name

Returns:

this builder

role

public AgentAttributes.Builder role(String role)

Sets the agent role.

Parameters:

role - role assigned to the agent

Returns:

this builder

enableHumanTool

public AgentAttributes.Builder enableHumanTool(Boolean enableHumanTool)

Sets whether the agent can request human input.

Parameters:

enableHumanTool - whether human-tool requests are enabled

Returns:

this builder

tools

public AgentAttributes.Builder tools(List<String> tools)

Sets the names of tools available to the agent.

Parameters:

tools - tool names; the list is copied by the builder

Returns:

this builder

shortTermMemoryLength

public AgentAttributes.Builder shortTermMemoryLength(Integer shortTermMemoryLength)

Sets the short-term memory length.

Parameters:

shortTermMemoryLength - non-negative memory length, or null to use the database default

Returns:

this builder

Throws:

IllegalArgumentException - when the value is negative

supervisor

public AgentAttributes.Builder supervisor(Boolean supervisor)

Sets whether the agent is a supervisor at creation time. The database does not allow changing this flag after creation. Assign the created supervisor to a team using TeamAttributes.Builder.supervisorAgent(String); do not include it in that team's worker agent-task mappings.

For a runnable example, see SupervisorTeamSample source.

Parameters:

supervisor - whether the agent supervises other agents

Returns:

this builder

build

public AgentAttributes build()

Builds agent attributes without validating required database fields. Required-field and semantic validation is performed by DBMS_CLOUD_AI_AGENT when the agent is created.

Returns:

immutable agent attributes