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

package com.oracle.database.selectai.model.agent

Configuration, request, response, status, and discovery models for Oracle Select AI Agent operations.

The models in this package are used with the public agent interfaces and represent data exchanged with the DBMS_CLOUD_AI_AGENT PL/SQL package. Builders prepare values locally; constructing a model does not execute a database operation. Built models retain immutable snapshots of their configured collections and maps; builders are mutable and should not be shared across threads without synchronization.

Resource and tool configuration

AgentAttributes, TaskAttributes, ToolAttributes, and TeamAttributes describe creation settings, attribute updates, and attributes loaded from database metadata. AgentStatus, TaskStatus, ToolStatus, and TeamStatus describe resource enablement, not workflow execution state.

ToolParams provides immutable built-in tool configuration through SqlToolParams, RagToolParams, WebSearchToolParams, SlackNotificationToolParams, and EmailNotificationToolParams. GenericToolParams preserves parameters for other database-defined tool types or schemas that cannot be represented by the known models. Known tool-parameter models also retain additional database fields. ToolType is an extensible value object that preserves tool-type values introduced by newer database releases. ToolInput models input names and descriptions in the immutable tool_inputs list exposed by ToolAttributes. Descriptions guide the model and do not enforce supported input values in Java.

Team requests and results

• RunTeamRequest carries the prompt and RunTeamParams for a team run. Runtime parameters include a conversation ID and instruction, attribute, and state variable maps.
• ExecutionStateRequest carries the requested TeamExecutionState and ExecutionStateParams identifying the conversation. An explicit non-blank conversation ID is required.
• ExportTeamParams models export options. ExportTeamRequest adds a destination and optional credential; ImportTeamRequest accepts a location or inline specification.
• TeamRunResult and ToolRunResult retain raw database output, which can be text or JSON, without imposing an output schema.
• TeamExecutionState represents workflow state. Unknown non-blank database states map to TeamExecutionState.UNKNOWN; that sentinel cannot be submitted in an execution-state update.
• TeamDescription exposes team metadata and retains the skills representation as JSON text. AvailableTeam is a read-only discovery snapshot, not a mutable team handle.

Not every database response has a dedicated model: tool descriptions and exported definitions remain JSON strings. Exported definitions may have an object or array as their top-level JSON value.

Validation

Resource-attribute builders do not require fields that the database validates when a resource is created. They retain documented Java checks, such as numeric ranges and collection structure. Request models validate required arguments and mutually exclusive input forms where documented. The database applies semantic validation and version-specific behavior when operations are executed. See each model's contract for omitted values and validation rules; typed requests do not imply unrestricted raw-JSON support.

Since:

1.1.0

See Also:

• com.oracle.database.selectai.agent
• SelectAIAgent
• ToolInputSample source
• ToolParamsSample source
• AgentWorkflowSample source
• SetTeamExecutionStateSample source
• ExportTeamSample source

Related Packages

Package	Description
com.oracle.database.selectai.model	Typed configuration, request, and value models used by the Select AI Java API.

Class	Description
AgentAttributes	Attributes used to create or update a Select AI Agent.
AgentAttributes.Builder	Builder for AgentAttributes.
AgentObjectType	Object types accepted by object-type parameters in DBMS_CLOUD_AI_AGENT.
AgentStatus	Status values for Select AI agents.
AvailableTeam	Read-only discovery metadata for an agent team available to the current database user.
EmailNotificationToolParams	Immutable parameters for a built-in email notification tool.
EmailNotificationToolParams.Builder	Builder for immutable EmailNotificationToolParams.
ExecutionStateParams	Typed parameters for a SET_EXECUTION_STATE operation.
ExecutionStateParams.Builder	Builder for immutable execution-state parameters.
ExecutionStateRequest	Request used to update an agent team execution state.
ExecutionStateRequest.Builder	Builder for ExecutionStateRequest.
ExportTeamParams	Typed parameters for exporting an agent team definition to a destination.
ExportTeamParams.Builder	Builder for immutable export parameters.
ExportTeamRequest	Request used to export a team definition to a file or object-storage URI.
ExportTeamRequest.Builder	Builder for ExportTeamRequest.
GenericToolParams	Immutable parameters for tools or parameter schemas not modeled by this SDK.
GenericToolParams.Builder	Builder for GenericToolParams.
ImportTeamRequest	Request used to import a Select AI Agent team definition.
ImportTeamRequest.Builder	Builder for ImportTeamRequest.
RagToolParams	Immutable parameters for a built-in RAG tool.
RagToolParams.Builder	Builder for immutable RagToolParams.
RunTeamParams	Typed runtime parameters for DBMS_CLOUD_AI_AGENT.RUN_TEAM.
RunTeamParams.Builder	Builder for immutable team runtime parameters.
RunTeamRequest	Input and optional runtime parameters for Team.run(RunTeamRequest) and SelectAIAgent.runTeam(String, RunTeamRequest).
RunTeamRequest.Builder	Builder for RunTeamRequest.
SlackNotificationToolParams	Immutable parameters for a built-in Slack notification tool.
SlackNotificationToolParams.Builder	Builder for immutable SlackNotificationToolParams.
SqlToolParams	Immutable parameters for a built-in SQL tool.
SqlToolParams.Builder	Builder for immutable SqlToolParams.
TaskAttributes	Attributes used to create or update a Select AI Agent task.
TaskAttributes.Builder	Builder for TaskAttributes.
TaskStatus	Status values accepted when creating a Select AI Agent task.
TeamAttributes	Attributes used to create a Select AI Agent team.
TeamAttributes.Builder	Builder for TeamAttributes.
TeamAttributes.TeamMember	Team member definition used in agent-team attributes.
TeamAttributes.TeamMember.MemberBuilder	Builder for TeamAttributes.TeamMember.
TeamDescription	Database-generated description of a Select AI Agent team.
TeamExecutionState	Execution states supported by a Select AI Agent team.
TeamRunResult	Result returned by a Select AI Agent team run.
TeamStatus	Status values accepted when creating a Select AI Agent team.
ToolAttributes	Attributes used to create or update a Select AI Agent tool.
ToolAttributes.Builder	Builder for ToolAttributes.
ToolInput	Immutable metadata for one entry in a tool's tool_inputs array.
ToolInput.Builder	Builder for ToolInput; semantic validation is delegated to the database.
ToolParams	Configuration parameters for a built-in Select AI Agent tool.
ToolRunResult	Result returned by a Select AI Agent tool run.
ToolStatus	Status values accepted when creating a Select AI Agent tool.
ToolType	Immutable value object for a Select AI Agent tool type.
WebSearchToolParams	Immutable parameters for a built-in web-search tool.
WebSearchToolParams.Builder	Builder for immutable WebSearchToolParams.