Skip to content

Create Online Evaluation Config

bedrockagentcorecontrol_create_online_evaluation_config R Documentation

Creates an online evaluation configuration for continuous monitoring of agent performance

Description

Creates an online evaluation configuration for continuous monitoring of agent performance. Online evaluation automatically samples live traffic from CloudWatch logs at specified rates and applies evaluators to assess agent quality in production.

Usage

bedrockagentcorecontrol_create_online_evaluation_config(clientToken,
  onlineEvaluationConfigName, description, rule, dataSourceConfig,
  evaluators, evaluationExecutionRoleArn, enableOnCreate, tags)

Arguments

clientToken

A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If you don't specify this field, a value is randomly generated for you. If this token matches a previous request, the service ignores the request, but doesn't return an error. For more information, see Ensuring idempotency.

onlineEvaluationConfigName

[required] The name of the online evaluation configuration. Must be unique within your account.

description

The description of the online evaluation configuration that explains its monitoring purpose and scope.

rule

[required] The evaluation rule that defines sampling configuration, filters, and session detection settings for the online evaluation.

dataSourceConfig

[required] The data source configuration that specifies CloudWatch log groups and service names to monitor for agent traces.

evaluators

[required] The list of evaluators to apply during online evaluation. Can include both built-in evaluators and custom evaluators created with create_evaluator.

evaluationExecutionRoleArn

[required] The Amazon Resource Name (ARN) of the IAM role that grants permissions to read from CloudWatch logs, write evaluation results, and invoke Amazon Bedrock models for evaluation. If the configuration references evaluators encrypted with a customer managed KMS key, this role must also have kms:Decrypt permission on the KMS key. The service validates this permission at configuration creation time. For more information, see Encryption at rest for AgentCore Evaluations.

enableOnCreate

[required] Whether to enable the online evaluation configuration immediately upon creation. If true, evaluation begins automatically.

tags

A map of tag keys and values to assign to an AgentCore Online Evaluation Config. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment.

Value

A list with the following syntax:

list(
  onlineEvaluationConfigArn = "string",
  onlineEvaluationConfigId = "string",
  createdAt = as.POSIXct(
    "2015-01-01"
  ),
  outputConfig = list(
    cloudWatchConfig = list(
      logGroupName = "string"
    )
  ),
  status = "ACTIVE"|"CREATING"|"CREATE_FAILED"|"UPDATING"|"UPDATE_FAILED"|"DELETING"|"ERROR",
  executionStatus = "ENABLED"|"DISABLED",
  failureReason = "string"
)

Request syntax

svc$create_online_evaluation_config(
  clientToken = "string",
  onlineEvaluationConfigName = "string",
  description = "string",
  rule = list(
    samplingConfig = list(
      samplingPercentage = 123.0
    ),
    filters = list(
      list(
        key = "string",
        operator = "Equals"|"NotEquals"|"GreaterThan"|"LessThan"|"GreaterThanOrEqual"|"LessThanOrEqual"|"Contains"|"NotContains",
        value = list(
          stringValue = "string",
          doubleValue = 123.0,
          booleanValue = TRUE|FALSE
        )
      )
    ),
    sessionConfig = list(
      sessionTimeoutMinutes = 123
    )
  ),
  dataSourceConfig = list(
    cloudWatchLogs = list(
      logGroupNames = list(
        "string"
      ),
      serviceNames = list(
        "string"
      )
    )
  ),
  evaluators = list(
    list(
      evaluatorId = "string"
    )
  ),
  evaluationExecutionRoleArn = "string",
  enableOnCreate = TRUE|FALSE,
  tags = list(
    "string"
  )
)