AWS bedrock-agentcore documentation change

Service: bedrock-agentcore · 2026-07-01 · Documentation low

File: bedrock-agentcore/latest/devguide/insights-one-time-report.md

Summary

Added CLI/TUI/SDK examples for running and viewing insights reports

Security assessment

The changes add operational examples without security context. No security features or vulnerabilities are addressed.

Diff

diff --git a/bedrock-agentcore/latest/devguide/insights-one-time-report.md b/bedrock-agentcore/latest/devguide/insights-one-time-report.md
index 1af38b9c2..48563273e 100644
--- a//bedrock-agentcore/latest/devguide/insights-one-time-report.md
+++ b//bedrock-agentcore/latest/devguide/insights-one-time-report.md
@@ -33,0 +34,41 @@ Use `StartBatchEvaluation` to run an on-demand insights analysis over your agent
+###### Example
+
+AgentCore CLI
+    
+    
+    
+    agentcore run insights --runtime MyAgent --insights Builtin.Insight.FailureAnalysis --lookback-days 7 --json
+
+The CLI is async by default — it prints the job ID and exits. Use `--wait` to block until the job completes:
+    
+    
+    agentcore run insights --runtime MyAgent --insights Builtin.Insight.FailureAnalysis --lookback-days 7 --wait --json
+
+If you have an online evaluation config already deployed, you can inherit its settings:
+    
+    
+    agentcore run insights --online-eval-config-arn <arn> --json
+
+Interactive
+    
+
+  1. Run `agentcore` to open the TUI, then select **run** and choose **Insights** :
+
+![Run menu: select Insights](/images/bedrock-agentcore/latest/devguide/images/tui/insights-run-select.png)
+
+  2. Choose the session source:
+
+![Run Insights wizard: select session source](/images/bedrock-agentcore/latest/devguide/images/tui/insights-run-source.png)
+
+  3. Select the insights to run:
+
+![Run Insights wizard: select insights](/images/bedrock-agentcore/latest/devguide/images/tui/insights-run-insights.png)
+
+Continue through the remaining wizard steps (sessions, lookback period, name) and confirm.
+
+
+
+
+AWS SDK (boto3)
+    
+    
@@ -79,0 +121,18 @@ You can also:
+###### Example
+
+AgentCore CLI
+    
+
+List all insights jobs:
+    
+    
+    agentcore view insights --json
+
+View detail for a specific job:
+    
+    
+    agentcore view insights <id> --json
+
+AWS SDK (boto3)
+    
+