diff --git a/command.md b/command.md index d62fe6d1a..73b1bbf63 100644 --- a/command.md +++ b/command.md @@ -2,7 +2,7 @@ # AgentCore CLI command reference -This reference was generated from `agentcore --help` for version `1.0.0-rc.5`. +This reference was generated from `agentcore --help` for version `1.0.0-rc.6`. ## Table of contents @@ -42,7 +42,6 @@ This reference was generated from `agentcore --help` for version `1.0.0-rc.5`. - [`agentcore add evaluator llm-as-a-judge`](#agentcore-add-evaluator-llm-as-a-judge) - [`agentcore add evaluator code-based`](#agentcore-add-evaluator-code-based) - [`agentcore add online-eval`](#agentcore-add-online-eval) - - [`agentcore add online-insight`](#agentcore-add-online-insight) - [`agentcore add config-bundle`](#agentcore-add-config-bundle) - [`agentcore add payment-manager`](#agentcore-add-payment-manager) - [`agentcore add payment-connector`](#agentcore-add-payment-connector) @@ -153,14 +152,7 @@ This reference was generated from `agentcore --help` for version `1.0.0-rc.5`. - [`agentcore eval online-eval pause`](#agentcore-eval-online-eval-pause) - [`agentcore eval online-eval resume`](#agentcore-eval-online-eval-resume) - [`agentcore eval online-eval delete`](#agentcore-eval-online-eval-delete) - - [`agentcore eval online-insight`](#agentcore-eval-online-insight) - - [`agentcore eval online-insight create`](#agentcore-eval-online-insight-create) - - [`agentcore eval online-insight get`](#agentcore-eval-online-insight-get) - - [`agentcore eval online-insight list`](#agentcore-eval-online-insight-list) - - [`agentcore eval online-insight update`](#agentcore-eval-online-insight-update) - - [`agentcore eval online-insight pause`](#agentcore-eval-online-insight-pause) - - [`agentcore eval online-insight resume`](#agentcore-eval-online-insight-resume) - - [`agentcore eval online-insight delete`](#agentcore-eval-online-insight-delete) + - [`agentcore eval online-eval logs`](#agentcore-eval-online-eval-logs) - [`agentcore eval dataset`](#agentcore-eval-dataset) - [`agentcore eval dataset create`](#agentcore-eval-dataset-create) - [`agentcore eval dataset get`](#agentcore-eval-dataset-get) @@ -174,11 +166,6 @@ This reference was generated from `agentcore --help` for version `1.0.0-rc.5`. - [`agentcore eval batch-evaluation get`](#agentcore-eval-batch-evaluation-get) - [`agentcore eval batch-evaluation list`](#agentcore-eval-batch-evaluation-list) - [`agentcore eval batch-evaluation stop`](#agentcore-eval-batch-evaluation-stop) - - [`agentcore eval batch-insights`](#agentcore-eval-batch-insights) - - [`agentcore eval batch-insights run`](#agentcore-eval-batch-insights-run) - - [`agentcore eval batch-insights get`](#agentcore-eval-batch-insights-get) - - [`agentcore eval batch-insights list`](#agentcore-eval-batch-insights-list) - - [`agentcore eval batch-insights stop`](#agentcore-eval-batch-insights-stop) - [`agentcore eval ondemand`](#agentcore-eval-ondemand) - [`agentcore eval ondemand evaluate`](#agentcore-eval-ondemand-evaluate) - [`agentcore eval ondemand simulate`](#agentcore-eval-ondemand-simulate) @@ -266,15 +253,18 @@ create a new project agentcore dev [options] ``` -run the project locally for development +test project changes: run Runtimes locally or deploy for Harnesses; --mode browser opens Agent Inspector. **Options** -- `--agent `: Runtime to run +- `--agent `: runtime or harness to run +- `--ui-port `: port for the Agent Inspector web UI (browser mode) +- `--mode `: how to run: browser (Agent Inspector web UI) or headless (runtime output or harness invoke guidance) (default: "headless") - `--port `: port for the development server - `--no-traces`: disable local OTEL trace collection -- `--mode `: how to run: browser (Agent Inspector web UI) or headless (agents stream to the terminal) (default: "headless") -- `--ui-port `: port for the Agent Inspector web UI (browser mode) +- `--target `: name of the aws-targets.json entry to deploy; the default target is created automatically from your AWS account and region on first deploy (default: "default") +- `--yes`: confirm removing the target's stack when the project declares nothing to deploy (default: false) +- `--skip-deploy`: skip deployment and use the deployed harnesses (default: false) ### `agentcore deploy` @@ -813,34 +803,12 @@ add an online evaluation config to the current project (not available in China r - `--endpoint `: the agent endpoint qualifier to scope monitoring to (requires --agent) - `--log-group-name `: CloudWatch log group name(s) for custom data sources (1-5; mutually exclusive with --agent) - `--service-name `: service name(s) to filter traces for custom data sources (requires --log-group-name) -- `--evaluators `: evaluator name(s), Builtin.\* IDs, or ARNs to apply +- `--evaluators `: evaluator name(s), Builtin.\* IDs, or ARNs to apply (required) - `--sampling-rate `: percentage of sessions to sample (0.01-100) (required) - `--description `: a description of the config's monitoring purpose - `--enable-on-create `: enable evaluation immediately after deploy (default true; pass false to add it paused) - `--tags `: tags as repeated key=value entries or a JSON object -#### `agentcore add online-insight` - -```text -agentcore add online-insight [options] -``` - -add an online insight config to the current project (not available in China regions) - -**Options** - -- `--name `: the name of the online insight config (required) -- `--agent `: Runtime name whose traffic to sample (mutually exclusive with --log-group-name) -- `--endpoint `: the agent endpoint qualifier to scope monitoring to (requires --agent) -- `--log-group-name `: CloudWatch log group name(s) for custom data sources (1-5; mutually exclusive with --agent) -- `--service-name `: service name(s) to filter traces for custom data sources (requires --log-group-name) -- `--insight `: insight ID(s) to apply: Builtin.Insight.\* identifiers or full ARNs (required) -- `--clustering-frequency `: insight clustering cadence(s): DAILY, WEEKLY, MONTHLY -- `--sampling-rate `: percentage of sessions to sample (0.01-100) (required) -- `--description `: a description of the config's monitoring purpose -- `--enable-on-create `: enable insights immediately after deploy (default true; pass false to add it paused) -- `--tags `: tags as repeated key=value entries or a JSON object - #### `agentcore add config-bundle` ```text @@ -953,7 +921,12 @@ build the project's deployable artifacts agentcore migrate [options] ``` -migrate an AgentCore CLI v0 project to the current project format +migrate an AgentCore CLI v0 project to the current project format, keeping its deployed resources + +**Options** + +- `--target `: the deployment target to migrate (required when the project is deployed to several) +- `--yes`: apply the changes without asking, when they are ready (default: false) ## Resource commands @@ -2306,119 +2279,23 @@ delete an online evaluation config by ID - `--id `: the ID of the online evaluation config to delete (required) -#### `agentcore eval online-insight` - -```text -agentcore eval online-insight [options] [command] -``` - -manage AgentCore online insight configs - -##### `agentcore eval online-insight create` - -```text -agentcore eval online-insight create [options] -``` - -create an online insight config - -**Options** - -- `--name `: the name of the online insight config (required) -- `--role-arn `: IAM role the online insight assumes (required) -- `--agent `: harness ID or Runtime ID whose traffic to sample -- `--endpoint `: the agent endpoint qualifier to scope monitoring to (default DEFAULT) -- `--data-source-config `: the traces to evaluate (JSON DataSourceConfig; inline, file://<path>, or - for stdin), as an alternative to --agent -- `--insight `: insight ID(s) to apply: Builtin.Insight.\* identifiers or full ARNs (required) -- `--clustering-frequency `: insight clustering cadence(s): DAILY, WEEKLY, MONTHLY -- `--sampling-rate `: percentage of sessions to sample (0.01-100) (required) -- `--session-timeout-minutes `: minutes of inactivity before a session is considered complete (1-1440, default 15) -- `--filters `: trace filters (JSON Filter[]; inline, file://<path>, or - for stdin) -- `--enable-on-create `: whether to enable evaluation immediately (default true; pass false to create it paused) -- `--description `: a description of the config's monitoring purpose - -##### `agentcore eval online-insight get` - -```text -agentcore eval online-insight get [options] -``` - -get an online insight config by ID - -**Options** - -- `--id `: the ID of the online insight config (required) - -##### `agentcore eval online-insight list` +##### `agentcore eval online-eval logs` ```text -agentcore eval online-insight list [options] +agentcore eval online-eval logs [options] ``` -list online insight configs +stream or search online-eval logs **Options** -- `--next-token `: pagination token returned by a previous request -- `--max-results `: maximum number of items to return - -##### `agentcore eval online-insight update` - -```text -agentcore eval online-insight update [options] -``` - -update an online insight config - -**Options** - -- `--id `: the ID of the online insight config to update (required) -- `--sampling-rate `: percentage of sessions to sample (0.01-100) -- `--session-timeout-minutes `: minutes of inactivity before a session is considered complete (1-1440) -- `--filters `: trace filters (JSON Filter[]; inline, file://<path>, or - for stdin) -- `--insight `: insight ID(s) to apply (replaces the existing list): Builtin.Insight.\* or ARN -- `--clustering-frequency `: insight clustering cadence(s) (replaces the existing set): DAILY, WEEKLY, MONTHLY -- `--agent `: repoint at a different Runtime ID -- `--endpoint `: re-scope monitoring to a different agent endpoint qualifier -- `--clear-endpoint `: reset the endpoint scope to the default qualifier (pass true) -- `--data-source-config `: replace the traces to evaluate (JSON DataSourceConfig; inline, file://<path>, or - for stdin) -- `--role-arn `: replace the IAM role the online insight assumes - -##### `agentcore eval online-insight pause` - -```text -agentcore eval online-insight pause [options] -``` - -pause an online insight config - -**Options** - -- `--id `: the ID of the online insight config to pause (required) - -##### `agentcore eval online-insight resume` - -```text -agentcore eval online-insight resume [options] -``` - -resume a paused online insight config - -**Options** - -- `--id `: the ID of the online insight config to resume (required) - -##### `agentcore eval online-insight delete` - -```text -agentcore eval online-insight delete [options] -``` - -delete an online insight config by ID - -**Options** - -- `--id `: the ID of the online insight config to delete (required) +- `--id `: the ID of the online-eval resource (required) +- `--since `: search window start: "5m", "1h", ISO 8601, epoch ms, or "now" +- `--until `: search window end: "5m", "1h", ISO 8601, epoch ms, or "now" +- `--tail`: tail new log records (default: false) +- `--level `: filter by log level (error, warn, info, debug) +- `--query `: CloudWatch Logs filter pattern +- `--limit `: maximum number of log records to return in search mode #### `agentcore eval dataset` @@ -2573,7 +2450,7 @@ replay a dataset against a Runtime, then batch-evaluate the resulting sessions agentcore eval batch-evaluation get [options] ``` -get a batch evaluation by ID, with CloudWatch-backed results when available +get a batch evaluation by ID, with CloudWatch-backed results and errors when available **Options** @@ -2605,74 +2482,6 @@ stop a running batch evaluation - `--id `: the ID of the batch evaluation to stop (required) -#### `agentcore eval batch-insights` - -```text -agentcore eval batch-insights [options] [command] -``` - -run and inspect AgentCore batch insights - -##### `agentcore eval batch-insights run` - -```text -agentcore eval batch-insights run [options] -``` - -start an asynchronous batch insights run over existing sessions - -**Options** - -- `--name `: batch insights name (must be unique in the account) (required) -- `--description `: optional description -- `--kms-key-arn `: KMS key to encrypt insights data at rest -- `--agent `: harness ID or Runtime ID whose sessions to use -- `--online-eval `: use sessions an online-eval config already sampled -- `--data-source-config `: the traces to read (JSON DataSourceConfig); escape hatch -- `--endpoint `: Runtime endpoint qualifier (default DEFAULT; only with --agent) -- `--start-time `: window start (ISO-8601, with --end-time) -- `--end-time `: window end (ISO-8601, with --start-time) -- `--session-ids `: specific session IDs (only with --agent) -- `--insight `: insight ID(s) to run -- `--evaluators `: optional evaluator ID(s) to run alongside the insights - -##### `agentcore eval batch-insights get` - -```text -agentcore eval batch-insights get [options] -``` - -get a batch insights run and its reports by ID - -**Options** - -- `--id `: the ID of the batch insights run (required) - -##### `agentcore eval batch-insights list` - -```text -agentcore eval batch-insights list [options] -``` - -list batch insights runs - -**Options** - -- `--next-token `: pagination token returned by a previous request -- `--max-results `: maximum number of batch insights runs to return - -##### `agentcore eval batch-insights stop` - -```text -agentcore eval batch-insights stop [options] -``` - -stop a running batch insights run - -**Options** - -- `--id `: the ID of the batch insights run to stop (required) - #### `agentcore eval ondemand` ```text diff --git a/package.json b/package.json index 426442a5b..2316c2311 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@aws/agentcore", - "version": "1.0.0-rc.5", + "version": "1.0.0-rc.6", "repository": { "type": "git", "url": "https://github.com/aws/agentcore-cli.git" diff --git a/src/assets/cdk/package.json b/src/assets/cdk/package.json index 2e9604407..78bc855c9 100644 --- a/src/assets/cdk/package.json +++ b/src/assets/cdk/package.json @@ -16,7 +16,7 @@ "typescript": "~5.9.3" }, "dependencies": { - "@aws/agentcore-cdk": "1.0.0-rc.3", + "@aws/agentcore-cdk": "1.0.0-rc.4", "aws-cdk-lib": "~2.269.0", "constructs": "~10.7.0" } diff --git a/src/core/project/backends/cdk/compatibility.ts b/src/core/project/backends/cdk/compatibility.ts index b9d545c1a..b5e423ef8 100644 --- a/src/core/project/backends/cdk/compatibility.ts +++ b/src/core/project/backends/cdk/compatibility.ts @@ -2,7 +2,7 @@ import { readFile } from "node:fs/promises"; import { join } from "node:path"; import semver from "semver"; -export const MINIMUM_COMPATIBLE_CDK_VERSION = "1.0.0-rc.3"; +export const MINIMUM_COMPATIBLE_CDK_VERSION = "1.0.0-rc.4"; export async function cdkCompatibilityWarning(cdkDirectory: string): Promise { const packagePath = join(cdkDirectory, "node_modules", "@aws", "agentcore-cdk", "package.json");