Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions agent/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand All @@ -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.

Expand All @@ -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

Expand Down
2 changes: 1 addition & 1 deletion agent/src/config.py
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion agent/src/models.py
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion cli/src/repo-display.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down
2 changes: 1 addition & 1 deletion docs/design/REPO_ONBOARDING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down
6 changes: 3 additions & 3 deletions docs/guides/DEVELOPER_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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

Expand Down Expand Up @@ -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 |
Expand Down
2 changes: 1 addition & 1 deletion docs/guides/USER_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down
2 changes: 1 addition & 1 deletion docs/src/content/docs/architecture/Repo-onboarding.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down
2 changes: 1 addition & 1 deletion docs/src/content/docs/customizing/Per-repo-overrides.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down
2 changes: 1 addition & 1 deletion docs/src/content/docs/developer-guide/Installation.md

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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

Expand Down
Loading