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

Class ExecutionStateRequest

java.lang.Object

com.oracle.database.selectai.model.agent.ExecutionStateRequest

public final class ExecutionStateRequest
extends Object

Request used to update an agent team execution state.

The request contains the state and typed ExecutionStateParams identifying the conversation to update. The builder also exposes a convenience method for the common conversation-ID case. Every request requires an explicit conversation identifier; the SDK does not rely on a current database session conversation.

Since:

1.1.0

See Also:

• SetTeamExecutionStateSample source

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static ExecutionStateRequest.Builder	builder(TeamExecutionState state)	Creates a builder for an execution-state request.
String	getConversationId()	Returns the conversation identifier from the typed parameters.
ExecutionStateParams	getParams()	Returns the typed execution-state parameters.
TeamExecutionState	getState()	Returns the run state to set.
String	toParamsJson()	Serializes the parameters for SET_EXECUTION_STATE.

Methods inherited from class java.lang.Object

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

Method Details

getState

public TeamExecutionState getState()

Returns the run state to set.

Returns:

known execution state

getParams

public ExecutionStateParams getParams()

Returns the typed execution-state parameters.

Returns:

immutable execution-state parameters

getConversationId

public String getConversationId()

Returns the conversation identifier from the typed parameters.

Returns:

database-created conversation identifier

toParamsJson

public String toParamsJson()

Serializes the parameters for SET_EXECUTION_STATE.

Returns:

JSON object containing the target conversation identifier

builder

public static ExecutionStateRequest.Builder builder(TeamExecutionState state)

Creates a builder for an execution-state request.

Parameters:

state - known state accepted by the database operation

Returns:

mutable builder for an execution-state request

Throws:

IllegalArgumentException - when state is null or TeamExecutionState.UNKNOWN