aws-sdk-bedrockagentruntime 1.1.0 → 1.3.0

data/lib/aws-sdk-bedrockagentruntime/types.rb

@@ -10,11 +10,10 @@
 module Aws::BedrockAgentRuntime
   module Types
 
-    # This exception is thrown when a request is denied per access
-    # permissions
+    # The request is denied because of missing access permissions. Check
+    # your permissions and retry your request.
     #
     # @!attribute [rw] message
-    #   Non Blank String
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/AccessDeniedException AWS API Documentation
@@ -26,44 +25,46 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # input to lambda used in action group
+    # Contains information about the action group being invoked.
     #
     # @!attribute [rw] action_group_name
-    #   Agent Trace Action Group Name
-    #   @return [String]
-    #
-    # @!attribute [rw] verb
-    #   Agent Trace Action Group Action verb
+    #   The name of the action group.
     #   @return [String]
     #
     # @!attribute [rw] api_path
-    #   Agent Trace Action Group API path
+    #   The path to the API to call, based off the action group.
     #   @return [String]
     #
     # @!attribute [rw] parameters
-    #   list of parameters included in action group invocation
+    #   The parameters in the Lambda input event.
     #   @return [Array<Types::Parameter>]
     #
     # @!attribute [rw] request_body
-    #   Request Body Content Map
+    #   The parameters in the request body for the Lambda input event.
     #   @return [Types::RequestBody]
     #
+    # @!attribute [rw] verb
+    #   The API method being used, based off the action group.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ActionGroupInvocationInput AWS API Documentation
     #
     class ActionGroupInvocationInput < Struct.new(
       :action_group_name,
-      :verb,
       :api_path,
       :parameters,
-      :request_body)
-      SENSITIVE = [:action_group_name, :verb, :api_path]
+      :request_body,
+      :verb)
+      SENSITIVE = [:action_group_name, :api_path, :verb]
       include Aws::Structure
     end
 
-    # output from lambda used in action group
+    # Contains the JSON-formatted string returned by the API invoked by the
+    # action group.
     #
     # @!attribute [rw] text
-    #   Agent Trace Action Group Lambda Invocation Output String
+    #   The JSON-formatted string returned by the API invoked by the action
+    #   group.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ActionGroupInvocationOutput AWS API Documentation
@@ -74,10 +75,11 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Citations associated with final agent response
+    # Contains citations for a part of an agent response.
     #
     # @!attribute [rw] citations
-    #   List of citations
+    #   A list of citations and related information for a part of an agent
+    #   response.
     #   @return [Array<Types::Citation>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Attribution AWS API Documentation
@@ -88,15 +90,15 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # This exception is thrown when a request fails due to dependency like
-    # Lambda, Bedrock, STS resource
+    # There was an issue with a dependency due to a server issue. Retry your
+    # request.
     #
     # @!attribute [rw] message
-    #   Non Blank String
     #   @return [String]
     #
     # @!attribute [rw] resource_name
-    #   Non Blank String
+    #   The name of the dependency that caused the issue, such as Amazon
+    #   Bedrock, Lambda, or STS.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/BadGatewayException AWS API Documentation
@@ -109,14 +111,17 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Citation associated with the agent response
+    # An object containing a segment of the generated response that is based
+    # on a source in the knowledge base, alongside information about the
+    # source.
     #
     # @!attribute [rw] generated_response_part
-    #   Generate response part
+    #   Contains the generated response and metadata
     #   @return [Types::GeneratedResponsePart]
     #
     # @!attribute [rw] retrieved_references
-    #   list of retrieved references
+    #   Contains metadata about the sources cited for the generated
+    #   response.
     #   @return [Array<Types::RetrievedReference>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Citation AWS API Documentation
@@ -128,11 +133,10 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # This exception is thrown when there is a conflict performing an
-    # operation
+    # There was a conflict performing an operation. Resolve the conflict and
+    # retry your request.
     #
     # @!attribute [rw] message
-    #   Non Blank String
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ConflictException AWS API Documentation
@@ -144,16 +148,15 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # This exception is thrown when a request fails due to dependency like
-    # Lambda, Bedrock, STS resource due to a customer fault (i.e. bad
-    # configuration)
+    # There was an issue with a dependency. Check the resource
+    # configurations and retry the request.
     #
     # @!attribute [rw] message
-    #   Non Blank String
     #   @return [String]
     #
     # @!attribute [rw] resource_name
-    #   Non Blank String
+    #   The name of the dependency that caused the issue, such as Amazon
+    #   Bedrock, Lambda, or STS.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/DependencyFailedException AWS API Documentation
@@ -166,29 +169,29 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Trace Part which is emitted when agent trace could not be generated
+    # Contains information about the failure of the interaction.
     #
-    # @!attribute [rw] trace_id
-    #   Identifier for trace
+    # @!attribute [rw] failure_reason
+    #   The reason the interaction failed.
     #   @return [String]
     #
-    # @!attribute [rw] failure_reason
-    #   Agent Trace Failed Reason String
+    # @!attribute [rw] trace_id
+    #   The unique identifier of the trace.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/FailureTrace AWS API Documentation
     #
     class FailureTrace < Struct.new(
-      :trace_id,
-      :failure_reason)
+      :failure_reason,
+      :trace_id)
       SENSITIVE = [:failure_reason]
       include Aws::Structure
     end
 
-    # Agent finish output
+    # Contains details about the response to the user.
     #
     # @!attribute [rw] text
-    #   Agent Trace Action Group Lambda Invocation Output String
+    #   The text in the response to the user.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/FinalResponse AWS API Documentation
@@ -199,60 +202,82 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Generate response part
+    # Contains metadata about a part of the generated response that is
+    # accompanied by a citation.
     #
     # @!attribute [rw] text_response_part
-    #   Text response part
+    #   Contains metadata about a textual part of the generated response
+    #   that is accompanied by a citation.
     #   @return [Types::TextResponsePart]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/GeneratedResponsePart AWS API Documentation
     #
     class GeneratedResponsePart < Struct.new(
       :text_response_part)
-      SENSITIVE = []
+      SENSITIVE = [:text_response_part]
       include Aws::Structure
     end
 
-    # Configurations for controlling the inference response of an
-    # InvokeAgent API call
+    # Specifications about the inference parameters that were provided
+    # alongside the prompt. These are specified in the
+    # [PromptOverrideConfiguration][1] object that was set when the agent
+    # was created or updated. For more information, see [Inference
+    # parameters for foundation models][2].
     #
-    # @!attribute [rw] temperature
-    #   Controls randomness, higher values increase diversity
-    #   @return [Float]
     #
-    # @!attribute [rw] top_p
-    #   Cumulative probability cutoff for token selection
-    #   @return [Float]
     #
-    # @!attribute [rw] top_k
-    #   Sample from the k most likely next tokens
-    #   @return [Integer]
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html
+    # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html
     #
     # @!attribute [rw] maximum_length
-    #   Maximum length of output
+    #   The maximum number of tokens allowed in the generated response.
     #   @return [Integer]
     #
     # @!attribute [rw] stop_sequences
-    #   List of stop sequences
+    #   A list of stop sequences. A stop sequence is a sequence of
+    #   characters that causes the model to stop generating the response.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] temperature
+    #   The likelihood of the model selecting higher-probability options
+    #   while generating a response. A lower value makes the model more
+    #   likely to choose higher-probability options, while a higher value
+    #   makes the model more likely to choose lower-probability options.
+    #   @return [Float]
+    #
+    # @!attribute [rw] top_k
+    #   While generating a response, the model determines the probability of
+    #   the following token at each point of generation. The value that you
+    #   set for `topK` is the number of most-likely candidates from which
+    #   the model chooses the next token in the sequence. For example, if
+    #   you set `topK` to 50, the model selects the next token from among
+    #   the top 50 most likely choices.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] top_p
+    #   While generating a response, the model determines the probability of
+    #   the following token at each point of generation. The value that you
+    #   set for `Top P` determines the number of most-likely candidates from
+    #   which the model chooses the next token in the sequence. For example,
+    #   if you set `topP` to 80, the model only selects the next token from
+    #   the top 80% of the probability distribution of next tokens.
+    #   @return [Float]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InferenceConfiguration AWS API Documentation
     #
     class InferenceConfiguration < Struct.new(
+      :maximum_length,
+      :stop_sequences,
       :temperature,
-      :top_p,
       :top_k,
-      :maximum_length,
-      :stop_sequences)
+      :top_p)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # This exception is thrown if there was an unexpected error during
-    # processing of request
+    # An internal server error occurred. Retry your request.
     #
     # @!attribute [rw] message
-    #   Non Blank String
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InternalServerException AWS API Documentation
@@ -264,95 +289,97 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Trace Part which contains input details for action group or knowledge
-    # base
+    # Contains information pertaining to the action group or knowledge base
+    # that is being invoked.
     #
-    # @!attribute [rw] trace_id
-    #   Identifier for trace
-    #   @return [String]
+    # @!attribute [rw] action_group_invocation_input
+    #   Contains information about the action group to be invoked.
+    #   @return [Types::ActionGroupInvocationInput]
     #
     # @!attribute [rw] invocation_type
-    #   types of invocations
+    #   Specifies whether the agent is invoking an action group or a
+    #   knowledge base.
     #   @return [String]
     #
-    # @!attribute [rw] action_group_invocation_input
-    #   input to lambda used in action group
-    #   @return [Types::ActionGroupInvocationInput]
-    #
     # @!attribute [rw] knowledge_base_lookup_input
-    #   Input to lambda used in action group
+    #   Contains details about the knowledge base to look up and the query
+    #   to be made.
     #   @return [Types::KnowledgeBaseLookupInput]
     #
+    # @!attribute [rw] trace_id
+    #   The unique identifier of the trace.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InvocationInput AWS API Documentation
     #
     class InvocationInput < Struct.new(
-      :trace_id,
-      :invocation_type,
       :action_group_invocation_input,
-      :knowledge_base_lookup_input)
+      :invocation_type,
+      :knowledge_base_lookup_input,
+      :trace_id)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # InvokeAgent Request
-    #
-    # @!attribute [rw] session_state
-    #   Session state passed by customer. Base64 encoded json string
-    #   representation of SessionState.
-    #   @return [Types::SessionState]
+    # @!attribute [rw] agent_alias_id
+    #   The alias of the agent to use.
+    #   @return [String]
     #
     # @!attribute [rw] agent_id
-    #   Identifier for Agent
+    #   The unique identifier of the agent to use.
     #   @return [String]
     #
-    # @!attribute [rw] agent_alias_id
-    #   Identifier for Agent Alias
-    #   @return [String]
+    # @!attribute [rw] enable_trace
+    #   Specifies whether to turn on the trace or not to track the agent's
+    #   reasoning process. For more information, see [Trace enablement][1].
     #
-    # @!attribute [rw] session_id
-    #   Identifier used for the current session
-    #   @return [String]
     #
-    # @!attribute [rw] end_session
-    #   End current session
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/agents-test.html#trace-events
     #   @return [Boolean]
     #
-    # @!attribute [rw] enable_trace
-    #   Enable agent trace events for improved debugging
+    # @!attribute [rw] end_session
+    #   Specifies whether to end the session with the agent or not.
     #   @return [Boolean]
     #
     # @!attribute [rw] input_text
-    #   Input data in the format specified in the Content-Type request
-    #   header.
+    #   The prompt text to send the agent.
+    #   @return [String]
+    #
+    # @!attribute [rw] session_id
+    #   The unique identifier of the session. Use the same value across
+    #   requests to continue the same conversation.
     #   @return [String]
     #
+    # @!attribute [rw] session_state
+    #   Contains parameters that specify various attributes of the session.
+    #   @return [Types::SessionState]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InvokeAgentRequest AWS API Documentation
     #
     class InvokeAgentRequest < Struct.new(
-      :session_state,
-      :agent_id,
       :agent_alias_id,
-      :session_id,
-      :end_session,
+      :agent_id,
       :enable_trace,
-      :input_text)
+      :end_session,
+      :input_text,
+      :session_id,
+      :session_state)
       SENSITIVE = [:input_text]
       include Aws::Structure
     end
 
-    # InvokeAgent Response
-    #
     # @!attribute [rw] completion
-    #   Inference response from the model in the format specified in the
-    #   Content-Type response header.
+    #   The agent's response to the user prompt.
     #   @return [Types::ResponseStream]
     #
     # @!attribute [rw] content_type
-    #   streaming response mimetype of the model
+    #   The MIME type of the input data in the request. The default value is
+    #   `application/json`.
     #   @return [String]
     #
     # @!attribute [rw] session_id
-    #   streaming response mimetype of the model
+    #   The unique identifier of the session with the agent.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InvokeAgentResponse AWS API Documentation
@@ -365,29 +392,31 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Input to lambda used in action group
+    # Contains details about the knowledge base to look up and the query to
+    # be made.
     #
-    # @!attribute [rw] text
-    #   Agent Trace Action Group Lambda Invocation Output String
+    # @!attribute [rw] knowledge_base_id
+    #   The unique identifier of the knowledge base to look up.
     #   @return [String]
     #
-    # @!attribute [rw] knowledge_base_id
-    #   Agent Trace Action Group Knowledge Base Id
+    # @!attribute [rw] text
+    #   The query made to the knowledge base.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseLookupInput AWS API Documentation
     #
     class KnowledgeBaseLookupInput < Struct.new(
-      :text,
-      :knowledge_base_id)
-      SENSITIVE = [:text, :knowledge_base_id]
+      :knowledge_base_id,
+      :text)
+      SENSITIVE = [:knowledge_base_id, :text]
       include Aws::Structure
     end
 
-    # Input to lambda used in action group
+    # Contains details about the results from looking up the knowledge base.
     #
     # @!attribute [rw] retrieved_references
-    #   list of retrieved references
+    #   Contains metadata about the sources cited for the generated
+    #   response.
     #   @return [Array<Types::RetrievedReference>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseLookupOutput AWS API Documentation
@@ -398,10 +427,10 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Knowledge base input query.
+    # Contains the query made to the knowledge base.
     #
     # @!attribute [rw] text
-    #   Knowledge base input query in text
+    #   The text of the query made to the knowledge base.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseQuery AWS API Documentation
@@ -412,10 +441,22 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Search parameters for retrieving from knowledge base.
+    # Contains details about how the results should be returned.
+    #
+    # This data type is used in the following API operations:
+    #
+    # * [Retrieve request body][1]
+    #
+    # * [RetrieveAndGenerate request body][2]
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax
+    # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_RequestSyntax
     #
     # @!attribute [rw] vector_search_configuration
-    #   Knowledge base vector search configuration
+    #   Contains details about how the results from the vector search should
+    #   be returned.
     #   @return [Types::KnowledgeBaseVectorSearchConfiguration]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseRetrievalConfiguration AWS API Documentation
@@ -426,18 +467,18 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Result item returned from a knowledge base retrieval.
+    # Details about a result from querying the knowledge base.
     #
     # @!attribute [rw] content
-    #   Content of a retrieval result.
+    #   Contains a chunk of text from a data source in the knowledge base.
     #   @return [Types::RetrievalResultContent]
     #
     # @!attribute [rw] location
-    #   The source location of a retrieval result.
+    #   Contains information about the location of the data source.
     #   @return [Types::RetrievalResultLocation]
     #
     # @!attribute [rw] score
-    #   The relevance score of a result.
+    #   The level of relevance of the result to the query.
     #   @return [Float]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseRetrievalResult AWS API Documentation
@@ -446,181 +487,272 @@ module Aws::BedrockAgentRuntime
       :content,
       :location,
       :score)
-      SENSITIVE = []
+      SENSITIVE = [:content, :location]
       include Aws::Structure
     end
 
-    # Configurations for retrieval and generation for knowledge base.
+    # Contains details about the resource being queried.
     #
     # @!attribute [rw] knowledge_base_id
-    #   Identifier of the KnowledgeBase
+    #   The unique identifier of the knowledge base that is queried and the
+    #   foundation model used for generation.
     #   @return [String]
     #
     # @!attribute [rw] model_arn
-    #   Arn of a Bedrock model.
+    #   The ARN of the foundation model used to generate a response.
     #   @return [String]
     #
+    # @!attribute [rw] retrieval_configuration
+    #   Contains configurations for how to retrieve and return the knowledge
+    #   base query.
+    #   @return [Types::KnowledgeBaseRetrievalConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseRetrieveAndGenerateConfiguration AWS API Documentation
     #
     class KnowledgeBaseRetrieveAndGenerateConfiguration < Struct.new(
       :knowledge_base_id,
-      :model_arn)
+      :model_arn,
+      :retrieval_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Knowledge base vector search configuration
+    # Configurations for how to carry out the search.
     #
     # @!attribute [rw] number_of_results
-    #   Top-K results to retrieve from knowledge base.
+    #   The number of results to return.
+    #
+    #   <note markdown="1"> The `numberOfResults` field is currently unsupported for
+    #   `RetrieveAndGenerate`. Don't include it in this field if you are
+    #   sending a `RetrieveAndGenerate` request.
+    #
+    #    </note>
     #   @return [Integer]
     #
+    # @!attribute [rw] override_search_type
+    #   By default, Amazon Bedrock decides a search strategy for you. If
+    #   you're using an Amazon OpenSearch Serverless vector store that
+    #   contains a filterable text field, you can specify whether to query
+    #   the knowledge base with a `HYBRID` search using both vector
+    #   embeddings and raw text, or `SEMANTIC` search using only vector
+    #   embeddings. For other vector store configurations, only `SEMANTIC`
+    #   search is available. For more information, see [Test a knowledge
+    #   base][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-test.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseVectorSearchConfiguration AWS API Documentation
     #
     class KnowledgeBaseVectorSearchConfiguration < Struct.new(
-      :number_of_results)
+      :number_of_results,
+      :override_search_type)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Trace Part which contains information used to call Invoke Model
+    # The input for the pre-processing step.
     #
-    # @!attribute [rw] trace_id
-    #   Identifier for trace
-    #   @return [String]
+    # * The `type` matches the agent step.
     #
-    # @!attribute [rw] text
-    #   Prompt Message
-    #   @return [String]
+    # * The `text` contains the prompt.
     #
-    # @!attribute [rw] type
-    #   types of prompts
-    #   @return [String]
+    # * The `inferenceConfiguration`, `parserMode`, and `overrideLambda`
+    #   values are set in the [PromptOverrideConfiguration][1] object that
+    #   was set when the agent was created or updated.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html
     #
     # @!attribute [rw] inference_configuration
-    #   Configurations for controlling the inference response of an
-    #   InvokeAgent API call
+    #   Specifications about the inference parameters that were provided
+    #   alongside the prompt. These are specified in the
+    #   [PromptOverrideConfiguration][1] object that was set when the agent
+    #   was created or updated. For more information, see [Inference
+    #   parameters for foundation models][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html
+    #   [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html
     #   @return [Types::InferenceConfiguration]
     #
     # @!attribute [rw] override_lambda
-    #   ARN of a Lambda.
+    #   The ARN of the Lambda function to use when parsing the raw
+    #   foundation model output in parts of the agent sequence.
+    #   @return [String]
+    #
+    # @!attribute [rw] parser_mode
+    #   Specifies whether to override the default parser Lambda function
+    #   when parsing the raw foundation model output in the part of the
+    #   agent sequence defined by the `promptType`.
     #   @return [String]
     #
     # @!attribute [rw] prompt_creation_mode
-    #   indicates if agent uses default prompt or overriden prompt
+    #   Specifies whether the default prompt template was `OVERRIDDEN`. If
+    #   it was, the `basePromptTemplate` that was set in the
+    #   [PromptOverrideConfiguration][1] object when the agent was created
+    #   or updated is used instead.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html
     #   @return [String]
     #
-    # @!attribute [rw] parser_mode
-    #   indicates if agent uses default prompt or overriden prompt
+    # @!attribute [rw] text
+    #   The text that prompted the agent at this step.
+    #   @return [String]
+    #
+    # @!attribute [rw] trace_id
+    #   The unique identifier of the trace.
+    #   @return [String]
+    #
+    # @!attribute [rw] type
+    #   The step in the agent sequence.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ModelInvocationInput AWS API Documentation
     #
     class ModelInvocationInput < Struct.new(
-      :trace_id,
-      :text,
-      :type,
       :inference_configuration,
       :override_lambda,
+      :parser_mode,
       :prompt_creation_mode,
-      :parser_mode)
+      :text,
+      :trace_id,
+      :type)
       SENSITIVE = [:text]
       include Aws::Structure
     end
 
-    # Trace Part which contains output details for action group or knowledge
-    # base or final response
-    #
-    # @!attribute [rw] trace_id
-    #   Identifier for trace
-    #   @return [String]
-    #
-    # @!attribute [rw] type
-    #   types of observations
-    #   @return [String]
+    # Contains the result or output of an action group or knowledge base, or
+    # the response to the user.
     #
     # @!attribute [rw] action_group_invocation_output
-    #   output from lambda used in action group
+    #   Contains the JSON-formatted string returned by the API invoked by
+    #   the action group.
     #   @return [Types::ActionGroupInvocationOutput]
     #
-    # @!attribute [rw] knowledge_base_lookup_output
-    #   Input to lambda used in action group
-    #   @return [Types::KnowledgeBaseLookupOutput]
-    #
     # @!attribute [rw] final_response
-    #   Agent finish output
+    #   Contains details about the response to the user.
     #   @return [Types::FinalResponse]
     #
+    # @!attribute [rw] knowledge_base_lookup_output
+    #   Contains details about the results from looking up the knowledge
+    #   base.
+    #   @return [Types::KnowledgeBaseLookupOutput]
+    #
     # @!attribute [rw] reprompt_response
-    #   Observation information if there were reprompts
+    #   Contains details about the response to reprompt the input.
     #   @return [Types::RepromptResponse]
     #
+    # @!attribute [rw] trace_id
+    #   The unique identifier of the trace.
+    #   @return [String]
+    #
+    # @!attribute [rw] type
+    #   Specifies what kind of information the agent returns in the
+    #   observation. The following values are possible.
+    #
+    #   * `ACTION_GROUP` – The agent returns the result of an action group.
+    #
+    #   * `KNOWLEDGE_BASE` – The agent returns information from a knowledge
+    #     base.
+    #
+    #   * `FINISH` – The agent returns a final response to the user with no
+    #     follow-up.
+    #
+    #   * `ASK_USER` – The agent asks the user a question.
+    #
+    #   * `REPROMPT` – The agent prompts the user again for the same
+    #     information.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Observation AWS API Documentation
     #
     class Observation < Struct.new(
-      :trace_id,
-      :type,
       :action_group_invocation_output,
-      :knowledge_base_lookup_output,
       :final_response,
-      :reprompt_response)
+      :knowledge_base_lookup_output,
+      :reprompt_response,
+      :trace_id,
+      :type)
       SENSITIVE = [:reprompt_response]
       include Aws::Structure
     end
 
-    # Trace contains intermidate response during orchestration
+    # Details about the orchestration step, in which the agent determines
+    # the order in which actions are executed and which knowledge bases are
+    # retrieved.
     #
     # @note OrchestrationTrace is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of OrchestrationTrace corresponding to the set member.
     #
-    # @!attribute [rw] rationale
-    #   Trace Part which contains information related to reasoning
-    #   @return [Types::Rationale]
-    #
     # @!attribute [rw] invocation_input
-    #   Trace Part which contains input details for action group or
-    #   knowledge base
+    #   Contains information pertaining to the action group or knowledge
+    #   base that is being invoked.
     #   @return [Types::InvocationInput]
     #
+    # @!attribute [rw] model_invocation_input
+    #   The input for the orchestration step.
+    #
+    #   * The `type` is `ORCHESTRATION`.
+    #
+    #   * The `text` contains the prompt.
+    #
+    #   * The `inferenceConfiguration`, `parserMode`, and `overrideLambda`
+    #     values are set in the [PromptOverrideConfiguration][1] object that
+    #     was set when the agent was created or updated.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html
+    #   @return [Types::ModelInvocationInput]
+    #
     # @!attribute [rw] observation
-    #   Trace Part which contains output details for action group or
-    #   knowledge base or final response
+    #   Details about the observation (the output of the action group Lambda
+    #   or knowledge base) made by the agent.
     #   @return [Types::Observation]
     #
-    # @!attribute [rw] model_invocation_input
-    #   Trace Part which contains information used to call Invoke Model
-    #   @return [Types::ModelInvocationInput]
+    # @!attribute [rw] rationale
+    #   Details about the reasoning, based on the input, that the agent uses
+    #   to justify carrying out an action group or getting information from
+    #   a knowledge base.
+    #   @return [Types::Rationale]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/OrchestrationTrace AWS API Documentation
     #
     class OrchestrationTrace < Struct.new(
-      :rationale,
       :invocation_input,
-      :observation,
       :model_invocation_input,
+      :observation,
+      :rationale,
       :unknown)
-      SENSITIVE = [:rationale, :invocation_input, :observation, :model_invocation_input]
+      SENSITIVE = [:invocation_input, :model_invocation_input, :observation, :rationale]
       include Aws::Structure
       include Aws::Structure::Union
 
-      class Rationale < OrchestrationTrace; end
       class InvocationInput < OrchestrationTrace; end
-      class Observation < OrchestrationTrace; end
       class ModelInvocationInput < OrchestrationTrace; end
+      class Observation < OrchestrationTrace; end
+      class Rationale < OrchestrationTrace; end
       class Unknown < OrchestrationTrace; end
     end
 
-    # parameters included in action group invocation
+    # A parameter in the Lambda input event.
     #
     # @!attribute [rw] name
-    #   Name of parameter
+    #   The name of the parameter.
     #   @return [String]
     #
     # @!attribute [rw] type
-    #   Type of parameter
+    #   The type of the parameter.
     #   @return [String]
     #
     # @!attribute [rw] value
-    #   Value of parameter
+    #   The value of the parameter.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Parameter AWS API Documentation
@@ -633,50 +765,51 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Base 64 endoded byte response
-    #
-    # @!attribute [rw] bytes
-    #   PartBody of the payload in bytes
-    #   @return [String]
+    # Contains a part of an agent response and citations for it.
     #
     # @!attribute [rw] attribution
-    #   Citations associated with final agent response
+    #   Contains citations for a part of an agent response.
     #   @return [Types::Attribution]
     #
+    # @!attribute [rw] bytes
+    #   A part of the agent response in bytes.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PayloadPart AWS API Documentation
     #
     class PayloadPart < Struct.new(
-      :bytes,
       :attribution,
+      :bytes,
       :event_type)
       SENSITIVE = [:bytes]
       include Aws::Structure
     end
 
-    # Trace Part which contains information related to postprocessing
-    #
-    # @!attribute [rw] trace_id
-    #   Identifier for trace
-    #   @return [String]
+    # The foundation model output from the post-processing step.
     #
     # @!attribute [rw] parsed_response
-    #   Trace Part which contains information if preprocessing was
-    #   successful
+    #   Details about the response from the Lambda parsing of the output of
+    #   the post-processing step.
     #   @return [Types::PostProcessingParsedResponse]
     #
+    # @!attribute [rw] trace_id
+    #   The unique identifier of the trace.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PostProcessingModelInvocationOutput AWS API Documentation
     #
     class PostProcessingModelInvocationOutput < Struct.new(
-      :trace_id,
-      :parsed_response)
+      :parsed_response,
+      :trace_id)
       SENSITIVE = [:parsed_response]
       include Aws::Structure
     end
 
-    # Trace Part which contains information if preprocessing was successful
+    # Details about the response from the Lambda parsing of the output from
+    # the post-processing step.
     #
     # @!attribute [rw] text
-    #   Agent Trace Output String
+    #   The text returned by the parser.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PostProcessingParsedResponse AWS API Documentation
@@ -687,16 +820,29 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Trace Part which contains information related to post processing step
+    # Details about the post-processing step, in which the agent shapes the
+    # response.
     #
     # @note PostProcessingTrace is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of PostProcessingTrace corresponding to the set member.
     #
     # @!attribute [rw] model_invocation_input
-    #   Trace Part which contains information used to call Invoke Model
+    #   The input for the post-processing step.
+    #
+    #   * The `type` is `POST_PROCESSING`.
+    #
+    #   * The `text` contains the prompt.
+    #
+    #   * The `inferenceConfiguration`, `parserMode`, and `overrideLambda`
+    #     values are set in the [PromptOverrideConfiguration][1] object that
+    #     was set when the agent was created or updated.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html
     #   @return [Types::ModelInvocationInput]
     #
     # @!attribute [rw] model_invocation_output
-    #   Trace Part which contains information related to postprocessing
+    #   The foundation model output from the post-processing step.
     #   @return [Types::PostProcessingModelInvocationOutput]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PostProcessingTrace AWS API Documentation
@@ -714,55 +860,72 @@ module Aws::BedrockAgentRuntime
       class Unknown < PostProcessingTrace; end
     end
 
-    # Trace Part which contains information related to preprocessing
-    #
-    # @!attribute [rw] trace_id
-    #   Identifier for trace
-    #   @return [String]
+    # The foundation model output from the pre-processing step.
     #
     # @!attribute [rw] parsed_response
-    #   Trace Part which contains information if preprocessing was
-    #   successful
+    #   Details about the response from the Lambda parsing of the output of
+    #   the pre-processing step.
     #   @return [Types::PreProcessingParsedResponse]
     #
+    # @!attribute [rw] trace_id
+    #   The unique identifier of the trace.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PreProcessingModelInvocationOutput AWS API Documentation
     #
     class PreProcessingModelInvocationOutput < Struct.new(
-      :trace_id,
-      :parsed_response)
+      :parsed_response,
+      :trace_id)
       SENSITIVE = [:parsed_response]
       include Aws::Structure
     end
 
-    # Trace Part which contains information if preprocessing was successful
-    #
-    # @!attribute [rw] rationale
-    #   Agent Trace Rationale String
-    #   @return [String]
+    # Details about the response from the Lambda parsing of the output from
+    # the pre-processing step.
     #
     # @!attribute [rw] is_valid
-    #   Boolean value
+    #   Whether the user input is valid or not. If `false`, the agent
+    #   doesn't proceed to orchestration.
     #   @return [Boolean]
     #
+    # @!attribute [rw] rationale
+    #   The text returned by the parsing of the pre-processing step,
+    #   explaining the steps that the agent plans to take in orchestration,
+    #   if the user input is valid.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PreProcessingParsedResponse AWS API Documentation
     #
     class PreProcessingParsedResponse < Struct.new(
-      :rationale,
-      :is_valid)
+      :is_valid,
+      :rationale)
       SENSITIVE = [:rationale]
       include Aws::Structure
     end
 
-    # Trace Part which contains information related to preprocessing step
+    # Details about the pre-processing step, in which the agent
+    # contextualizes and categorizes user inputs.
     #
     # @note PreProcessingTrace is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of PreProcessingTrace corresponding to the set member.
     #
     # @!attribute [rw] model_invocation_input
-    #   Trace Part which contains information used to call Invoke Model
+    #   The input for the pre-processing step.
+    #
+    #   * The `type` is `PRE_PROCESSING`.
+    #
+    #   * The `text` contains the prompt.
+    #
+    #   * The `inferenceConfiguration`, `parserMode`, and `overrideLambda`
+    #     values are set in the [PromptOverrideConfiguration][1] object that
+    #     was set when the agent was created or updated.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html
     #   @return [Types::ModelInvocationInput]
     #
     # @!attribute [rw] model_invocation_output
-    #   Trace Part which contains information related to preprocessing
+    #   The foundation model output from the pre-processing step.
     #   @return [Types::PreProcessingModelInvocationOutput]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PreProcessingTrace AWS API Documentation
@@ -780,48 +943,50 @@ module Aws::BedrockAgentRuntime
       class Unknown < PreProcessingTrace; end
     end
 
-    # Trace Part which contains information related to reasoning
+    # Contains the reasoning, based on the input, that the agent uses to
+    # justify carrying out an action group or getting information from a
+    # knowledge base.
     #
-    # @!attribute [rw] trace_id
-    #   Identifier for trace
+    # @!attribute [rw] text
+    #   The reasoning or thought process of the agent, based on the input.
     #   @return [String]
     #
-    # @!attribute [rw] text
-    #   Agent Trace Rationale String
+    # @!attribute [rw] trace_id
+    #   The unique identifier of the trace step.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Rationale AWS API Documentation
     #
     class Rationale < Struct.new(
-      :trace_id,
-      :text)
+      :text,
+      :trace_id)
       SENSITIVE = [:text]
       include Aws::Structure
     end
 
-    # Observation information if there were reprompts
+    # Contains details about the agent's response to reprompt the input.
     #
-    # @!attribute [rw] text
-    #   Reprompt response text
+    # @!attribute [rw] source
+    #   Specifies what output is prompting the agent to reprompt the input.
     #   @return [String]
     #
-    # @!attribute [rw] source
-    #   Parsing error source
+    # @!attribute [rw] text
+    #   The text reprompting the input.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RepromptResponse AWS API Documentation
     #
     class RepromptResponse < Struct.new(
-      :text,
-      :source)
+      :source,
+      :text)
       SENSITIVE = [:source]
       include Aws::Structure
     end
 
-    # Request Body Content Map
+    # The parameters in the request body for the Lambda input event.
     #
     # @!attribute [rw] content
-    #   Content type paramter map
+    #   The content in the request body.
     #   @return [Hash<String,Array<Types::Parameter>>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RequestBody AWS API Documentation
@@ -832,11 +997,10 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # This exception is thrown when a resource referenced by the operation
-    # does not exist
+    # The specified resource ARN was not found. Check the ARN and try your
+    # request again.
     #
     # @!attribute [rw] message
-    #   Non Blank String
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ResourceNotFoundException AWS API Documentation
@@ -848,10 +1012,10 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Content of a retrieval result.
+    # Contains the cited text from the data source.
     #
     # @!attribute [rw] text
-    #   Content of a retrieval result in text
+    #   The cited text from the data source.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievalResultContent AWS API Documentation
@@ -862,29 +1026,29 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # The source location of a retrieval result.
-    #
-    # @!attribute [rw] type
-    #   The location type of a retrieval result.
-    #   @return [String]
+    # Contains information about the location of the data source.
     #
     # @!attribute [rw] s3_location
-    #   The S3 location of a retrieval result.
+    #   Contains the S3 location of the data source.
     #   @return [Types::RetrievalResultS3Location]
     #
+    # @!attribute [rw] type
+    #   The type of the location of the data source.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievalResultLocation AWS API Documentation
     #
     class RetrievalResultLocation < Struct.new(
-      :type,
-      :s3_location)
+      :s3_location,
+      :type)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # The S3 location of a retrieval result.
+    # Contains the S3 location of the data source.
     #
     # @!attribute [rw] uri
-    #   URI of S3 location
+    #   The S3 URI of the data source.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievalResultS3Location AWS API Documentation
@@ -895,29 +1059,29 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Configures the retrieval and generation for the session.
-    #
-    # @!attribute [rw] type
-    #   The type of RetrieveAndGenerate.
-    #   @return [String]
+    # Contains details about the resource being queried.
     #
     # @!attribute [rw] knowledge_base_configuration
-    #   Configurations for retrieval and generation for knowledge base.
+    #   Contains details about the resource being queried.
     #   @return [Types::KnowledgeBaseRetrieveAndGenerateConfiguration]
     #
+    # @!attribute [rw] type
+    #   The type of resource that is queried by the request.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateConfiguration AWS API Documentation
     #
     class RetrieveAndGenerateConfiguration < Struct.new(
-      :type,
-      :knowledge_base_configuration)
+      :knowledge_base_configuration,
+      :type)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Customer input of the turn
+    # Contains the query made to the knowledge base.
     #
     # @!attribute [rw] text
-    #   Customer input of the turn in text
+    #   The query made to the knowledge base.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateInput AWS API Documentation
@@ -928,10 +1092,10 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Service response of the turn
+    # Contains the response generated from querying the knowledge base.
     #
     # @!attribute [rw] text
-    #   Service response of the turn in text
+    #   The response generated from querying the knowledge base.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateOutput AWS API Documentation
@@ -942,59 +1106,64 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # @!attribute [rw] session_id
-    #   Identifier of the session.
-    #   @return [String]
-    #
     # @!attribute [rw] input
-    #   Customer input of the turn
+    #   Contains the query made to the knowledge base.
     #   @return [Types::RetrieveAndGenerateInput]
     #
     # @!attribute [rw] retrieve_and_generate_configuration
-    #   Configures the retrieval and generation for the session.
+    #   Contains details about the resource being queried and the foundation
+    #   model used for generation.
     #   @return [Types::RetrieveAndGenerateConfiguration]
     #
     # @!attribute [rw] session_configuration
-    #   Configures common parameters of the session.
+    #   Contains details about the session with the knowledge base.
     #   @return [Types::RetrieveAndGenerateSessionConfiguration]
     #
+    # @!attribute [rw] session_id
+    #   The unique identifier of the session. Reuse the same value to
+    #   continue the same session with the knowledge base.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateRequest AWS API Documentation
     #
     class RetrieveAndGenerateRequest < Struct.new(
-      :session_id,
       :input,
       :retrieve_and_generate_configuration,
-      :session_configuration)
+      :session_configuration,
+      :session_id)
       SENSITIVE = [:input]
       include Aws::Structure
     end
 
-    # @!attribute [rw] session_id
-    #   Identifier of the session.
-    #   @return [String]
+    # @!attribute [rw] citations
+    #   A list of segments of the generated response that are based on
+    #   sources in the knowledge base, alongside information about the
+    #   sources.
+    #   @return [Array<Types::Citation>]
     #
     # @!attribute [rw] output
-    #   Service response of the turn
+    #   Contains the response generated from querying the knowledge base.
     #   @return [Types::RetrieveAndGenerateOutput]
     #
-    # @!attribute [rw] citations
-    #   List of citations
-    #   @return [Array<Types::Citation>]
+    # @!attribute [rw] session_id
+    #   The unique identifier of the session. Reuse the same value to
+    #   continue the same session with the knowledge base.
+    #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateResponse AWS API Documentation
     #
     class RetrieveAndGenerateResponse < Struct.new(
-      :session_id,
+      :citations,
       :output,
-      :citations)
+      :session_id)
       SENSITIVE = [:output]
       include Aws::Structure
     end
 
-    # Configures common parameters of the session.
+    # Contains configuration about the session with the knowledge base.
     #
     # @!attribute [rw] kms_key_arn
-    #   The KMS key arn to encrypt the customer data of the session.
+    #   The ARN of the KMS key encrypting the session.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateSessionConfiguration AWS API Documentation
@@ -1006,57 +1175,61 @@ module Aws::BedrockAgentRuntime
     end
 
     # @!attribute [rw] knowledge_base_id
-    #   Identifier of the KnowledgeBase
+    #   The unique identifier of the knowledge base to query.
     #   @return [String]
     #
-    # @!attribute [rw] retrieval_query
-    #   Knowledge base input query.
-    #   @return [Types::KnowledgeBaseQuery]
+    # @!attribute [rw] next_token
+    #   If there are more results than can fit in the response, the response
+    #   returns a `nextToken`. Use this token in the `nextToken` field of
+    #   another request to retrieve the next batch of results.
+    #   @return [String]
     #
     # @!attribute [rw] retrieval_configuration
-    #   Search parameters for retrieving from knowledge base.
+    #   Contains details about how the results should be returned.
     #   @return [Types::KnowledgeBaseRetrievalConfiguration]
     #
-    # @!attribute [rw] next_token
-    #   Opaque continuation token of previous paginated response.
-    #   @return [String]
+    # @!attribute [rw] retrieval_query
+    #   The query to send the knowledge base.
+    #   @return [Types::KnowledgeBaseQuery]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveRequest AWS API Documentation
     #
     class RetrieveRequest < Struct.new(
       :knowledge_base_id,
-      :retrieval_query,
+      :next_token,
       :retrieval_configuration,
-      :next_token)
+      :retrieval_query)
       SENSITIVE = [:retrieval_query]
       include Aws::Structure
     end
 
-    # @!attribute [rw] retrieval_results
-    #   List of knowledge base retrieval results
-    #   @return [Array<Types::KnowledgeBaseRetrievalResult>]
-    #
     # @!attribute [rw] next_token
-    #   Opaque continuation token of previous paginated response.
+    #   If there are more results than can fit in the response, the response
+    #   returns a `nextToken`. Use this token in the `nextToken` field of
+    #   another request to retrieve the next batch of results.
     #   @return [String]
     #
+    # @!attribute [rw] retrieval_results
+    #   A list of results from querying the knowledge base.
+    #   @return [Array<Types::KnowledgeBaseRetrievalResult>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveResponse AWS API Documentation
     #
     class RetrieveResponse < Struct.new(
-      :retrieval_results,
-      :next_token)
+      :next_token,
+      :retrieval_results)
       SENSITIVE = [:retrieval_results]
       include Aws::Structure
     end
 
-    # Retrieved reference
+    # Contains metadata about a sources cited for the generated response.
     #
     # @!attribute [rw] content
-    #   Content of a retrieval result.
+    #   Contains the cited text from the data source.
     #   @return [Types::RetrievalResultContent]
     #
     # @!attribute [rw] location
-    #   The source location of a retrieval result.
+    #   Contains information about the location of the data source.
     #   @return [Types::RetrievalResultLocation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievedReference AWS API Documentation
@@ -1064,15 +1237,14 @@ module Aws::BedrockAgentRuntime
     class RetrievedReference < Struct.new(
       :content,
       :location)
-      SENSITIVE = []
+      SENSITIVE = [:content, :location]
       include Aws::Structure
     end
 
-    # This exception is thrown when a request is made beyond the service
-    # quota
+    # The number of requests exceeds the service quota. Resubmit your
+    # request later.
     #
     # @!attribute [rw] message
-    #   Non Blank String
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ServiceQuotaExceededException AWS API Documentation
@@ -1084,67 +1256,90 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Session state provided
+    # 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][1] for an action
+    # group or pass them when making an [InvokeAgent][2] request. Use
+    # session state attributes to control and provide conversational context
+    # for your agent and to help customize your agent's behavior. For more
+    # information, see [Session context][3].
     #
-    # @!attribute [rw] session_attributes
-    #   Session Attributes
-    #   @return [Hash<String,String>]
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/agents-lambda.html
+    # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html
+    # [3]: https://docs.aws.amazon.com/bedrock/latest/userguide/sessionstate.html
     #
     # @!attribute [rw] prompt_session_attributes
-    #   Prompt Session Attributes
+    #   Contains attributes that persist across a prompt and the values of
+    #   those attributes. These attributes replace the
+    #   $prompt\_session\_attributes$ placeholder variable in the
+    #   orchestration prompt template. For more information, see [Prompt
+    #   template placeholder variables][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-placeholders.html
+    #   @return [Hash<String,String>]
+    #
+    # @!attribute [rw] session_attributes
+    #   Contains attributes that persist across a session and the values of
+    #   those attributes.
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/SessionState AWS API Documentation
     #
     class SessionState < Struct.new(
-      :session_attributes,
-      :prompt_session_attributes)
+      :prompt_session_attributes,
+      :session_attributes)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Span of text
+    # Contains information about where the text with a citation begins and
+    # ends in the generated output.
     #
-    # @!attribute [rw] start
-    #   Start of span
+    # @!attribute [rw] end
+    #   Where the text with a citation ends in the generated output.
     #   @return [Integer]
     #
-    # @!attribute [rw] end
-    #   End of span
+    # @!attribute [rw] start
+    #   Where the text with a citation starts in the generated output.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Span AWS API Documentation
     #
     class Span < Struct.new(
-      :start,
-      :end)
+      :end,
+      :start)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Text response part
-    #
-    # @!attribute [rw] text
-    #   Response part in text
-    #   @return [String]
+    # Contains the part of the generated text that contains a citation,
+    # alongside where it begins and ends.
     #
     # @!attribute [rw] span
-    #   Span of text
+    #   Contains information about where the text with a citation begins and
+    #   ends in the generated output.
     #   @return [Types::Span]
     #
+    # @!attribute [rw] text
+    #   The part of the generated text that contains a citation.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/TextResponsePart AWS API Documentation
     #
     class TextResponsePart < Struct.new(
-      :text,
-      :span)
+      :span,
+      :text)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # This exception is thrown when the number of requests exceeds the limit
+    # The number of requests exceeds the limit. Resubmit your request later.
     #
     # @!attribute [rw] message
-    #   Non Blank String
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ThrottlingException AWS API Documentation
@@ -1156,69 +1351,95 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Trace contains intermidate response for customer
+    # Contains one part of the agent's reasoning process and results from
+    # calling API actions and querying knowledge bases. You can use the
+    # trace to understand how the agent arrived at the response it provided
+    # the customer. For more information, see [Trace enablement][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/agents-test.html#trace-enablement
     #
     # @note Trace is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of Trace corresponding to the set member.
     #
-    # @!attribute [rw] pre_processing_trace
-    #   Trace Part which contains information related to preprocessing step
-    #   @return [Types::PreProcessingTrace]
+    # @!attribute [rw] failure_trace
+    #   Contains information about the failure of the interaction.
+    #   @return [Types::FailureTrace]
     #
     # @!attribute [rw] orchestration_trace
-    #   Trace contains intermidate response during orchestration
+    #   Details about the orchestration step, in which the agent determines
+    #   the order in which actions are executed and which knowledge bases
+    #   are retrieved.
     #   @return [Types::OrchestrationTrace]
     #
     # @!attribute [rw] post_processing_trace
-    #   Trace Part which contains information related to post processing
-    #   step
+    #   Details about the post-processing step, in which the agent shapes
+    #   the response..
     #   @return [Types::PostProcessingTrace]
     #
-    # @!attribute [rw] failure_trace
-    #   Trace Part which is emitted when agent trace could not be generated
-    #   @return [Types::FailureTrace]
+    # @!attribute [rw] pre_processing_trace
+    #   Details about the pre-processing step, in which the agent
+    #   contextualizes and categorizes user inputs.
+    #   @return [Types::PreProcessingTrace]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Trace AWS API Documentation
     #
     class Trace < Struct.new(
-      :pre_processing_trace,
+      :failure_trace,
       :orchestration_trace,
       :post_processing_trace,
-      :failure_trace,
+      :pre_processing_trace,
       :unknown)
-      SENSITIVE = [:pre_processing_trace, :orchestration_trace, :post_processing_trace, :failure_trace]
+      SENSITIVE = [:failure_trace, :orchestration_trace, :post_processing_trace, :pre_processing_trace]
       include Aws::Structure
       include Aws::Structure::Union
 
-      class PreProcessingTrace < Trace; end
+      class FailureTrace < Trace; end
       class OrchestrationTrace < Trace; end
       class PostProcessingTrace < Trace; end
-      class FailureTrace < Trace; end
+      class PreProcessingTrace < Trace; end
       class Unknown < Trace; end
     end
 
-    # Trace Part which contains intermidate response for customer
+    # Contains information about the agent and session, alongside the
+    # agent's reasoning process and results from calling API actions and
+    # querying knowledge bases and metadata about the trace. You can use the
+    # trace to understand how the agent arrived at the response it provided
+    # the customer. For more information, see [Trace enablement][1].
     #
-    # @!attribute [rw] agent_id
-    #   Identifier of the agent.
-    #   @return [String]
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/agents-test.html#trace-enablement
     #
     # @!attribute [rw] agent_alias_id
-    #   Identifier of the agent alias.
+    #   The unique identifier of the alias of the agent.
+    #   @return [String]
+    #
+    # @!attribute [rw] agent_id
+    #   The unique identifier of the agent.
     #   @return [String]
     #
     # @!attribute [rw] session_id
-    #   Identifier of the session.
+    #   The unique identifier of the session with the agent.
     #   @return [String]
     #
     # @!attribute [rw] trace
-    #   Trace contains intermidate response for customer
+    #   Contains one part of the agent's reasoning process and results from
+    #   calling API actions and querying knowledge bases. You can use the
+    #   trace to understand how the agent arrived at the response it
+    #   provided the customer. For more information, see [Trace
+    #   enablement][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/agents-test.html#trace-enablement
     #   @return [Types::Trace]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/TracePart AWS API Documentation
     #
     class TracePart < Struct.new(
-      :agent_id,
       :agent_alias_id,
+      :agent_id,
       :session_id,
       :trace,
       :event_type)
@@ -1226,10 +1447,10 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # This exception is thrown when the request's input validation fails
+    # Input validation failed. Check your request parameters and retry the
+    # request.
     #
     # @!attribute [rw] message
-    #   Non Blank String
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ValidationException AWS API Documentation
@@ -1241,7 +1462,8 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
-    # Response body of is a stream
+    # The response from invoking the agent and associated citations and
+    # trace information.
     #
     # EventStream is an Enumerator of Events.
     #  #event_types #=> Array, returns all modeled event types in the stream
@@ -1252,17 +1474,17 @@ module Aws::BedrockAgentRuntime
 
       def event_types
         [
+          :access_denied_exception,
+          :bad_gateway_exception,
           :chunk,
-          :trace,
+          :conflict_exception,
+          :dependency_failed_exception,
           :internal_server_exception,
-          :validation_exception,
           :resource_not_found_exception,
           :service_quota_exceeded_exception,
           :throttling_exception,
-          :access_denied_exception,
-          :conflict_exception,
-          :dependency_failed_exception,
-          :bad_gateway_exception
+          :trace,
+          :validation_exception
         ]
       end