Class InlineSessionState
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<InlineSessionState.Builder,InlineSessionState>
Contains parameters that specify various attributes that persist across a session or prompt. You can define session
state attributes as key-value pairs when writing a Lambda function for an action
group or pass them when making an InvokeInlineAgent request. Use session state attributes to control and
provide conversational context for your inline agent and to help customize your agent's behavior. For more
information, see Control
session context
- See Also:
-
Nested Class Summary
Nested Classes -
Method Summary
Modifier and TypeMethodDescriptionstatic InlineSessionState.Builderbuilder()final ConversationHistoryContains the conversation history that persist across sessions.final booleanfinal booleanequalsBySdkFields(Object obj) files()Contains information about the files used by code interpreter.final <T> Optional<T>getValueForField(String fieldName, Class<T> clazz) final booleanhasFiles()For responses, this returns true if the service returned a value for the Files property.final inthashCode()final booleanFor responses, this returns true if the service returned a value for the PromptSessionAttributes property.final booleanFor responses, this returns true if the service returned a value for the ReturnControlInvocationResults property.final booleanFor responses, this returns true if the service returned a value for the SessionAttributes property.final StringThe identifier of the invocation of an action.Contains attributes that persist across a session and the values of those attributes.final List<InvocationResultMember>Contains information about the results from the action group invocation.static Class<? extends InlineSessionState.Builder>Contains attributes that persist across a session and the values of those attributes.final StringtoString()Returns a string representation of this object.Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, waitMethods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
Method Details
-
conversationHistory
Contains the conversation history that persist across sessions.
- Returns:
- Contains the conversation history that persist across sessions.
-
hasFiles
public final boolean hasFiles()For responses, this returns true if the service returned a value for the Files property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
files
Contains information about the files used by code interpreter.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasFiles()method.- Returns:
- Contains information about the files used by code interpreter.
-
invocationId
The identifier of the invocation of an action. This value must match the
invocationIdreturned in theInvokeInlineAgentresponse for the action whose results are provided in thereturnControlInvocationResultsfield. For more information, see Return control to the agent developer.- Returns:
- The identifier of the invocation of an action. This value must match the
invocationIdreturned in theInvokeInlineAgentresponse for the action whose results are provided in thereturnControlInvocationResultsfield. For more information, see Return control to the agent developer.
-
hasPromptSessionAttributes
public final boolean hasPromptSessionAttributes()For responses, this returns true if the service returned a value for the PromptSessionAttributes property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
promptSessionAttributes
Contains attributes that persist across a session and the values of those attributes.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasPromptSessionAttributes()method.- Returns:
- Contains attributes that persist across a session and the values of those attributes.
-
hasReturnControlInvocationResults
public final boolean hasReturnControlInvocationResults()For responses, this returns true if the service returned a value for the ReturnControlInvocationResults property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
returnControlInvocationResults
Contains information about the results from the action group invocation. For more information, see Return control to the agent developer.
If you include this field in the
sessionStatefield, theinputTextfield will be ignored.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasReturnControlInvocationResults()method.- Returns:
- Contains information about the results from the action group invocation. For more information, see Return control to
the agent developer.
If you include this field in the
sessionStatefield, theinputTextfield will be ignored.
-
hasSessionAttributes
public final boolean hasSessionAttributes()For responses, this returns true if the service returned a value for the SessionAttributes property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
sessionAttributes
Contains attributes that persist across a session and the values of those attributes.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasSessionAttributes()method.- Returns:
- Contains attributes that persist across a session and the values of those attributes.
-
toBuilder
- Specified by:
toBuilderin interfaceToCopyableBuilder<InlineSessionState.Builder,InlineSessionState>
-
builder
-
serializableBuilderClass
-
hashCode
public final int hashCode() -
equals
-
equalsBySdkFields
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value. -
getValueForField
-
sdkFields
-
sdkFieldNameToField
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-