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

Class AgentAttributes

java.lang.Object
com.oracle.database.selectai.model.agent.AgentAttributes
public final class AgentAttributes extends Object
Attributes used to create or update a Select AI Agent.

The database requires profile_name and role when the agent is created. The builder permits these values to be unset or blank; DBMS_CLOUD_AI_AGENT validates the required creation values and the supplied attribute names and values when an update is attempted. The builder checks the documented shortTermMemoryLength range in Java.

To create a supervisor-led team, designate its supervisor with supervisor(true) at agent creation and reference that agent with TeamAttributes.Builder.supervisorAgent(String). The supervisor flag cannot be changed after creation. Worker agents remain separate from the supervisor in the team's agent-task mappings.

Since:
1.1.0
See Also:

  • Method Details

    • getProfileName

      public String getProfileName()
      Returns the AI profile name.
      Returns:
      AI profile name, or null when unset

    • getRole

      public String getRole()
      Returns the agent role.
      Returns:
      agent role, or null when unset

    • getEnableHumanTool

      public Boolean getEnableHumanTool()
      Returns whether the human tool is enabled.
      Returns:
      whether the human tool is enabled, or null when unset

    • getTools

      public List<String> getTools()
      Returns configured tool names.
      Returns:
      immutable tool names, or null when unset

    • getShortTermMemoryLength

      public Integer getShortTermMemoryLength()
      Returns the short-term memory length.
      Returns:
      short-term memory length, or null when unset

    • getSupervisor

      public Boolean getSupervisor()
      Returns whether the agent is a supervisor.
      Returns:
      whether the agent is a supervisor, or null when unset

    • builder

      public static AgentAttributes.Builder builder()
      Creates a builder for agent attributes.
      Returns:
      mutable builder for agent 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