aws-sdk-bedrockagentcore 1.12.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e09175f17a7c99016591fc4df53dc60d5a8224121475579a03d37319532e63c1
-  data.tar.gz: 2d69e9a091b40cf3abf6a16ec03632d33b4d27f2c5a266798b1b544097c788b8
+  metadata.gz: a0eab419c17bf8e80de29771367323d604f517afe4cf47634c4cfc778471e9b1
+  data.tar.gz: d09fab8525b960a06754c61dddf74f7f272386a008c05f887fe56c7533a98e76
 SHA512:
-  metadata.gz: 649bb660d58f0b2f6c387efc45a6be2c7e115645a4a99929bc5d762171d72559b189e4c611b108bd248366bf8ea259c8d1adffc9c762b83102d67cad5ed0f464
-  data.tar.gz: 245bb455ae1f1701cebaf9b52a95b939fd5a9be2cc936b9a358dfc0c5e399799070af1909546802875c8ab0ce22cbd2b012f9f672732927d6be0fc321e8d549d
+  metadata.gz: c05088ce4d59c35f2806f6e375d50759d429eb794ea37e62b80cbe9b6a5e9253d6d28ab4dbf9b50ff54b6d826a5bc1af3c2a25df5f8e86cf176f01e02e006296
+  data.tar.gz: afc10d7c3e1467fe4f1e86b23121bb6edd6424ef16ce38cd52f3279be7a986c2b1d8afb7279b75a85a08976e76c978138114620a69244fc86dc9af0fd177f289

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.13.0 (2025-12-02)
+------------------
+
+* Feature - Support for AgentCore Evaluations and Episodic memory strategy for AgentCore Memory.
+
 1.12.0 (2025-11-21)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.12.0
+1.13.0

data/lib/aws-sdk-bedrockagentcore/client.rb

@@ -878,6 +878,75 @@ module Aws::BedrockAgentCore
       req.send_request(options)
     end
 
+    # Performs on-demand evaluation of agent traces using a specified
+    # evaluator. This synchronous API accepts traces in OpenTelemetry format
+    # and returns immediate scoring results with detailed explanations.
+    #
+    # @option params [required, String] :evaluator_id
+    #   The unique identifier of the evaluator to use for scoring. Can be a
+    #   built-in evaluator (e.g., `Builtin.Helpfulness`,
+    #   `Builtin.Correctness`) or a custom evaluator ARN created through the
+    #   control plane API.
+    #
+    # @option params [required, Types::EvaluationInput] :evaluation_input
+    #   The input data containing agent session spans to be evaluated.
+    #   Includes a list of spans in OpenTelemetry format from supported
+    #   frameworks like Strands (AgentCore Runtime) or LangGraph with
+    #   OpenInference instrumentation.
+    #
+    # @option params [Types::EvaluationTarget] :evaluation_target
+    #   The specific trace or span IDs to evaluate within the provided input.
+    #   Allows targeting evaluation at different levels: individual tool
+    #   calls, single request-response interactions (traces), or entire
+    #   conversation sessions.
+    #
+    # @return [Types::EvaluateResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::EvaluateResponse#evaluation_results #evaluation_results} => Array<Types::EvaluationResultContent>
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.evaluate({
+    #     evaluator_id: "EvaluatorId", # required
+    #     evaluation_input: { # required
+    #       session_spans: [
+    #         {
+    #         },
+    #       ],
+    #     },
+    #     evaluation_target: {
+    #       span_ids: ["SpanId"],
+    #       trace_ids: ["TraceId"],
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.evaluation_results #=> Array
+    #   resp.evaluation_results[0].evaluator_arn #=> String
+    #   resp.evaluation_results[0].evaluator_id #=> String
+    #   resp.evaluation_results[0].evaluator_name #=> String
+    #   resp.evaluation_results[0].explanation #=> String
+    #   resp.evaluation_results[0].context.span_context.session_id #=> String
+    #   resp.evaluation_results[0].context.span_context.trace_id #=> String
+    #   resp.evaluation_results[0].context.span_context.span_id #=> String
+    #   resp.evaluation_results[0].value #=> Float
+    #   resp.evaluation_results[0].label #=> String
+    #   resp.evaluation_results[0].token_usage.input_tokens #=> Integer
+    #   resp.evaluation_results[0].token_usage.output_tokens #=> Integer
+    #   resp.evaluation_results[0].token_usage.total_tokens #=> Integer
+    #   resp.evaluation_results[0].error_message #=> String
+    #   resp.evaluation_results[0].error_code #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/Evaluate AWS API Documentation
+    #
+    # @overload evaluate(params = {})
+    # @param [Hash] params ({})
+    def evaluate(params = {}, options = {})
+      req = build_request(:evaluate, params)
+      req.send_request(options)
+    end
+
     # Retrieves the A2A agent card associated with an AgentCore Runtime
     # agent.
     #
@@ -942,9 +1011,9 @@ module Aws::BedrockAgentCore
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/API_StartBrowserSession.html
-    # [2]: https://docs.aws.amazon.com/API_ListBrowserSessions.html
-    # [3]: https://docs.aws.amazon.com/API_StopBrowserSession.html
+    # [1]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_StartBrowserSession.html
+    # [2]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_ListBrowserSessions.html
+    # [3]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_StopBrowserSession.html
     #
     # @option params [required, String] :browser_identifier
     #   The unique identifier of the browser associated with the session.
@@ -1015,9 +1084,9 @@ module Aws::BedrockAgentCore
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/API_StartCodeInterpreterSession.html
-    # [2]: https://docs.aws.amazon.com/API_ListCodeInterpreterSessions.html
-    # [3]: https://docs.aws.amazon.com/API_StopCodeInterpreterSession.html
+    # [1]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_StartCodeInterpreterSession.html
+    # [2]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_ListCodeInterpreterSessions.html
+    # [3]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_StopCodeInterpreterSession.html
     #
     # @option params [required, String] :code_interpreter_identifier
     #   The unique identifier of the code interpreter associated with the
@@ -1146,6 +1215,8 @@ module Aws::BedrockAgentCore
     #   resp.memory_record.namespaces #=> Array
     #   resp.memory_record.namespaces[0] #=> String
     #   resp.memory_record.created_at #=> Time
+    #   resp.memory_record.metadata #=> Hash
+    #   resp.memory_record.metadata["MetadataKey"].string_value #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/GetMemoryRecord AWS API Documentation
     #
@@ -1530,8 +1601,8 @@ module Aws::BedrockAgentCore
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/API_StartCodeInterpreterSession.html
-    # [2]: https://docs.aws.amazon.com/API_GetCodeInterpreterSession.html
+    # [1]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_StartCodeInterpreterSession.html
+    # [2]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_GetCodeInterpreterSession.html
     #
     # @option params [required, String] :code_interpreter_identifier
     #   The unique identifier of the code interpreter associated with the
@@ -1894,8 +1965,8 @@ module Aws::BedrockAgentCore
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/API_StartBrowserSession.html
-    # [2]: https://docs.aws.amazon.com/API_GetBrowserSession.html
+    # [1]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_StartBrowserSession.html
+    # [2]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_GetBrowserSession.html
     #
     # @option params [required, String] :browser_identifier
     #   The unique identifier of the browser to list sessions for. If
@@ -1973,8 +2044,8 @@ module Aws::BedrockAgentCore
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/API_StartCodeInterpreterSession.html
-    # [2]: https://docs.aws.amazon.com/API_GetCodeInterpreterSession.html
+    # [1]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_StartCodeInterpreterSession.html
+    # [2]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_GetCodeInterpreterSession.html
     #
     # @option params [required, String] :code_interpreter_identifier
     #   The unique identifier of the code interpreter to list sessions for. If
@@ -2248,6 +2319,8 @@ module Aws::BedrockAgentCore
     #   resp.memory_record_summaries[0].namespaces[0] #=> String
     #   resp.memory_record_summaries[0].created_at #=> Time
     #   resp.memory_record_summaries[0].score #=> Float
+    #   resp.memory_record_summaries[0].metadata #=> Hash
+    #   resp.memory_record_summaries[0].metadata["MetadataKey"].string_value #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/ListMemoryRecords AWS API Documentation
@@ -2360,6 +2433,19 @@ module Aws::BedrockAgentCore
     #       search_query: "SearchCriteriaSearchQueryString", # required
     #       memory_strategy_id: "MemoryStrategyId",
     #       top_k: 1,
+    #       metadata_filters: [
+    #         {
+    #           left: { # required
+    #             metadata_key: "MetadataKey",
+    #           },
+    #           operator: "EQUALS_TO", # required, accepts EQUALS_TO, EXISTS, NOT_EXISTS
+    #           right: {
+    #             metadata_value: {
+    #               string_value: "MetadataValueStringValueString",
+    #             },
+    #           },
+    #         },
+    #       ],
     #     },
     #     next_token: "PaginationToken",
     #     max_results: 1,
@@ -2375,6 +2461,8 @@ module Aws::BedrockAgentCore
     #   resp.memory_record_summaries[0].namespaces[0] #=> String
     #   resp.memory_record_summaries[0].created_at #=> Time
     #   resp.memory_record_summaries[0].score #=> Float
+    #   resp.memory_record_summaries[0].metadata #=> Hash
+    #   resp.memory_record_summaries[0].metadata["MetadataKey"].string_value #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/RetrieveMemoryRecords AWS API Documentation
@@ -2406,9 +2494,9 @@ module Aws::BedrockAgentCore
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/API_GetBrowserSession.html
-    # [2]: https://docs.aws.amazon.com/API_UpdateBrowserStream.html
-    # [3]: https://docs.aws.amazon.com/API_StopBrowserSession.html
+    # [1]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_GetBrowserSession.html
+    # [2]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_UpdateBrowserStream.html
+    # [3]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_StopBrowserSession.html
     #
     # @option params [String] :trace_id
     #   The trace identifier for request tracking.
@@ -2506,9 +2594,9 @@ module Aws::BedrockAgentCore
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/API_InvokeCodeInterpreter.html
-    # [2]: https://docs.aws.amazon.com/API_GetCodeInterpreterSession.html
-    # [3]: https://docs.aws.amazon.com/API_StopCodeInterpreterSession.html
+    # [1]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_InvokeCodeInterpreter.html
+    # [2]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_GetCodeInterpreterSession.html
+    # [3]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_StopCodeInterpreterSession.html
     #
     # @option params [String] :trace_id
     #   The trace identifier for request tracking.
@@ -2638,8 +2726,8 @@ module Aws::BedrockAgentCore
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/API_StartBrowserSession.html
-    # [2]: https://docs.aws.amazon.com/API_GetBrowserSession.html
+    # [1]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_StartBrowserSession.html
+    # [2]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_GetBrowserSession.html
     #
     # @option params [String] :trace_id
     #   The trace identifier for request tracking.
@@ -2710,8 +2798,8 @@ module Aws::BedrockAgentCore
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/API_StartCodeInterpreterSession.html
-    # [2]: https://docs.aws.amazon.com/API_GetCodeInterpreterSession.html
+    # [1]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_StartCodeInterpreterSession.html
+    # [2]: https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_GetCodeInterpreterSession.html
     #
     # @option params [String] :trace_id
     #   The trace identifier for request tracking.
@@ -2892,7 +2980,7 @@ module Aws::BedrockAgentCore
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-bedrockagentcore'
-      context[:gem_version] = '1.12.0'
+      context[:gem_version] = '1.13.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-bedrockagentcore/client_api.rb

@@ -60,6 +60,7 @@ module Aws::BedrockAgentCore
     ContentBlockList = Shapes::ListShape.new(name: 'ContentBlockList')
     ContentBlockType = Shapes::StringShape.new(name: 'ContentBlockType')
     ContentTextString = Shapes::StringShape.new(name: 'ContentTextString')
+    Context = Shapes::UnionShape.new(name: 'Context')
     Conversational = Shapes::StructureShape.new(name: 'Conversational')
     CreateEventInput = Shapes::StructureShape.new(name: 'CreateEventInput')
     CreateEventOutput = Shapes::StructureShape.new(name: 'CreateEventOutput')
@@ -74,6 +75,19 @@ module Aws::BedrockAgentCore
     DeleteMemoryRecordOutput = Shapes::StructureShape.new(name: 'DeleteMemoryRecordOutput')
     Document = Shapes::DocumentShape.new(name: 'Document', document: true)
     Double = Shapes::FloatShape.new(name: 'Double')
+    DuplicateIdException = Shapes::StructureShape.new(name: 'DuplicateIdException')
+    EvaluateRequest = Shapes::StructureShape.new(name: 'EvaluateRequest')
+    EvaluateResponse = Shapes::StructureShape.new(name: 'EvaluateResponse')
+    EvaluationErrorCode = Shapes::StringShape.new(name: 'EvaluationErrorCode')
+    EvaluationErrorMessage = Shapes::StringShape.new(name: 'EvaluationErrorMessage')
+    EvaluationExplanation = Shapes::StringShape.new(name: 'EvaluationExplanation')
+    EvaluationInput = Shapes::UnionShape.new(name: 'EvaluationInput')
+    EvaluationResultContent = Shapes::StructureShape.new(name: 'EvaluationResultContent')
+    EvaluationResults = Shapes::ListShape.new(name: 'EvaluationResults')
+    EvaluationTarget = Shapes::UnionShape.new(name: 'EvaluationTarget')
+    EvaluatorArn = Shapes::StringShape.new(name: 'EvaluatorArn')
+    EvaluatorId = Shapes::StringShape.new(name: 'EvaluatorId')
+    EvaluatorName = Shapes::StringShape.new(name: 'EvaluatorName')
     Event = Shapes::StructureShape.new(name: 'Event')
     EventId = Shapes::StringShape.new(name: 'EventId')
     EventList = Shapes::ListShape.new(name: 'EventList')
@@ -146,6 +160,8 @@ module Aws::BedrockAgentCore
     MemoryContent = Shapes::UnionShape.new(name: 'MemoryContent')
     MemoryContentTextString = Shapes::StringShape.new(name: 'MemoryContentTextString')
     MemoryId = Shapes::StringShape.new(name: 'MemoryId')
+    MemoryMetadataFilterExpression = Shapes::StructureShape.new(name: 'MemoryMetadataFilterExpression')
+    MemoryMetadataFilterList = Shapes::ListShape.new(name: 'MemoryMetadataFilterList')
     MemoryRecord = Shapes::StructureShape.new(name: 'MemoryRecord')
     MemoryRecordCreateInput = Shapes::StructureShape.new(name: 'MemoryRecordCreateInput')
     MemoryRecordDeleteInput = Shapes::StructureShape.new(name: 'MemoryRecordDeleteInput')
@@ -202,6 +218,11 @@ module Aws::BedrockAgentCore
     SessionSummary = Shapes::StructureShape.new(name: 'SessionSummary')
     SessionSummaryList = Shapes::ListShape.new(name: 'SessionSummaryList')
     SessionType = Shapes::StringShape.new(name: 'SessionType')
+    Span = Shapes::DocumentShape.new(name: 'Span', document: true)
+    SpanContext = Shapes::StructureShape.new(name: 'SpanContext')
+    SpanId = Shapes::StringShape.new(name: 'SpanId')
+    SpanIds = Shapes::ListShape.new(name: 'SpanIds')
+    Spans = Shapes::ListShape.new(name: 'Spans')
     StartBrowserSessionRequest = Shapes::StructureShape.new(name: 'StartBrowserSessionRequest')
     StartBrowserSessionRequestTraceIdString = Shapes::StringShape.new(name: 'StartBrowserSessionRequestTraceIdString')
     StartBrowserSessionRequestTraceParentString = Shapes::StringShape.new(name: 'StartBrowserSessionRequestTraceParentString')
@@ -231,9 +252,12 @@ module Aws::BedrockAgentCore
     ThrottledException = Shapes::StructureShape.new(name: 'ThrottledException')
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
     Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
+    TokenUsage = Shapes::StructureShape.new(name: 'TokenUsage')
     ToolArguments = Shapes::StructureShape.new(name: 'ToolArguments')
     ToolName = Shapes::StringShape.new(name: 'ToolName')
     ToolResultStructuredContent = Shapes::StructureShape.new(name: 'ToolResultStructuredContent')
+    TraceId = Shapes::StringShape.new(name: 'TraceId')
+    TraceIds = Shapes::ListShape.new(name: 'TraceIds')
     UnauthorizedException = Shapes::StructureShape.new(name: 'UnauthorizedException')
     UpdateBrowserStreamRequest = Shapes::StructureShape.new(name: 'UpdateBrowserStreamRequest')
     UpdateBrowserStreamResponse = Shapes::StructureShape.new(name: 'UpdateBrowserStreamResponse')
@@ -365,6 +389,12 @@ module Aws::BedrockAgentCore
 
     ContentBlockList.member = Shapes::ShapeRef.new(shape: ContentBlock)
 
+    Context.add_member(:span_context, Shapes::ShapeRef.new(shape: SpanContext, location_name: "spanContext"))
+    Context.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    Context.add_member_subclass(:span_context, Types::Context::SpanContext)
+    Context.add_member_subclass(:unknown, Types::Context::Unknown)
+    Context.struct_class = Types::Context
+
     Conversational.add_member(:content, Shapes::ShapeRef.new(shape: Content, required: true, location_name: "content"))
     Conversational.add_member(:role, Shapes::ShapeRef.new(shape: Role, required: true, location_name: "role"))
     Conversational.struct_class = Types::Conversational
@@ -401,6 +431,45 @@ module Aws::BedrockAgentCore
     DeleteMemoryRecordOutput.add_member(:memory_record_id, Shapes::ShapeRef.new(shape: MemoryRecordId, required: true, location_name: "memoryRecordId"))
     DeleteMemoryRecordOutput.struct_class = Types::DeleteMemoryRecordOutput
 
+    DuplicateIdException.add_member(:message, Shapes::ShapeRef.new(shape: NonBlankString, location_name: "message"))
+    DuplicateIdException.struct_class = Types::DuplicateIdException
+
+    EvaluateRequest.add_member(:evaluator_id, Shapes::ShapeRef.new(shape: EvaluatorId, required: true, location: "uri", location_name: "evaluatorId"))
+    EvaluateRequest.add_member(:evaluation_input, Shapes::ShapeRef.new(shape: EvaluationInput, required: true, location_name: "evaluationInput"))
+    EvaluateRequest.add_member(:evaluation_target, Shapes::ShapeRef.new(shape: EvaluationTarget, location_name: "evaluationTarget"))
+    EvaluateRequest.struct_class = Types::EvaluateRequest
+
+    EvaluateResponse.add_member(:evaluation_results, Shapes::ShapeRef.new(shape: EvaluationResults, required: true, location_name: "evaluationResults"))
+    EvaluateResponse.struct_class = Types::EvaluateResponse
+
+    EvaluationInput.add_member(:session_spans, Shapes::ShapeRef.new(shape: Spans, location_name: "sessionSpans"))
+    EvaluationInput.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    EvaluationInput.add_member_subclass(:session_spans, Types::EvaluationInput::SessionSpans)
+    EvaluationInput.add_member_subclass(:unknown, Types::EvaluationInput::Unknown)
+    EvaluationInput.struct_class = Types::EvaluationInput
+
+    EvaluationResultContent.add_member(:evaluator_arn, Shapes::ShapeRef.new(shape: EvaluatorArn, required: true, location_name: "evaluatorArn"))
+    EvaluationResultContent.add_member(:evaluator_id, Shapes::ShapeRef.new(shape: EvaluatorId, required: true, location_name: "evaluatorId"))
+    EvaluationResultContent.add_member(:evaluator_name, Shapes::ShapeRef.new(shape: EvaluatorName, required: true, location_name: "evaluatorName"))
+    EvaluationResultContent.add_member(:explanation, Shapes::ShapeRef.new(shape: EvaluationExplanation, location_name: "explanation"))
+    EvaluationResultContent.add_member(:context, Shapes::ShapeRef.new(shape: Context, required: true, location_name: "context"))
+    EvaluationResultContent.add_member(:value, Shapes::ShapeRef.new(shape: Double, location_name: "value"))
+    EvaluationResultContent.add_member(:label, Shapes::ShapeRef.new(shape: String, location_name: "label"))
+    EvaluationResultContent.add_member(:token_usage, Shapes::ShapeRef.new(shape: TokenUsage, location_name: "tokenUsage"))
+    EvaluationResultContent.add_member(:error_message, Shapes::ShapeRef.new(shape: EvaluationErrorMessage, location_name: "errorMessage"))
+    EvaluationResultContent.add_member(:error_code, Shapes::ShapeRef.new(shape: EvaluationErrorCode, location_name: "errorCode"))
+    EvaluationResultContent.struct_class = Types::EvaluationResultContent
+
+    EvaluationResults.member = Shapes::ShapeRef.new(shape: EvaluationResultContent)
+
+    EvaluationTarget.add_member(:span_ids, Shapes::ShapeRef.new(shape: SpanIds, location_name: "spanIds"))
+    EvaluationTarget.add_member(:trace_ids, Shapes::ShapeRef.new(shape: TraceIds, location_name: "traceIds"))
+    EvaluationTarget.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    EvaluationTarget.add_member_subclass(:span_ids, Types::EvaluationTarget::SpanIds)
+    EvaluationTarget.add_member_subclass(:trace_ids, Types::EvaluationTarget::TraceIds)
+    EvaluationTarget.add_member_subclass(:unknown, Types::EvaluationTarget::Unknown)
+    EvaluationTarget.struct_class = Types::EvaluationTarget
+
     Event.add_member(:memory_id, Shapes::ShapeRef.new(shape: MemoryId, required: true, location_name: "memoryId"))
     Event.add_member(:actor_id, Shapes::ShapeRef.new(shape: ActorId, required: true, location_name: "actorId"))
     Event.add_member(:session_id, Shapes::ShapeRef.new(shape: SessionId, required: true, location_name: "sessionId"))
@@ -697,11 +766,19 @@ module Aws::BedrockAgentCore
     MemoryContent.add_member_subclass(:unknown, Types::MemoryContent::Unknown)
     MemoryContent.struct_class = Types::MemoryContent
 
+    MemoryMetadataFilterExpression.add_member(:left, Shapes::ShapeRef.new(shape: LeftExpression, required: true, location_name: "left"))
+    MemoryMetadataFilterExpression.add_member(:operator, Shapes::ShapeRef.new(shape: OperatorType, required: true, location_name: "operator"))
+    MemoryMetadataFilterExpression.add_member(:right, Shapes::ShapeRef.new(shape: RightExpression, location_name: "right"))
+    MemoryMetadataFilterExpression.struct_class = Types::MemoryMetadataFilterExpression
+
+    MemoryMetadataFilterList.member = Shapes::ShapeRef.new(shape: MemoryMetadataFilterExpression)
+
     MemoryRecord.add_member(:memory_record_id, Shapes::ShapeRef.new(shape: MemoryRecordId, required: true, location_name: "memoryRecordId"))
     MemoryRecord.add_member(:content, Shapes::ShapeRef.new(shape: MemoryContent, required: true, location_name: "content"))
     MemoryRecord.add_member(:memory_strategy_id, Shapes::ShapeRef.new(shape: MemoryStrategyId, required: true, location_name: "memoryStrategyId"))
     MemoryRecord.add_member(:namespaces, Shapes::ShapeRef.new(shape: NamespacesList, required: true, location_name: "namespaces"))
     MemoryRecord.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "createdAt"))
+    MemoryRecord.add_member(:metadata, Shapes::ShapeRef.new(shape: MetadataMap, location_name: "metadata"))
     MemoryRecord.struct_class = Types::MemoryRecord
 
     MemoryRecordCreateInput.add_member(:request_identifier, Shapes::ShapeRef.new(shape: RequestIdentifier, required: true, location_name: "requestIdentifier"))
@@ -727,6 +804,7 @@ module Aws::BedrockAgentCore
     MemoryRecordSummary.add_member(:namespaces, Shapes::ShapeRef.new(shape: NamespacesList, required: true, location_name: "namespaces"))
     MemoryRecordSummary.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "createdAt"))
     MemoryRecordSummary.add_member(:score, Shapes::ShapeRef.new(shape: Double, location_name: "score"))
+    MemoryRecordSummary.add_member(:metadata, Shapes::ShapeRef.new(shape: MetadataMap, location_name: "metadata"))
     MemoryRecordSummary.struct_class = Types::MemoryRecordSummary
 
     MemoryRecordSummaryList.member = Shapes::ShapeRef.new(shape: MemoryRecordSummary)
@@ -808,6 +886,7 @@ module Aws::BedrockAgentCore
     SearchCriteria.add_member(:search_query, Shapes::ShapeRef.new(shape: SearchCriteriaSearchQueryString, required: true, location_name: "searchQuery"))
     SearchCriteria.add_member(:memory_strategy_id, Shapes::ShapeRef.new(shape: MemoryStrategyId, location_name: "memoryStrategyId"))
     SearchCriteria.add_member(:top_k, Shapes::ShapeRef.new(shape: SearchCriteriaTopKInteger, location_name: "topK"))
+    SearchCriteria.add_member(:metadata_filters, Shapes::ShapeRef.new(shape: MemoryMetadataFilterList, location_name: "metadataFilters"))
     SearchCriteria.struct_class = Types::SearchCriteria
 
     ServiceException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
@@ -823,6 +902,15 @@ module Aws::BedrockAgentCore
 
     SessionSummaryList.member = Shapes::ShapeRef.new(shape: SessionSummary)
 
+    SpanContext.add_member(:session_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "sessionId"))
+    SpanContext.add_member(:trace_id, Shapes::ShapeRef.new(shape: String, location_name: "traceId"))
+    SpanContext.add_member(:span_id, Shapes::ShapeRef.new(shape: String, location_name: "spanId"))
+    SpanContext.struct_class = Types::SpanContext
+
+    SpanIds.member = Shapes::ShapeRef.new(shape: SpanId)
+
+    Spans.member = Shapes::ShapeRef.new(shape: Span)
+
     StartBrowserSessionRequest.add_member(:trace_id, Shapes::ShapeRef.new(shape: StartBrowserSessionRequestTraceIdString, location: "header", location_name: "X-Amzn-Trace-Id"))
     StartBrowserSessionRequest.add_member(:trace_parent, Shapes::ShapeRef.new(shape: StartBrowserSessionRequestTraceParentString, location: "header", location_name: "traceparent"))
     StartBrowserSessionRequest.add_member(:browser_identifier, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "browserIdentifier"))
@@ -907,6 +995,11 @@ module Aws::BedrockAgentCore
     ThrottlingException.add_member(:message, Shapes::ShapeRef.new(shape: NonBlankString, location_name: "message"))
     ThrottlingException.struct_class = Types::ThrottlingException
 
+    TokenUsage.add_member(:input_tokens, Shapes::ShapeRef.new(shape: Integer, location_name: "inputTokens"))
+    TokenUsage.add_member(:output_tokens, Shapes::ShapeRef.new(shape: Integer, location_name: "outputTokens"))
+    TokenUsage.add_member(:total_tokens, Shapes::ShapeRef.new(shape: Integer, location_name: "totalTokens"))
+    TokenUsage.struct_class = Types::TokenUsage
+
     ToolArguments.add_member(:code, Shapes::ShapeRef.new(shape: MaxLenString, location_name: "code"))
     ToolArguments.add_member(:language, Shapes::ShapeRef.new(shape: ProgrammingLanguage, location_name: "language"))
     ToolArguments.add_member(:clear_context, Shapes::ShapeRef.new(shape: Boolean, location_name: "clearContext"))
@@ -926,6 +1019,8 @@ module Aws::BedrockAgentCore
     ToolResultStructuredContent.add_member(:execution_time, Shapes::ShapeRef.new(shape: Double, location_name: "executionTime"))
     ToolResultStructuredContent.struct_class = Types::ToolResultStructuredContent
 
+    TraceIds.member = Shapes::ShapeRef.new(shape: TraceId)
+
     UnauthorizedException.add_member(:message, Shapes::ShapeRef.new(shape: NonBlankString, location_name: "message"))
     UnauthorizedException.struct_class = Types::UnauthorizedException
 
@@ -1084,6 +1179,23 @@ module Aws::BedrockAgentCore
         o.errors << Shapes::ShapeRef.new(shape: ServiceException)
       end)
 
+      api.add_operation(:evaluate, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "Evaluate"
+        o.http_method = "POST"
+        o.http_request_uri = "/evaluations/evaluate/{evaluatorId}"
+        o.input = Shapes::ShapeRef.new(shape: EvaluateRequest)
+        o.output = Shapes::ShapeRef.new(shape: EvaluateResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
+        o.errors << Shapes::ShapeRef.new(shape: DuplicateIdException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+      end)
+
       api.add_operation(:get_agent_card, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetAgentCard"
         o.http_method = "GET"

data/lib/aws-sdk-bedrockagentcore/errors.rb

@@ -29,6 +29,7 @@ module Aws::BedrockAgentCore
   # ## Error Classes
   # * {AccessDeniedException}
   # * {ConflictException}
+  # * {DuplicateIdException}
   # * {InternalServerException}
   # * {InvalidInputException}
   # * {ResourceNotFoundException}
@@ -76,6 +77,21 @@ module Aws::BedrockAgentCore
       end
     end
 
+    class DuplicateIdException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::BedrockAgentCore::Types::DuplicateIdException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class InternalServerException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -524,6 +524,31 @@ module Aws::BedrockAgentCore
       include Aws::Structure
     end
 
+    # The contextual information associated with an evaluation, including
+    # span context details that identify the specific traces and sessions
+    # being evaluated within the agent's execution flow.
+    #
+    # @note Context is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of Context corresponding to the set member.
+    #
+    # @!attribute [rw] span_context
+    #   The span context information that uniquely identifies the trace and
+    #   span being evaluated, including session ID, trace ID, and span ID
+    #   for precise targeting within the agent's execution flow.
+    #   @return [Types::SpanContext]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/Context AWS API Documentation
+    #
+    class Context < Struct.new(
+      :span_context,
+      :unknown)
+      SENSITIVE = []
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class SpanContext < Context; end
+      class Unknown < Context; end
+    end
+
     # Contains conversational content for an event payload.
     #
     # @!attribute [rw] content
@@ -686,6 +711,216 @@ module Aws::BedrockAgentCore
       include Aws::Structure
     end
 
+    # An exception thrown when attempting to create a resource with an
+    # identifier that already exists.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/DuplicateIdException AWS API Documentation
+    #
+    class DuplicateIdException < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] evaluator_id
+    #   The unique identifier of the evaluator to use for scoring. Can be a
+    #   built-in evaluator (e.g., `Builtin.Helpfulness`,
+    #   `Builtin.Correctness`) or a custom evaluator ARN created through the
+    #   control plane API.
+    #   @return [String]
+    #
+    # @!attribute [rw] evaluation_input
+    #   The input data containing agent session spans to be evaluated.
+    #   Includes a list of spans in OpenTelemetry format from supported
+    #   frameworks like Strands (AgentCore Runtime) or LangGraph with
+    #   OpenInference instrumentation.
+    #   @return [Types::EvaluationInput]
+    #
+    # @!attribute [rw] evaluation_target
+    #   The specific trace or span IDs to evaluate within the provided
+    #   input. Allows targeting evaluation at different levels: individual
+    #   tool calls, single request-response interactions (traces), or entire
+    #   conversation sessions.
+    #   @return [Types::EvaluationTarget]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/EvaluateRequest AWS API Documentation
+    #
+    class EvaluateRequest < Struct.new(
+      :evaluator_id,
+      :evaluation_input,
+      :evaluation_target)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] evaluation_results
+    #   The detailed evaluation results containing scores, explanations, and
+    #   metadata. Includes the evaluator information, numerical or
+    #   categorical ratings based on the evaluator's rating scale, and
+    #   token usage statistics for the evaluation process.
+    #   @return [Array<Types::EvaluationResultContent>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/EvaluateResponse AWS API Documentation
+    #
+    class EvaluateResponse < Struct.new(
+      :evaluation_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The input data structure containing agent session spans in
+    # OpenTelemetry format. Supports traces from frameworks like Strands
+    # (AgentCore Runtime) and LangGraph with OpenInference instrumentation
+    # for comprehensive evaluation.
+    #
+    # @note EvaluationInput is a union - when making an API calls you must set exactly one of the members.
+    #
+    # @!attribute [rw] session_spans
+    #   The collection of spans representing agent execution traces within a
+    #   session. Each span contains detailed information about tool calls,
+    #   model interactions, and other agent activities that can be evaluated
+    #   for quality and performance.
+    #   @return [Array<Hash,Array,String,Numeric,Boolean>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/EvaluationInput AWS API Documentation
+    #
+    class EvaluationInput < Struct.new(
+      :session_spans,
+      :unknown)
+      SENSITIVE = [:session_spans]
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class SessionSpans < EvaluationInput; end
+      class Unknown < EvaluationInput; end
+    end
+
+    # The comprehensive result of an evaluation containing the score,
+    # explanation, evaluator metadata, and execution details. Provides both
+    # quantitative ratings and qualitative insights about agent performance.
+    #
+    # @!attribute [rw] evaluator_arn
+    #   The Amazon Resource Name (ARN) of the evaluator used to generate
+    #   this result. For custom evaluators, this is the full ARN; for
+    #   built-in evaluators, this follows the pattern
+    #   `Builtin.{EvaluatorName}`.
+    #   @return [String]
+    #
+    # @!attribute [rw] evaluator_id
+    #   The unique identifier of the evaluator that produced this result.
+    #   This matches the `evaluatorId` provided in the evaluation request
+    #   and can be used to identify which evaluator generated specific
+    #   results.
+    #   @return [String]
+    #
+    # @!attribute [rw] evaluator_name
+    #   The human-readable name of the evaluator used for this evaluation.
+    #   For built-in evaluators, this is the descriptive name (e.g.,
+    #   "Helpfulness", "Correctness"); for custom evaluators, this is
+    #   the user-defined name.
+    #   @return [String]
+    #
+    # @!attribute [rw] explanation
+    #   The detailed explanation provided by the evaluator describing the
+    #   reasoning behind the assigned score. This qualitative feedback helps
+    #   understand why specific ratings were given and provides actionable
+    #   insights for improvement.
+    #   @return [String]
+    #
+    # @!attribute [rw] context
+    #   The contextual information associated with this evaluation result,
+    #   including span context details that identify the specific traces and
+    #   sessions that were evaluated.
+    #   @return [Types::Context]
+    #
+    # @!attribute [rw] value
+    #   The numerical score assigned by the evaluator according to its
+    #   configured rating scale. For numerical scales, this is a decimal
+    #   value within the defined range. This field is not allowed for
+    #   categorical scales.
+    #   @return [Float]
+    #
+    # @!attribute [rw] label
+    #   The categorical label assigned by the evaluator when using a
+    #   categorical rating scale. This provides a human-readable description
+    #   of the evaluation result (e.g., "Excellent", "Good", "Poor")
+    #   corresponding to the numerical value. For numerical scales, this
+    #   field is optional and provides a natural language explanation of
+    #   what the value means (e.g., value 0.5 = "Somewhat Helpful").
+    #   @return [String]
+    #
+    # @!attribute [rw] token_usage
+    #   The token consumption statistics for this evaluation, including
+    #   input tokens, output tokens, and total tokens used by the underlying
+    #   language model during the evaluation process.
+    #   @return [Types::TokenUsage]
+    #
+    # @!attribute [rw] error_message
+    #   The error message describing what went wrong if the evaluation
+    #   failed. Provides detailed information about evaluation failures to
+    #   help diagnose and resolve issues with evaluator configuration or
+    #   input data.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_code
+    #   The error code indicating the type of failure that occurred during
+    #   evaluation. Used to programmatically identify and handle different
+    #   categories of evaluation errors.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/EvaluationResultContent AWS API Documentation
+    #
+    class EvaluationResultContent < Struct.new(
+      :evaluator_arn,
+      :evaluator_id,
+      :evaluator_name,
+      :explanation,
+      :context,
+      :value,
+      :label,
+      :token_usage,
+      :error_message,
+      :error_code)
+      SENSITIVE = [:explanation]
+      include Aws::Structure
+    end
+
+    # The specification of which trace or span IDs to evaluate within the
+    # provided input data. Allows precise targeting of evaluation at
+    # different levels: tool calls, traces, or sessions.
+    #
+    # @note EvaluationTarget is a union - when making an API calls you must set exactly one of the members.
+    #
+    # @!attribute [rw] span_ids
+    #   The list of specific span IDs to evaluate within the provided
+    #   traces. Used to target evaluation at individual tool calls or
+    #   specific operations within the agent's execution flow.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] trace_ids
+    #   The list of trace IDs to evaluate, representing complete
+    #   request-response interactions. Used to evaluate entire conversation
+    #   turns or specific agent interactions within a session.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/EvaluationTarget AWS API Documentation
+    #
+    class EvaluationTarget < Struct.new(
+      :span_ids,
+      :trace_ids,
+      :unknown)
+      SENSITIVE = []
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class SpanIds < EvaluationTarget; end
+      class TraceIds < EvaluationTarget; end
+      class Unknown < EvaluationTarget; end
+    end
+
     # Contains information about an event in an AgentCore Memory resource.
     #
     # @!attribute [rw] memory_id
@@ -2078,6 +2313,33 @@ module Aws::BedrockAgentCore
       class Unknown < MemoryContent; end
     end
 
+    # Filters to apply to metadata associated with a memory. Specify the
+    # metadata key and value in the `left` and `right` fields and use the
+    # `operator` field to define the relationship to match.
+    #
+    # @!attribute [rw] left
+    #   Left expression of the event metadata filter.
+    #   @return [Types::LeftExpression]
+    #
+    # @!attribute [rw] operator
+    #   The relationship between the metadata key and value to match when
+    #   applying the metadata filter.
+    #   @return [String]
+    #
+    # @!attribute [rw] right
+    #   Right expression of the `eventMetadata`filter.
+    #   @return [Types::RightExpression]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/MemoryMetadataFilterExpression AWS API Documentation
+    #
+    class MemoryMetadataFilterExpression < Struct.new(
+      :left,
+      :operator,
+      :right)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains information about a memory record in an AgentCore Memory
     # resource.
     #
@@ -2102,6 +2364,10 @@ module Aws::BedrockAgentCore
     #   The timestamp when the memory record was created.
     #   @return [Time]
     #
+    # @!attribute [rw] metadata
+    #   A map of metadata key-value pairs associated with a memory record.
+    #   @return [Hash<String,Types::MetadataValue>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/MemoryRecord AWS API Documentation
     #
     class MemoryRecord < Struct.new(
@@ -2109,7 +2375,8 @@ module Aws::BedrockAgentCore
       :content,
       :memory_strategy_id,
       :namespaces,
-      :created_at)
+      :created_at,
+      :metadata)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2230,6 +2497,10 @@ module Aws::BedrockAgentCore
     #   search query.
     #   @return [Float]
     #
+    # @!attribute [rw] metadata
+    #   A map of metadata key-value pairs associated with a memory record.
+    #   @return [Hash<String,Types::MetadataValue>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/MemoryRecordSummary AWS API Documentation
     #
     class MemoryRecordSummary < Struct.new(
@@ -2238,7 +2509,8 @@ module Aws::BedrockAgentCore
       :memory_strategy_id,
       :namespaces,
       :created_at,
-      :score)
+      :score,
+      :metadata)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2511,12 +2783,17 @@ module Aws::BedrockAgentCore
     #   value is used for semantic search ranking.
     #   @return [Integer]
     #
+    # @!attribute [rw] metadata_filters
+    #   Filters to apply to metadata associated with a memory.
+    #   @return [Array<Types::MemoryMetadataFilterExpression>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/SearchCriteria AWS API Documentation
     #
     class SearchCriteria < Struct.new(
       :search_query,
       :memory_strategy_id,
-      :top_k)
+      :top_k,
+      :metadata_filters)
       SENSITIVE = [:search_query]
       include Aws::Structure
     end
@@ -2576,6 +2853,39 @@ module Aws::BedrockAgentCore
       include Aws::Structure
     end
 
+    # The contextual information that uniquely identifies a span within the
+    # distributed tracing system. Contains session, trace, and span
+    # identifiers used to correlate evaluation results with specific agent
+    # execution points.
+    #
+    # @!attribute [rw] session_id
+    #   The unique identifier of the session containing this span. Sessions
+    #   represent complete conversation flows and are detected using
+    #   configurable `SessionTimeoutMinutes` (default 15 minutes).
+    #   @return [String]
+    #
+    # @!attribute [rw] trace_id
+    #   The unique identifier of the trace containing this span. Traces
+    #   represent individual request-response interactions within a session
+    #   and group related spans together.
+    #   @return [String]
+    #
+    # @!attribute [rw] span_id
+    #   The unique identifier of the specific span being referenced. Spans
+    #   represent individual operations like tool calls, model invocations,
+    #   or other discrete actions within the agent's execution.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/SpanContext AWS API Documentation
+    #
+    class SpanContext < Struct.new(
+      :session_id,
+      :trace_id,
+      :span_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] trace_id
     #   The trace identifier for request tracking.
     #   @return [String]
@@ -2999,6 +3309,38 @@ module Aws::BedrockAgentCore
       include Aws::Structure
     end
 
+    # The token consumption statistics for language model operations during
+    # evaluation. Provides detailed breakdown of input, output, and total
+    # tokens used for cost tracking and performance monitoring.
+    #
+    # @!attribute [rw] input_tokens
+    #   The number of tokens consumed for input processing during the
+    #   evaluation. Includes tokens from the evaluation prompt, agent
+    #   traces, and any additional context provided to the evaluator model.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] output_tokens
+    #   The number of tokens generated by the evaluator model in its
+    #   response. Includes tokens for the score, explanation, and any
+    #   additional output produced during the evaluation process.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] total_tokens
+    #   The total number of tokens consumed during the evaluation,
+    #   calculated as the sum of input and output tokens. Used for cost
+    #   calculation and rate limiting within the service limits.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/TokenUsage AWS API Documentation
+    #
+    class TokenUsage < Struct.new(
+      :input_tokens,
+      :output_tokens,
+      :total_tokens)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The collection of arguments that specify the operation to perform and
     # its parameters when invoking a tool in Amazon Bedrock. Different tools
     # require different arguments, and this structure provides a flexible

data/lib/aws-sdk-bedrockagentcore.rb

@@ -56,7 +56,7 @@ module Aws::BedrockAgentCore
   autoload :Endpoints, 'aws-sdk-bedrockagentcore/endpoints'
   autoload :EventStreams, 'aws-sdk-bedrockagentcore/event_streams'
 
-  GEM_VERSION = '1.12.0'
+  GEM_VERSION = '1.13.0'
 
 end
 

data/sig/client.rbs

@@ -212,6 +212,26 @@ module Aws
                                 ) -> _DeleteMemoryRecordResponseSuccess
                               | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DeleteMemoryRecordResponseSuccess
 
+      interface _EvaluateResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::EvaluateResponse]
+        def evaluation_results: () -> ::Array[Types::EvaluationResultContent]
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/BedrockAgentCore/Client.html#evaluate-instance_method
+      def evaluate: (
+                      evaluator_id: ::String,
+                      evaluation_input: {
+                        session_spans: Array[
+                          {
+                          },
+                        ]?
+                      },
+                      ?evaluation_target: {
+                        span_ids: Array[::String]?,
+                        trace_ids: Array[::String]?
+                      }
+                    ) -> _EvaluateResponseSuccess
+                  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _EvaluateResponseSuccess
+
       interface _GetAgentCardResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::GetAgentCardResponse]
         def runtime_session_id: () -> ::String
@@ -550,7 +570,20 @@ module Aws
                                      search_criteria: {
                                        search_query: ::String,
                                        memory_strategy_id: ::String?,
-                                       top_k: ::Integer?
+                                       top_k: ::Integer?,
+                                       metadata_filters: Array[
+                                         {
+                                           left: {
+                                             metadata_key: ::String?
+                                           },
+                                           operator: ("EQUALS_TO" | "EXISTS" | "NOT_EXISTS"),
+                                           right: {
+                                             metadata_value: {
+                                               string_value: ::String?
+                                             }?
+                                           }?
+                                         },
+                                       ]?
                                      },
                                      ?next_token: ::String,
                                      ?max_results: ::Integer

data/sig/errors.rbs

@@ -17,6 +17,9 @@ module Aws
       class ConflictException < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end
+      class DuplicateIdException < ::Aws::Errors::ServiceError
+        def message: () -> ::String
+      end
       class InternalServerException < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end

data/sig/types.rbs

@@ -152,6 +152,17 @@ module Aws::BedrockAgentCore
       SENSITIVE: []
     end
 
+    class Context
+      attr_accessor span_context: Types::SpanContext
+      attr_accessor unknown: untyped
+      SENSITIVE: []
+
+      class SpanContext < Context
+      end
+      class Unknown < Context
+      end
+    end
+
     class Conversational
       attr_accessor content: Types::Content
       attr_accessor role: ("ASSISTANT" | "USER" | "TOOL" | "OTHER")
@@ -199,6 +210,62 @@ module Aws::BedrockAgentCore
       SENSITIVE: []
     end
 
+    class DuplicateIdException
+      attr_accessor message: ::String
+      SENSITIVE: []
+    end
+
+    class EvaluateRequest
+      attr_accessor evaluator_id: ::String
+      attr_accessor evaluation_input: Types::EvaluationInput
+      attr_accessor evaluation_target: Types::EvaluationTarget
+      SENSITIVE: []
+    end
+
+    class EvaluateResponse
+      attr_accessor evaluation_results: ::Array[Types::EvaluationResultContent]
+      SENSITIVE: []
+    end
+
+    class EvaluationInput
+      attr_accessor session_spans: ::Array[untyped]
+      attr_accessor unknown: untyped
+      SENSITIVE: [:session_spans]
+
+      class SessionSpans < EvaluationInput
+      end
+      class Unknown < EvaluationInput
+      end
+    end
+
+    class EvaluationResultContent
+      attr_accessor evaluator_arn: ::String
+      attr_accessor evaluator_id: ::String
+      attr_accessor evaluator_name: ::String
+      attr_accessor explanation: ::String
+      attr_accessor context: Types::Context
+      attr_accessor value: ::Float
+      attr_accessor label: ::String
+      attr_accessor token_usage: Types::TokenUsage
+      attr_accessor error_message: ::String
+      attr_accessor error_code: ::String
+      SENSITIVE: [:explanation]
+    end
+
+    class EvaluationTarget
+      attr_accessor span_ids: ::Array[::String]
+      attr_accessor trace_ids: ::Array[::String]
+      attr_accessor unknown: untyped
+      SENSITIVE: []
+
+      class SpanIds < EvaluationTarget
+      end
+      class TraceIds < EvaluationTarget
+      end
+      class Unknown < EvaluationTarget
+      end
+    end
+
     class Event
       attr_accessor memory_id: ::String
       attr_accessor actor_id: ::String
@@ -591,12 +658,20 @@ module Aws::BedrockAgentCore
       end
     end
 
+    class MemoryMetadataFilterExpression
+      attr_accessor left: Types::LeftExpression
+      attr_accessor operator: ("EQUALS_TO" | "EXISTS" | "NOT_EXISTS")
+      attr_accessor right: Types::RightExpression
+      SENSITIVE: []
+    end
+
     class MemoryRecord
       attr_accessor memory_record_id: ::String
       attr_accessor content: Types::MemoryContent
       attr_accessor memory_strategy_id: ::String
       attr_accessor namespaces: ::Array[::String]
       attr_accessor created_at: ::Time
+      attr_accessor metadata: ::Hash[::String, Types::MetadataValue]
       SENSITIVE: []
     end
 
@@ -630,6 +705,7 @@ module Aws::BedrockAgentCore
       attr_accessor namespaces: ::Array[::String]
       attr_accessor created_at: ::Time
       attr_accessor score: ::Float
+      attr_accessor metadata: ::Hash[::String, Types::MetadataValue]
       SENSITIVE: []
     end
 
@@ -723,6 +799,7 @@ module Aws::BedrockAgentCore
       attr_accessor search_query: ::String
       attr_accessor memory_strategy_id: ::String
       attr_accessor top_k: ::Integer
+      attr_accessor metadata_filters: ::Array[Types::MemoryMetadataFilterExpression]
       SENSITIVE: [:search_query]
     end
 
@@ -744,6 +821,13 @@ module Aws::BedrockAgentCore
       SENSITIVE: []
     end
 
+    class SpanContext
+      attr_accessor session_id: ::String
+      attr_accessor trace_id: ::String
+      attr_accessor span_id: ::String
+      SENSITIVE: []
+    end
+
     class StartBrowserSessionRequest
       attr_accessor trace_id: ::String
       attr_accessor trace_parent: ::String
@@ -860,6 +944,13 @@ module Aws::BedrockAgentCore
       SENSITIVE: []
     end
 
+    class TokenUsage
+      attr_accessor input_tokens: ::Integer
+      attr_accessor output_tokens: ::Integer
+      attr_accessor total_tokens: ::Integer
+      SENSITIVE: []
+    end
+
     class ToolArguments
       attr_accessor code: ::String
       attr_accessor language: ("python" | "javascript" | "typescript")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-bedrockagentcore
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.13.0
 platform: ruby
 authors:
 - Amazon Web Services