AWS bedrock-agentcore documentation change
Summary
Updated documentation for UpdateEvaluator API with improved formatting, added numbered steps, and clarified deployment requirements including notes about locked evaluators and project directory requirements
Security assessment
The changes are primarily formatting improvements, clarification of deployment procedures, and addition of notes about locked evaluators requiring pausing of online evaluations. No security vulnerabilities, weaknesses, or incidents are mentioned. The note about locked evaluators is about operational state management, not security.
Diff
diff --git a/bedrock-agentcore/latest/devguide/update-evaluator.md b/bedrock-agentcore/latest/devguide/update-evaluator.md index 0dace5bdf..8a60932b2 100644 --- a//bedrock-agentcore/latest/devguide/update-evaluator.md +++ b//bedrock-agentcore/latest/devguide/update-evaluator.md @@ -9 +9 @@ Code samples for AgentCore SDK and AWS SDKConsole -The `UpdateEvaluator` API modifies an existing custom evaluator's configuration, description, or evaluation level. This asynchronous operation is only allowed on unlocked evaluators. +The `UpdateEvaluator` API modifies an existing custom evaluator’s configuration, description, or evaluation level. This asynchronous operation is only allowed on unlocked evaluators. @@ -28 +28 @@ The following code samples demonstrate how to update evaluators using different -AgentCore CLI +###### Example @@ -29,0 +30 @@ AgentCore CLI +AgentCore CLI @@ -31 +31,0 @@ AgentCore CLI -To update an evaluator with the AgentCore CLI, edit the evaluator configuration in your `agentcore.json` file directly, then redeploy: @@ -32,0 +33 @@ To update an evaluator with the AgentCore CLI, edit the evaluator configuration + 1. To update an evaluator with the AgentCore CLI, edit the evaluator configuration in your `agentcore.json` file directly, then redeploy: @@ -36 +37 @@ To update an evaluator with the AgentCore CLI, edit the evaluator configuration -The CLI detects the configuration changes and updates the evaluator in your account. +Open `agentcore.json` , find the evaluator in the `evaluators` array, modify its configuration, then run `agentcore deploy` . Changes won’t take effect until you deploy. @@ -38 +39,7 @@ The CLI detects the configuration changes and updates the evaluator in your acco -AgentCore SDK +###### Note + +If the evaluator is locked by a running online evaluation, you must first pause the online evaluation with `agentcore pause online-eval` before making changes, or clone the evaluator instead. After deploying your changes, resume the online evaluation with `agentcore resume online-eval`. + +###### Note + +Run this from inside an AgentCore project directory (created with `agentcore create` ). @@ -42 +49,5 @@ AgentCore SDK - from bedrock_agentcore_starter_toolkit import Evaluation + +AgentCore SDK + + + 1. from bedrock_agentcore_starter_toolkit import Evaluation @@ -51 +61,0 @@ AgentCore SDK -AWS SDK @@ -55 +65,4 @@ AWS SDK - import boto3 +AWS SDK + + + 1. import boto3 @@ -64 +76,0 @@ AWS SDK -AWS CLI @@ -68 +80,4 @@ AWS CLI - aws bedrock-agentcore-control update-evaluator \ +AWS CLI + + + 1. aws bedrock-agentcore-control update-evaluator \ @@ -74 +92 @@ AWS CLI -Modify your custom evaluator settings using the console's editing interface, which provides form validation and guided configuration options. +Modify your custom evaluator settings using the console’s editing interface, which provides form validation and guided configuration options. @@ -76 +94 @@ Modify your custom evaluator settings using the console's editing interface, whi -###### To update a custom evaluator +**To update a custom evaluator**