AgentTrust OSBlog › Cloud Architecture
AWS Architecture · Bedrock AgentCore · Cloud Security

AWS Bedrock AgentCore: A Reference Architecture for Safe Agent Deployment

AWS Bedrock AgentCore Runtime went GA in October 2025. AgentCore Policy followed in March 2026. Here is how the complete governed agent stack assembles — layer by layer — for platform teams in banking and insurance.

AgentTrust OS
July 29, 2026
15 min read
Platform Team · Cloud Architects · InfoSec
AgentTrust OS AGENTIC AI GOVERNANCE AWS · REFERENCE ARCHITECTURE AWS Bedrock AgentCore: Reference Architecture for Safe Agent Deployment AWS BEDROCK AGENTCORE STACK Application Layer AgentCore Runtime Cedar Policy Enforcement Tool Execution + IAM Identity Audit Lake + CloudWatch GA: July 2025 Sources: AWS Bedrock AgentCore GA (Jul 2025) · Cedar Policy · AWS Security Hub · AWS CloudWatch agent-trust.tech
AWS Bedrock AgentCore five-layer stack: Application → AgentCore Runtime → Cedar Policy → Tool Execution → Audit Lake
Key Facts
TL;DR
Keep reading → Full layer-by-layer architecture breakdown below.

Platform teams at AWS-native financial institutions have been watching the agentic AI space and asking the same question: "When the managed services are ready, can we build a governed agent stack without custom middleware?" As of early 2026, the answer is yes. AWS Bedrock AgentCore Runtime, which went GA in October 2025, and AWS AgentCore Policy, which followed in March 2026, together provide the enforcement, identity, and audit infrastructure that governed agent deployment requires.

The challenge before these services was real: organizations that wanted to deploy AI agents in production needed to either use a third-party orchestration framework (LangChain, CrewAI, AutoGen) with custom governance wrapping, or build their own agent runtime infrastructure from scratch. Neither option was operationally attractive for regulated industries where the governance overhead of custom software is itself a compliance burden. AWS AgentCore changes the calculus by providing managed infrastructure with governance built in.

This post describes the complete AWS reference architecture for governed agent deployment, layer by layer, with specific attention to how each component addresses the governance requirements that compliance teams and InfoSec architects care about. We also note where this architecture compares to the Azure APIM enforcement pattern covered in the Day 4 post of this series, for organizations evaluating both platforms.

What is AWS Bedrock AgentCore and what problem does it solve?

AWS Bedrock AgentCore is a managed service that provides the runtime infrastructure for deploying, executing, and governing AI agents built on foundation models available in Amazon Bedrock. It addresses the operational gap that existed between Bedrock's model invocation APIs — which allow you to call a foundation model — and the production requirements of an agent that needs to maintain session state, invoke external tools, track execution history, and respect governance policies.

Definition — AWS Bedrock AgentCore Runtime

AWS Bedrock AgentCore Runtime, generally available as of October 2025, is the managed execution environment for AI agents on AWS. It provides: agent lifecycle management (creation, versioning, deployment, and deprecation), tool execution infrastructure (managed invocation of tools defined in the agent's tool configuration), session state management (maintaining conversation context across turns), and integration with AWS governance services including IAM, CloudWatch, and the AgentCore Gateway/Cedar Policy enforcement layer.

The key difference between AgentCore Runtime and earlier Bedrock Agents functionality is the depth of the governance integration. Earlier Bedrock Agents provided basic tool invocation; AgentCore Runtime provides full agent lifecycle management with audit logging, version control, and integration points for the Cedar Policy enforcement layer that was added in March 2026. For platform teams in regulated industries, the governance integration is the critical change.

How does AgentCore Gateway and Cedar Policy provide enforcement?

AWS AgentCore Gateway is the traffic management layer that sits between an agent's intention (the tool call it wants to make) and the actual execution of that tool call. Every tool call an agent attempts passes through the Gateway, where it is evaluated against Cedar policies before execution proceeds. Cedar is Amazon's open-source attribute-based access control (ABAC) language — it defines policies in terms of the agent's identity, the requested action, the target resource, and the context of the request.

Definition — Amazon Cedar Policy Language

Cedar is an open-source policy language developed by AWS for expressing attribute-based access control (ABAC) decisions. Cedar policies specify conditions under which a principal (such as an AgentCore agent) may perform an action (such as invoking a tool) on a resource (such as a payment API), given contextual attributes (such as transaction amount, customer tier, or time of day). Cedar is designed for correctness and auditability: policies are formally verifiable and the decision reasoning for each authorization is available for logging. AWS AgentCore Policy uses Cedar to gate every tool call in the AgentCore Runtime.

The governance value of Cedar Policy enforcement is that it is preventive, not detective. Traditional security monitoring detects anomalies after an agent has already taken an action. Cedar Policy enforcement prevents the action from executing in the first place if it violates policy. For a financial services organization where an incorrect payment or unauthorized data access cannot be easily reversed, the distinction between "we detected it" and "we prevented it" is significant.

In practice, Cedar policies for agent governance express rules like: "Agent payment-processor-v2 may invoke the refund API only for amounts less than $500 and only during business hours" or "Agent customer-data-agent may read customer records but may not modify or delete them." These policies are managed centrally, versioned, and audited independently of the agent's model — meaning a policy change doesn't require redeployment of the agent, and a model update doesn't inadvertently change the policy.

What does Bedrock Guardrails add that Cedar Policy doesn't cover?

Bedrock Guardrails and Cedar Policy operate at different layers of the agent stack and are complementary rather than redundant. Cedar Policy operates at the tool call layer — it governs what tools the agent may invoke and under what conditions. Bedrock Guardrails operates at the model input/output layer — it governs what content the agent may receive from users and what content it may output, regardless of which tool is eventually called.

Bedrock Guardrails provides three protection capabilities that are directly relevant to regulated industry deployments. PII detection and redaction automatically identifies and removes personal information (names, Social Security numbers, account numbers, medical record identifiers) from model inputs and outputs, reducing the risk of inadvertent PII propagation through the agent's actions. Grounding checks evaluate whether the agent's response is factually consistent with the retrieved context from Knowledge Bases or provided documents, reducing hallucination risk in regulatory or compliance-sensitive responses. Content filtering blocks prompt injection patterns — attempts by malicious content in the agent's environment to override its instructions — before they reach the model's context window.

How do IAM and AgentCore Identity provide per-agent credentials?

AWS AgentCore Identity, integrated with AWS Identity and Access Management (IAM), provides the per-agent credential infrastructure that addresses OWASP LLM06 Excessive Agency's requirement for per-agent identity rather than shared credentials. Each agent deployed in AgentCore Runtime receives a distinct IAM identity — an agent-specific role with a policy that maps to its Cedar Policy-defined tool access permissions. The agent's credential is session-scoped and time-limited, automatically expiring when the session ends.

This eliminates the shared-secret anti-pattern where all agents in an organization share a single service account or API key. With per-agent identity, if a credential is compromised, the blast radius is limited to the specific agent's session and the specific tools that agent was authorized to invoke. The credential cannot be used to impersonate a different agent with different permissions, and the audit trail attributes every action to the specific agent identity rather than to an anonymous shared account.

Oct
2025
AWS Bedrock AgentCore Runtime GA date
AWS, AgentCore GA announcement
Mar
2026
AWS AgentCore Policy (Cedar) GA date
AWS, AgentCore Policy GA announcement
5
Governance layers in the full AgentCore reference stack
AgentTrust OS architecture analysis, 2026

How do you build an audit lake for agent governance on AWS?

The AWS audit lake for agent governance combines three service categories: real-time observability, structured event collection, and long-term immutable storage with query capability. Together they provide the compliance record that regulated industries require — a comprehensive, tamper-resistant log of every agent action, decision, tool call, and governance event.

Real-time observability is provided by Amazon CloudWatch and AWS X-Ray. CloudWatch captures structured logs from AgentCore Runtime, including agent session events, tool call attempts, policy evaluation results, and errors. X-Ray provides distributed tracing — for each agent session, X-Ray generates a trace that shows the complete execution path from the initial user request through every tool call, policy check, and model invocation. X-Ray traces are essential for incident reconstruction: when an agent takes an unexpected action, the trace shows exactly the sequence of steps that led to it.

Structured event collection is handled by AWS CloudTrail, which captures API-level events from every AWS service the agent interacts with. If the agent invokes an S3 bucket, a DynamoDB table, or an external API through API Gateway, CloudTrail logs the invocation with the agent's IAM identity, the request parameters, the timestamp, and the source IP. CloudTrail logs are append-only by default and can be configured to write to a dedicated S3 bucket with Object Lock enabled, making them tamper-resistant.

Long-term storage and analysis is provided by S3 (for raw log storage) and AWS Glue (for cataloging and transforming logs for analytical query). The combination of S3 + Glue + Amazon Athena allows compliance teams to query the full history of agent actions using SQL — for example, "Show me all payment operations performed by any agent in the last 30 days where the amount exceeded $1,000" — without requiring custom analytics infrastructure.

AWS Bedrock AgentCore — Reference Architecture for Governed Agent Deployment Application / User Request API Gateway · SDK · CLI BEDROCK AGENTCORE RUNTIME Agent lifecycle · Tool execution · Session state · Version management AGENTCORE GATEWAY + CEDAR POLICY Every tool call gated · ABAC enforcement · Policy versioning · Decision audit BEDROCK GUARDRAILS PII · Grounding · Injection TOOL EXECUTION LAYER External APIs · Bedrock KB (RAG) · Lambda · Step Functions IAM + AGENTCORE IDENTITY Per-agent credentials CLOUDWATCH + X-RAY Real-time traces AUDIT LAKE S3 (immutable storage, Object Lock) · CloudTrail (API events) · AWS Glue (catalog + ETL) Amazon Athena (SQL query) · Compliance export (SOC 2 · ISO 27001 · AI governance) BEDROCK KNOWLEDGE BASES Managed RAG · Semantic search · Grounded responses · No external vector store required EXECUTION ENFORCEMENT IDENTITY AUDIT KNOWLEDGE
Figure 1: AWS Bedrock AgentCore Reference Architecture for governed agent deployment. Layers from top: Application → AgentCore Runtime → Cedar Policy Enforcement → Tool Execution (+ IAM Identity + CloudWatch) → Audit Lake → Knowledge Bases. Bedrock Guardrails applies at the model layer alongside enforcement.

How does this architecture compare to the Azure APIM enforcement pattern?

The Azure reference architecture for governed agent deployment (covered in the Day 4 post of this series) uses Azure API Management (APIM) as the enforcement gateway, Microsoft Entra Agent ID for per-agent identity, and Azure Monitor with Log Analytics for audit observability. The AWS architecture uses AgentCore Gateway + Cedar Policy for enforcement, IAM + AgentCore Identity for per-agent credentials, and CloudWatch/X-Ray + CloudTrail for observability.

Both architectures solve the same governance problem — every tool call gated, per-agent identity, immutable audit record — using the managed services available in their respective clouds. The enforcement point in Azure (APIM + policy definitions) and AWS (AgentCore Gateway + Cedar) are architecturally equivalent: both intercept every tool call and evaluate it against a policy before allowing or blocking execution. The key difference is the policy language: Azure APIM uses inbound/outbound policy XML; AWS Cedar uses a dedicated, formally verifiable ABAC language. Cedar's formal verification properties — policies can be mathematically proven to be correct before deployment — provide a stronger governance guarantee for regulated industries where policy correctness is a compliance requirement.

Definition — Attribute-Based Access Control (ABAC) for Agents

Attribute-Based Access Control (ABAC) is an authorization model that evaluates access decisions based on the attributes of the principal (e.g., agent identity, tier, department), the action requested (e.g., read, write, delete), the resource targeted (e.g., payment API, customer database), and the context of the request (e.g., transaction amount, time of day, customer risk score). For agentic AI, ABAC via Cedar Policy allows governance teams to express complex, context-sensitive policies — "agent X may invoke the refund API for amounts up to $500 during business hours for customers with a risk score below 70" — that cannot be expressed in simple role-based access control (RBAC) models.

What role do AWS Step Functions play in agent orchestration governance?

AWS Step Functions is the managed workflow orchestration service that is commonly used alongside AgentCore Runtime for multi-agent or multi-step orchestration scenarios. For governance purposes, Step Functions provides two important capabilities: execution history and error handling at the workflow level.

Every Step Functions execution generates a complete execution history — a timestamped record of every state transition, every Lambda invocation, every AgentCore agent call, and every branching decision. This execution history is automatically stored in AWS and is queryable via the Step Functions console or API. For regulated industries, Step Functions execution histories provide workflow-level audit records that complement the AgentCore Runtime's agent-level audit records: together, they give a complete picture of how a complex multi-step process executed, which agents were involved at each stage, and what decisions were made at each branch point.

AgentTrust OS Integrates Natively with the AWS AgentCore Stack

AgentTrust OS is designed to complement AWS's native governance services, not replace them. For organizations building on the AWS Bedrock AgentCore reference architecture, AgentTrust OS adds the governance layer above the infrastructure — classification, certification, and cross-environment audit aggregation.

Trust Certify
Pre-production certification that validates your Cedar Policy configuration, tool allowlists, and AgentCore Identity bindings against governance policy before agents reach production.
Trust Runtime
Governance policy layer that works alongside AgentCore Gateway and Cedar Policy, adding cross-environment escalation thresholds and human-in-the-loop routing for actions that exceed configured risk thresholds.
Trust Audit
Aggregates CloudWatch, X-Ray, and CloudTrail data from the AWS audit lake into a unified governance reporting layer — generating board-ready reports and regulator-facing compliance exports.
Trust Certify Cedar Policy + allowlist pre-production validation Trust Runtime Cross-env HITL routing alongside Cedar Policy Trust Audit Aggregates AWS audit lake into governance reports
Figure 2: AgentTrust OS integrates with the AWS AgentCore stack — adding governance classification, cross-environment escalation, and aggregated compliance reporting above AWS's native infrastructure services.

Frequently Asked Questions

Do I need to use all layers of the AgentCore reference architecture, or can I adopt them incrementally?
Incremental adoption is possible and recommended. The minimum viable governed stack for production use is: AgentCore Runtime (for managed execution), IAM + AgentCore Identity (for per-agent credentials), and CloudWatch + CloudTrail (for basic audit logging). AgentCore Gateway + Cedar Policy can be added as the second phase for organizations that need explicit tool-call enforcement. Bedrock Guardrails is additive and can be enabled per-agent. The Knowledge Bases layer is optional and relevant only for agents that need grounded responses from organizational knowledge. Start with identity and audit, then layer enforcement.
How does AWS AgentCore relate to AWS Bedrock Agents, which already existed?
AWS Bedrock Agents (launched 2023) provided the original managed agent capability on Bedrock — basic tool use, action groups, and knowledge base integration. AWS Bedrock AgentCore (GA Oct 2025) is the evolution of this service, adding full agent lifecycle management, enterprise-grade session state, the AgentCore Gateway enforcement layer, AgentCore Identity, and deeper integration with CloudWatch and X-Ray. Existing Bedrock Agents deployments can be migrated to AgentCore Runtime to gain the governance capabilities, though migration planning is required. AWS has published a migration guide for Bedrock Agents → AgentCore Runtime transitions.
What does Cedar Policy's formal verification mean for governance teams?
Cedar's formal verification means that Cedar policies can be mathematically analyzed before deployment to confirm they behave exactly as intended — there are no hidden edge cases or implicit permissions. For governance teams in regulated industries, this matters because it allows a policy reviewer to state with certainty that "this policy permits X and nothing else" rather than relying on testing to find edge cases. AWS provides the Cedar Policy Analysis tools as part of the Cedar SDK, allowing policy validation as part of a CI/CD pipeline. Policies that fail formal verification can be blocked from deployment, ensuring that only correctly-specified policies reach production.
How should the audit lake be configured for SOC 2 Type II compliance?
For SOC 2 Type II, the audit lake requires: tamper-resistance (S3 Object Lock in COMPLIANCE mode for the minimum retention period, typically one year), completeness (CloudTrail enabled for all AgentCore API calls in all regions where agents run), integrity verification (CloudTrail log file validation enabled, generating SHA-256 hashes of every log file), and access control (the audit lake S3 bucket should be accessible only to designated audit roles, not to the agents themselves). Additionally, CloudWatch log groups should have retention policies set to at least one year and encrypted with KMS keys managed by a separate administrative role from the one that manages the agents.
How does Bedrock Knowledge Bases handle data sovereignty requirements in banking?
Bedrock Knowledge Bases stores vector embeddings in Amazon OpenSearch Serverless or Amazon Aurora PostgreSQL, both of which support regional data residency. For Canadian institutions subject to OSFI Guideline E-23's data sovereignty provisions, the Knowledge Bases data source (S3 bucket), the vector store, and the Bedrock API endpoint should all be configured in the AWS Canada (Central) or Canada West region. OSFI E-23 does not prohibit cloud-based AI processing but requires that federally regulated institutions maintain oversight and control — including the ability to audit where data is processed. AWS's Service Control Policies (SCPs) can enforce regional boundaries at the organizational level, ensuring no data processing occurs outside approved regions.
Ready to Govern Your Agents?
Deploy on AWS. Govern with AgentTrust OS.
AgentTrust OS integrates natively with AWS Bedrock AgentCore — adding governance classification, certification, and board-ready reporting above AWS's native infrastructure.
Start Free →