Package software.amazon.awscdk.services.bedrockagentcore

Class OnlineEvaluationConfig

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.bedrockagentcore.OnlineEvaluationBase

software.amazon.awscdk.services.bedrockagentcore.OnlineEvaluationConfig

All Implemented Interfaces:

IOnlineEvaluationConfigRef, IEnvironmentAware, IResource, IOnlineEvaluationConfig, IGrantable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.129.0 (build eaca441)",
           date="2026-05-19T08:18:44.489Z")
@Stability(Stable)
public class OnlineEvaluationConfig
extends OnlineEvaluationBase

Online evaluation configuration for Amazon Bedrock AgentCore.

Enables continuous evaluation of agent performance using built-in or custom evaluators. Supports CloudWatch Logs and Agent Endpoint data sources.

Example:

 // Basic usage with built-in evaluators
 OnlineEvaluationConfig evaluation = OnlineEvaluationConfig.Builder.create(this, "MyEvaluation")
         .onlineEvaluationConfigName("my_evaluation")
         .evaluators(List.of(EvaluatorSelector.builtin(BuiltinEvaluator.HELPFULNESS), EvaluatorSelector.builtin(BuiltinEvaluator.CORRECTNESS)))
         .dataSource(DataSourceConfig.fromCloudWatchLogs(CloudWatchLogsDataSourceConfig.builder()
                 .logGroupNames(List.of("/aws/bedrock-agentcore/my-agent"))
                 .serviceNames(List.of("my-agent.default"))
                 .build()))
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	OnlineEvaluationConfig.Builder	A fluent builder for OnlineEvaluationConfig.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.bedrockagentcore.IOnlineEvaluationConfig

IOnlineEvaluationConfig.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.IResource

IResource.Jsii$Default

Field Summary

Fields

Modifier and Type	Field	Description
static final String	PROPERTY_INJECTION_ID	Uniquely identifies this class.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	OnlineEvaluationConfig(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	OnlineEvaluationConfig(software.amazon.jsii.JsiiObjectRef objRef)
	OnlineEvaluationConfig(software.constructs.Construct scope, String id, OnlineEvaluationConfigProps props)

Method Summary

Modifier and Type	Method	Description
static IOnlineEvaluationConfig	fromOnlineEvaluationConfigArn(software.constructs.Construct scope, String id, String onlineEvaluationConfigArn)	Import an existing OnlineEvaluationConfig by its ARN.
static IOnlineEvaluationConfig	fromOnlineEvaluationConfigAttributes(software.constructs.Construct scope, String id, OnlineEvaluationConfigAttributes attrs)	Import an existing OnlineEvaluationConfig from its attributes.
static IOnlineEvaluationConfig	fromOnlineEvaluationConfigId(software.constructs.Construct scope, String id, String onlineEvaluationConfigId)	Import an existing OnlineEvaluationConfig by its ID.
String	getCreatedAt()	The timestamp when the configuration was created.
IRole	getExecutionRole()	The IAM execution role for the evaluation.
String	getExecutionStatus()	The execution status of the evaluation (ENABLED or DISABLED).
IPrincipal	getGrantPrincipal()	The principal to grant permissions to.
String	getOnlineEvaluationConfigArn()	The ARN of the online evaluation configuration.
String	getOnlineEvaluationConfigId()	The unique identifier of the online evaluation configuration.
String	getOnlineEvaluationConfigName()	The name of the online evaluation configuration.
String	getStatus()	The lifecycle status of the configuration.
String	getUpdatedAt()	The timestamp when the configuration was last updated.

Methods inherited from class software.amazon.awscdk.services.bedrockagentcore.OnlineEvaluationBase

getOnlineEvaluationConfigRef, grant

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isOwnedResource, isResource, with

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.constructs.IConstruct

getNode, with

Methods inherited from interface software.amazon.awscdk.interfaces.IEnvironmentAware

getEnv

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getStack

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

PROPERTY_INJECTION_ID

@Stability(Stable)
public static final String PROPERTY_INJECTION_ID

Uniquely identifies this class.

Constructor Details

OnlineEvaluationConfig

protected OnlineEvaluationConfig(software.amazon.jsii.JsiiObjectRef objRef)

OnlineEvaluationConfig

protected OnlineEvaluationConfig(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

OnlineEvaluationConfig

@Stability(Stable)
public OnlineEvaluationConfig(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 OnlineEvaluationConfigProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Details

fromOnlineEvaluationConfigArn

@Stability(Stable)
@NotNull
public static IOnlineEvaluationConfig fromOnlineEvaluationConfigArn(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 String onlineEvaluationConfigArn)

Import an existing OnlineEvaluationConfig by its ARN.

Parameters:

scope -

• The construct scope.

This parameter is required.

id -

• Construct identifier.

This parameter is required.

onlineEvaluationConfigArn -

• The configuration ARN to import.

This parameter is required.

Returns:

An IOnlineEvaluationConfig reference

fromOnlineEvaluationConfigAttributes

@Stability(Stable)
@NotNull
public static IOnlineEvaluationConfig fromOnlineEvaluationConfigAttributes(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 OnlineEvaluationConfigAttributes attrs)

Import an existing OnlineEvaluationConfig from its attributes.

Parameters:

scope -

• The construct scope.

This parameter is required.

id -

• Construct identifier.

This parameter is required.

attrs -

• The configuration attributes.

This parameter is required.

Returns:

An IOnlineEvaluationConfig reference

fromOnlineEvaluationConfigId

@Stability(Stable)
@NotNull
public static IOnlineEvaluationConfig fromOnlineEvaluationConfigId(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 String onlineEvaluationConfigId)

Import an existing OnlineEvaluationConfig by its ID.

Parameters:

scope -

• The construct scope.

This parameter is required.

id -

• Construct identifier.

This parameter is required.

onlineEvaluationConfigId -

• The configuration ID to import.

This parameter is required.

Returns:

An IOnlineEvaluationConfig reference

getGrantPrincipal

@Stability(Stable)
@NotNull
public IPrincipal getGrantPrincipal()

The principal to grant permissions to.

Specified by:

getGrantPrincipal in interface IGrantable

Specified by:

getGrantPrincipal in class OnlineEvaluationBase

getOnlineEvaluationConfigArn

@Stability(Stable)
@NotNull
public String getOnlineEvaluationConfigArn()

The ARN of the online evaluation configuration.

Specified by:

getOnlineEvaluationConfigArn in interface IOnlineEvaluationConfig

Specified by:

getOnlineEvaluationConfigArn in class OnlineEvaluationBase

getOnlineEvaluationConfigId

@Stability(Stable)
@NotNull
public String getOnlineEvaluationConfigId()

The unique identifier of the online evaluation configuration.

Specified by:

getOnlineEvaluationConfigId in interface IOnlineEvaluationConfig

Specified by:

getOnlineEvaluationConfigId in class OnlineEvaluationBase

getOnlineEvaluationConfigName

@Stability(Stable)
@NotNull
public String getOnlineEvaluationConfigName()

The name of the online evaluation configuration.

Specified by:

getOnlineEvaluationConfigName in interface IOnlineEvaluationConfig

Specified by:

getOnlineEvaluationConfigName in class OnlineEvaluationBase

getCreatedAt

@Stability(Stable)
@Nullable
public String getCreatedAt()

The timestamp when the configuration was created.

Specified by:

getCreatedAt in interface IOnlineEvaluationConfig

Specified by:

getCreatedAt in class OnlineEvaluationBase

getExecutionRole

@Stability(Stable)
@Nullable
public IRole getExecutionRole()

The IAM execution role for the evaluation.

Specified by:

getExecutionRole in interface IOnlineEvaluationConfig

Specified by:

getExecutionRole in class OnlineEvaluationBase

getExecutionStatus

@Stability(Stable)
@Nullable
public String getExecutionStatus()

The execution status of the evaluation (ENABLED or DISABLED).

Specified by:

getExecutionStatus in interface IOnlineEvaluationConfig

Specified by:

getExecutionStatus in class OnlineEvaluationBase

getStatus

@Stability(Stable)
@Nullable
public String getStatus()

The lifecycle status of the configuration.

Specified by:

getStatus in interface IOnlineEvaluationConfig

Specified by:

getStatus in class OnlineEvaluationBase

getUpdatedAt

@Stability(Stable)
@Nullable
public String getUpdatedAt()

The timestamp when the configuration was last updated.

Specified by:

getUpdatedAt in interface IOnlineEvaluationConfig

Specified by:

getUpdatedAt in class OnlineEvaluationBase