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

Class TaskAttributes

java.lang.Object

com.oracle.database.selectai.model.agent.TaskAttributes

public final class TaskAttributes
extends Object

Attributes used to create or update a Select AI Agent task.

Values are serialized with the snake-case names expected by DBMS_CLOUD_AI_AGENT. Lists are copied into immutable snapshots. The SDK preserves nullable optional values and delegates semantic validation, including relationships to tools and other tasks, to the database.

Since:

1.1.0

See Also:

• CreateTaskSample source
• SetTaskAttributesSample source

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	TaskAttributes.Builder	Builder for TaskAttributes.

Method Summary

Modifier and Type	Method	Description
static TaskAttributes.Builder	builder()	Creates a builder for task attributes.
Boolean	getEnableHumanTool()	Returns whether human-tool use is enabled.
List<String>	getInput()	Returns configured upstream task inputs.
String	getInstruction()	Returns the task instruction.
List<String>	getTools()	Returns configured tool names.
String	toJson()	Serializes attributes using the snake-case names expected by DBMS_CLOUD_AI_AGENT.

Methods inherited from class java.lang.Object

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

Method Details

getInstruction

public String getInstruction()

Returns the task instruction.

Returns:

task instruction, or null when unset

getTools

public List<String> getTools()

Returns configured tool names.

Returns:

immutable tool names, or null when unset

getInput

public List<String> getInput()

Returns configured upstream task inputs.

Returns:

immutable upstream task names, or null when unset

getEnableHumanTool

public Boolean getEnableHumanTool()

Returns whether human-tool use is enabled.

Returns:

whether human-tool use is enabled, or null when unset

builder

public static TaskAttributes.Builder builder()

Creates a builder for task attributes.

Returns:

mutable builder for task attributes

toJson

public String toJson()

Serializes attributes using the snake-case names expected by DBMS_CLOUD_AI_AGENT.

Returns:

JSON object containing non-null attributes

Throws:

IllegalStateException - when the attributes cannot be serialized