Subchapter 23.1
references/decision-refs/agentcore.mdMarkdown5 KBView on GitHub
Agent-purpose-built runtime with two compute types: serverless microVMs (managed session routing, true session isolation, built-in identity, $0 billing during I/O wait) and Instances (AWS-managed EC2 in your account for multi-day, GPU, or instance-type-specific agents). Same APIs, identity, and observability across both.
Short agent sessions with high LLM I/O wait, human-in-the-loop, multi-tenant isolation, minimal ops, cross-session memory, high-volume session launch (microVMs) — plus multi-day sessions, GPU/heavy compute, shared-host multi-agent collaboration, and workloads that must pick an instance type (Instances).
| microVMs (default) | Instances (capacity provider) | |
|---|---|---|
| Session cap | 8h (maxLifetime ≤ 28,800s) | 14 days (maxLifetime ≤ 1,209,600s) |
| Compute | ≤ 2 vCPU / 8 GB, no GPU | broad EC2 choice incl. GPU, ARM64/x86_64 |
| Host model | one agent per microVM | multiple agents share host + filesystem (/tmp/agentcore-session/<session-id>/) |
| Billing | consumption; $0 during I/O wait | EC2 in YOUR account (Savings Plans / ODCRs apply) + AgentCore management fee |
| Idle | scale to zero | session stop/restart (hibernate) |
| Launch scope | all AgentCore regions | Linux only; limited launch regions — verify via MCP |
Routing (mirrors scoring.py::_select_agentcore_compute_type): >8h sessions, GPU or
heavy compute, or an instance-type requirement → Instances; everything else → microVMs.
An always-on service is still a better ECS/EKS fit — Instances sessions end at 14 days.
us-east-1, us-west-2,
ap-northeast-1, ap-southeast-2, eu-west-1
(GA announcement (opens in a new tab)).
Verify Registry availability in its intended Region before recommending it; Runtime
availability does not establish Registry availability. See freshness.md.registry): centralized discovery and governance for agents, tools,
skills, MCP servers, and custom resources. Surface when the user needs a shared catalog,
resource discovery, or approval-based governance, including single-agent workloads; multiple
agents alone are not a reason to add it. Registry catalogs resources; it does not orchestrate
their execution. The former AgentCore Registry now uses the dedicated agent-registry
namespace (migration guide (opens in a new tab)).
Access it via console, CLI, SDK, or MCP; it integrates with AgentCore, Amazon Quick, and Kiro IDE.microVMs: 2 vCPU / 8 GB ceiling; no process-level suspend (Session Storage persists files only). Instances: pricing shifts from consumption to EC2 + management fee (idle instances cost money unless stopped); 14-day session ceiling; Linux only at launch; capacity provider is immutable after creation except its description.
Entry: POST /invocations + GET /ping. IAM: execution role with InvokeModel + Gateway/Registry/SessionStorage permissions as needed. Networking: public service endpoints over TLS; VPC endpoints only if policy demands. Instances additionally run EC2 in your account: capacity provider defines OS, allowed instance types, VPC/subnets/security groups, gp3 storage, and service/infrastructure roles.