diff --git a/agent/README.md b/agent/README.md index 088a4d38..8c3c33fd 100644 --- a/agent/README.md +++ b/agent/README.md @@ -119,7 +119,7 @@ The `run.sh` script overrides the container's default CMD to run `python /app/sr | `AWS_SECRET_ACCESS_KEY` | Conditional† | | Explicit keys, if you are not using CLI-based resolution | | `AWS_SESSION_TOKEN` | No | | For temporary credentials | | `AWS_PROFILE` | No | | Profile for `aws configure export-credentials` in `run.sh`, or default profile when using the `~/.aws` mount fallback | -| `ANTHROPIC_MODEL` | No | `us.anthropic.claude-opus-4-8` | Bedrock **inference profile** ID for `InvokeModel` (see [inference profiles](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-use.html)). Must be the `us.`-prefixed profile ID, not a bare foundation-model ID — see [Model configuration](../docs/guides/DEVELOPER_GUIDE.md#model-configuration) | +| `ANTHROPIC_MODEL` | No | `us.anthropic.claude-opus-5` | Bedrock **inference profile** ID for `InvokeModel` (see [inference profiles](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-use.html)). Must be the `us.`-prefixed profile ID, not a bare foundation-model ID — see [Model configuration](../docs/guides/DEVELOPER_GUIDE.md#model-configuration) | | `MAX_TURNS` | No | `100` | Max agent turns before stopping | | `MAX_BUDGET_USD` | No | | **Local batch only** (shell env when running `entrypoint.py` directly). Range 0.01–100; agent stops when the budget is reached. For deployed AgentCore **server** mode and production tasks, set **`max_budget_usd`** on task creation (REST API, CLI `--max-budget`, or Blueprint default); the orchestrator sends it in the `/invocations` JSON body — server mode does not read `MAX_BUDGET_USD` from the environment. | | `DRY_RUN` | No | | Set to `1` to validate config and print the prompt without running the agent | @@ -133,7 +133,7 @@ The `run.sh` script overrides the container's default CMD to run `python /app/sr including non-Jira tasks, so a warm AgentCore process cannot expose one tenant's OAuth or Forge credential to the next task. -**Bedrock model access (main model):** Configuring `ANTHROPIC_MODEL` and IAM credentials is not enough. Your AWS account must be able to **invoke** that model in Amazon Bedrock: follow [Request access to models](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html) (Marketplace permissions on first use, Anthropic first-time use where required, valid payment method for Marketplace-backed models). Always use an inference profile ID such as `us.anthropic.claude-opus-4-8`: a bare foundation-model ID cannot be invoked with on-demand throughput and Bedrock rejects it with `ValidationException`. IAM must also grant the model — see [Model configuration](../docs/guides/DEVELOPER_GUIDE.md#model-configuration) for the full layering. If the CLI stops with a message that the model is not available on your Bedrock deployment, fix model access in the console or switch `ANTHROPIC_MODEL` to an entitled profile, then retry. +**Bedrock model access (main model):** Configuring `ANTHROPIC_MODEL` and IAM credentials is not enough. Your AWS account must be able to **invoke** that model in Amazon Bedrock: follow [Request access to models](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html) (Marketplace permissions on first use, Anthropic first-time use where required, valid payment method for Marketplace-backed models). Always use an inference profile ID such as `us.anthropic.claude-opus-5`: a bare foundation-model ID cannot be invoked with on-demand throughput and Bedrock rejects it with `ValidationException`. IAM must also grant the model — see [Model configuration](../docs/guides/DEVELOPER_GUIDE.md#model-configuration) for the full layering. If the CLI stops with a message that the model is not available on your Bedrock deployment, fix model access in the console or switch `ANTHROPIC_MODEL` to an entitled profile, then retry. **Pre-flight check model**: Claude Code runs a quick safety verification using a small Haiku model before executing each tool command. On Bedrock, the default Haiku model ID may not be enabled in your account, causing the check to time out with *"Pre-flight check is taking longer than expected"* warnings. The agent sets `ANTHROPIC_DEFAULT_HAIKU_MODEL` to a known-available Bedrock Haiku model ID to avoid this. If you see pre-flight timeout warnings, verify that this model is enabled in your Bedrock model access settings. @@ -145,7 +145,7 @@ tenant's OAuth or Forge credential to the next task. # Dry run — validate config, fetch issue, print assembled prompt, then exit DRY_RUN=1 ./agent/run.sh "owner/repo" 42 -# Run with a specific model (overrides the us.anthropic.claude-opus-4-8 default). +# Run with a specific model (overrides the us.anthropic.claude-opus-5 default). # Must be a `us.`-prefixed inference profile that IAM grants — see Model configuration. ANTHROPIC_MODEL="us.anthropic.claude-sonnet-4-6" ./agent/run.sh "owner/repo" 42 diff --git a/agent/src/config.py b/agent/src/config.py index a579f045..82f7e325 100644 --- a/agent/src/config.py +++ b/agent/src/config.py @@ -560,7 +560,7 @@ def build_config( resolved_github_token = github_token or resolve_github_token() resolved_aws_region = aws_region or os.environ.get("AWS_REGION", "") resolved_anthropic_model = anthropic_model or os.environ.get( - "ANTHROPIC_MODEL", "us.anthropic.claude-opus-4-8" + "ANTHROPIC_MODEL", "us.anthropic.claude-opus-5" ) # Small/fast auxiliary model (WebFetch summarization etc.). Falls back to the # deployed ANTHROPIC_DEFAULT_HAIKU_MODEL env, then the platform default. Must diff --git a/agent/src/models.py b/agent/src/models.py index 556b4e58..14a6c1f2 100644 --- a/agent/src/models.py +++ b/agent/src/models.py @@ -154,7 +154,7 @@ class TaskConfig(BaseModel): task_description: str = "" github_token: str = "" aws_region: str - anthropic_model: str = "us.anthropic.claude-opus-4-8" + anthropic_model: str = "us.anthropic.claude-opus-5" # The "small/fast" model Claude Code uses for auxiliary work (e.g. WebFetch # page summarization). Must be a cross-region INFERENCE-PROFILE id (``us.`` # prefix), not a bare foundation-model id — Claude 4.x cannot be invoked diff --git a/cli/src/repo-display.ts b/cli/src/repo-display.ts index b608ea26..fa7b04c9 100644 --- a/cli/src/repo-display.ts +++ b/cli/src/repo-display.ts @@ -45,7 +45,7 @@ export const PLATFORM_REPO_DEFAULTS = { * if it names a different model than the runtime invokes, doctor can report a * healthy stack while every task fails at turn 0 with AccessDenied. */ - model_id: 'us.anthropic.claude-opus-4-8', + model_id: 'us.anthropic.claude-opus-5', max_turns: 200, poll_interval_ms: 30_000, approval_gate_cap: 50, diff --git a/docs/design/REPO_ONBOARDING.md b/docs/design/REPO_ONBOARDING.md index 3b6f0122..a4b40dea 100644 --- a/docs/design/REPO_ONBOARDING.md +++ b/docs/design/REPO_ONBOARDING.md @@ -120,7 +120,7 @@ From lowest to highest priority: |---|---|---| | `compute_type` | `agentcore` | Platform constant | | `runtime_arn` | Stack-level env var | CDK stack props | -| `model_id` | `us.anthropic.claude-opus-4-8` | Python literal in `agent/src/config.py` (no CDK prop or env knob today) — see [Model configuration](../guides/DEVELOPER_GUIDE.md#model-configuration) | +| `model_id` | `us.anthropic.claude-opus-5` | Python literal in `agent/src/config.py` (no CDK prop or env knob today) — see [Model configuration](../guides/DEVELOPER_GUIDE.md#model-configuration) | | `max_turns` | 100 | Platform constant | | `max_budget_usd` | None (unlimited) | No platform default by design — a global ceiling would kill long tasks mid-change. Set a per-repo default with Blueprint `agent.maxBudgetUsd` (`0.01`–`100`, validated at synth) or per task with `--max-budget` / `max_budget_usd`. See [Per-repo overrides](../guides/USER_GUIDE.md#per-repo-overrides) for the complete list of surfaces a budget can come from | | `memory_token_budget` | 2000 | Platform constant | diff --git a/docs/guides/DEVELOPER_GUIDE.md b/docs/guides/DEVELOPER_GUIDE.md index e0c3a4c5..b8f1bf31 100644 --- a/docs/guides/DEVELOPER_GUIDE.md +++ b/docs/guides/DEVELOPER_GUIDE.md @@ -142,7 +142,7 @@ See the [Cedar policy guide](./CEDAR_POLICY_GUIDE.md) for the full authoring ref per-task payload model_id (layer 5) > blueprint agent.modelId (layer 4, arrives as stack env ANTHROPIC_MODEL) > stack env ANTHROPIC_MODEL (layer 3-adjacent / local shell) - > agent/src/config.py fallback (layer 2 — us.anthropic.claude-opus-4-8) + > agent/src/config.py fallback (layer 2 — us.anthropic.claude-opus-5) ``` Every one of those is gated by the **IAM invoke allowlist** (layer 1), which is itself gated by **account-level Bedrock model access**. Both gates are silent until invocation: a model that resolves fine through precedence still fails at turn 0 with `AccessDenied` if it is not in the grant list, and fails again if your account has not completed [Bedrock model access](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html) for it. @@ -160,7 +160,7 @@ throughput isn't supported. Retry your request with the ID or ARN of an inferenc profile that contains this model. ``` -So: `bedrockModels` context → `anthropic.claude-opus-4-8`. Everywhere else → `us.anthropic.claude-opus-4-8`. +So: `bedrockModels` context → `anthropic.claude-opus-5`. Everywhere else → `us.anthropic.claude-opus-5`. ### Bumping the default model @@ -336,7 +336,7 @@ The `--local-events` flag connects the agent container to DynamoDB Local on the | Variable | Default | Description | |---|---|---| -| `ANTHROPIC_MODEL` | `us.anthropic.claude-opus-4-8` | Bedrock inference-profile ID for the main coding model | +| `ANTHROPIC_MODEL` | `us.anthropic.claude-opus-5` | Bedrock inference-profile ID for the main coding model | | `MAX_TURNS` | `100` | Max agent turns before stopping | | `MAX_BUDGET_USD` | | Cost ceiling for local batch runs only (production uses the API field) | | `DRY_RUN` | | Set to `1` to validate and print prompt without running the agent | diff --git a/docs/guides/USER_GUIDE.md b/docs/guides/USER_GUIDE.md index 0ef78fb4..735daa09 100644 --- a/docs/guides/USER_GUIDE.md +++ b/docs/guides/USER_GUIDE.md @@ -221,7 +221,7 @@ Blueprints can configure per-repository settings that override platform defaults |---|---|---| | `compute_type` | Compute strategy (`agentcore` or `ecs`) | `agentcore` | | `runtime_arn` | AgentCore runtime ARN override | Platform default | -| `model_id` | Bedrock inference-profile ID (`us.`-prefixed) | `us.anthropic.claude-opus-4-8` | +| `model_id` | Bedrock inference-profile ID (`us.`-prefixed) | `us.anthropic.claude-opus-5` | | `max_turns` | Default turn limit for tasks | 100 | | `max_budget_usd` | Default cost budget in USD per task, `0.01`–`100` (Blueprint `agent.maxBudgetUsd`) | None (unlimited) | | `system_prompt_overrides` | Additional system prompt instructions | None | diff --git a/docs/src/content/docs/architecture/Repo-onboarding.md b/docs/src/content/docs/architecture/Repo-onboarding.md index f48523fc..2b70c09d 100644 --- a/docs/src/content/docs/architecture/Repo-onboarding.md +++ b/docs/src/content/docs/architecture/Repo-onboarding.md @@ -124,7 +124,7 @@ From lowest to highest priority: |---|---|---| | `compute_type` | `agentcore` | Platform constant | | `runtime_arn` | Stack-level env var | CDK stack props | -| `model_id` | `us.anthropic.claude-opus-4-8` | Python literal in `agent/src/config.py` (no CDK prop or env knob today) — see [Model configuration](/sample-autonomous-cloud-coding-agents/developer-guide/model-configuration) | +| `model_id` | `us.anthropic.claude-opus-5` | Python literal in `agent/src/config.py` (no CDK prop or env knob today) — see [Model configuration](/sample-autonomous-cloud-coding-agents/developer-guide/model-configuration) | | `max_turns` | 100 | Platform constant | | `max_budget_usd` | None (unlimited) | No platform default by design — a global ceiling would kill long tasks mid-change. Set a per-repo default with Blueprint `agent.maxBudgetUsd` (`0.01`–`100`, validated at synth) or per task with `--max-budget` / `max_budget_usd`. See [Per-repo overrides](/sample-autonomous-cloud-coding-agents/customizing/per-repo-overrides) for the complete list of surfaces a budget can come from | | `memory_token_budget` | 2000 | Platform constant | diff --git a/docs/src/content/docs/customizing/Per-repo-overrides.md b/docs/src/content/docs/customizing/Per-repo-overrides.md index 3eca5867..2584b76c 100644 --- a/docs/src/content/docs/customizing/Per-repo-overrides.md +++ b/docs/src/content/docs/customizing/Per-repo-overrides.md @@ -8,7 +8,7 @@ Blueprints can configure per-repository settings that override platform defaults |---|---|---| | `compute_type` | Compute strategy (`agentcore` or `ecs`) | `agentcore` | | `runtime_arn` | AgentCore runtime ARN override | Platform default | -| `model_id` | Bedrock inference-profile ID (`us.`-prefixed) | `us.anthropic.claude-opus-4-8` | +| `model_id` | Bedrock inference-profile ID (`us.`-prefixed) | `us.anthropic.claude-opus-5` | | `max_turns` | Default turn limit for tasks | 100 | | `max_budget_usd` | Default cost budget in USD per task, `0.01`–`100` (Blueprint `agent.maxBudgetUsd`) | None (unlimited) | | `system_prompt_overrides` | Additional system prompt instructions | None | diff --git a/docs/src/content/docs/developer-guide/Installation.md b/docs/src/content/docs/developer-guide/Installation.md index 6811e81d..268210c5 100644 --- a/docs/src/content/docs/developer-guide/Installation.md +++ b/docs/src/content/docs/developer-guide/Installation.md @@ -133,7 +133,7 @@ The `--local-events` flag connects the agent container to DynamoDB Local on the | Variable | Default | Description | |---|---|---| -| `ANTHROPIC_MODEL` | `us.anthropic.claude-opus-4-8` | Bedrock inference-profile ID for the main coding model | +| `ANTHROPIC_MODEL` | `us.anthropic.claude-opus-5` | Bedrock inference-profile ID for the main coding model | | `MAX_TURNS` | `100` | Max agent turns before stopping | | `MAX_BUDGET_USD` | | Cost ceiling for local batch runs only (production uses the API field) | | `DRY_RUN` | | Set to `1` to validate and print prompt without running the agent | diff --git a/docs/src/content/docs/developer-guide/Model-configuration.md b/docs/src/content/docs/developer-guide/Model-configuration.md index bef6469d..a8a315aa 100644 --- a/docs/src/content/docs/developer-guide/Model-configuration.md +++ b/docs/src/content/docs/developer-guide/Model-configuration.md @@ -28,7 +28,7 @@ title: Model configuration per-task payload model_id (layer 5) > blueprint agent.modelId (layer 4, arrives as stack env ANTHROPIC_MODEL) > stack env ANTHROPIC_MODEL (layer 3-adjacent / local shell) - > agent/src/config.py fallback (layer 2 — us.anthropic.claude-opus-4-8) + > agent/src/config.py fallback (layer 2 — us.anthropic.claude-opus-5) ``` Every one of those is gated by the **IAM invoke allowlist** (layer 1), which is itself gated by **account-level Bedrock model access**. Both gates are silent until invocation: a model that resolves fine through precedence still fails at turn 0 with `AccessDenied` if it is not in the grant list, and fails again if your account has not completed [Bedrock model access](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html) for it. @@ -46,7 +46,7 @@ throughput isn't supported. Retry your request with the ID or ARN of an inferenc profile that contains this model. ``` -So: `bedrockModels` context → `anthropic.claude-opus-4-8`. Everywhere else → `us.anthropic.claude-opus-4-8`. +So: `bedrockModels` context → `anthropic.claude-opus-5`. Everywhere else → `us.anthropic.claude-opus-5`. ### Bumping the default model