AWS AgentCore and AWS-native Knowledge Context Layer

AWS AgentCore and AWS-native Knowledge Context Layer: design patterns for continuous acquisition, curation, evolution, and governed serving of enterprise knowledge to AI agents via ontologies, knowledge graphs, and GraphRAG

2026-07-20 · agentic-ai knowledge-graphs rag-retrieval tools-infrastructure governance-policy · medium · source → · wiki →
key claims
  1. Amazon Bedrock Knowledge Bases splits into Managed and Customer-managed modes with materially different governance capability: only the Managed mode provides native connectors (Amazon S3, SharePoint, Confluence, Google Drive, OneDrive, web crawler), document-level ACL-based permission filtering at retrieval time, and native integration with AgentCore GatewayAWS (n.d.)
  2. The fully managed GraphRAG feature, which pairs Bedrock Knowledge Bases with Neptune Analytics, supports only Amazon S3 as a data source, disallows customization of the graph-build configuration, does not autoscale the underlying Neptune Analytics graph, and caps each data source at 1,000 files by defaultBuild (n.d.)
  3. Managed GraphRAG is available in only seven AWS Regions (Frankfurt, London, Ireland, Oregon, N. Virginia, Tokyo, Singapore), while Amazon Neptune Database itself operates in over 30 Regions including the Middle East, Israel, Africa, and AWS GovCloud (US), so data-residency-constrained enterprises outside those seven Regions cannot use the managed GraphRAG feature at allBuild (n.d.)Amazon (n.d.)
  4. AWS Labs publishes an open-source `graphrag-toolkit` containing `graphrag-byokg`, a package purpose-built for question-answering over a customer's own pre-existing knowledge graph, which is the closest AWS-native path to a predefined-ontology GraphRAG pattern given that the managed Bedrock feature explicitly excludes graph-build customizationGithub (n.d.)Build (n.d.)
  5. AgentCore Gateway enforces access control at four distinct levels, gateway, tool, operation, and parameter, using either REQUEST interceptors validating JSON Web Token (JWT) claims, Open Authorization (OAuth) authentication, or Cedar-policy IAM principal matching, and it separately handles both ingress (verifying caller identity) and egress (injecting downstream credentials) authentication in one managed serviceAmazon (n.d.)Amazon (n.d.)
  6. AgentCore Memory and Bedrock Knowledge Bases serve different, complementary roles rather than being substitutable: Memory persists what a specific agent has learned about a user or task across sessions, while Knowledge Bases serves durable, shared enterprise source-of-record content, so a Knowledge Context Layer's governed enterprise knowledge belongs in Knowledge Bases with Memory layered on top for personalizationAmazon (n.d.)AWS (n.d.)
  7. Bedrock Knowledge Base data-source syncing is incremental at the document level, meaning only added, modified, or deleted files since the last sync are re-parsed and re-embedded, and metadata-only changes to a `.metadata.json` file can sync without re-embedding the associated content, but the underlying `StartIngestionJob` API call still processes the entire data source per invocation rather than accepting a targeted file listAmazon (n.d.)Amazon (n.d.)
  8. Continuous curation on AWS is implemented as an event-driven pipeline, not a dedicated curation service: Amazon S3 Event Notifications routed through Amazon EventBridge trigger AWS Lambda functions that call the Knowledge Base ingestion API, with Amazon SQS, Amazon SNS, and AWS Step Functions added to respect per-data-source ingestion-job concurrency limitsAmazon (n.d.)

Research Question

What Amazon Web Services (AWS) AgentCore capabilities and AWS-native services are required to design and operate a Knowledge Context Layer (KCL) that continuously acquires, curates, evolves, and serves enterprise knowledge to Artificial Intelligence (AI) agents through ontologies, knowledge graphs, GraphRAG (Graph Retrieval-Augmented Generation), and governed interfaces, and what are the concrete architectural patterns, integration points, and operational constraints for implementing that layer at regulated enterprise scale?

Findings

(Populated from §6 Synthesis above.)

Executive Summary

A Knowledge Context Layer (KCL) built on Amazon Web Services (AWS) composes into three distinct deployable tiers rather than one AWS-native design, and the fully managed tier (Amazon Bedrock Knowledge Bases with Amazon Neptune Analytics GraphRAG (Graph Retrieval-Augmented Generation)) trades away customer-supplied ontology control and non-Amazon Simple Storage Service (Amazon S3) source connectivity for zero-infrastructure operation. Amazon Bedrock AgentCore supplies the governed-serving and memory layers around whichever Knowledge Base tier is chosen, through Gateway's tool/operation/parameter-level access control and Memory's session-scoped and cross-session state. Gateway governs agent-to-tool access while AWS Lake Formation and Knowledge Base Access Control List (ACL) filtering separately govern data-layer access, and the two layers must be designed together because neither substitutes for the other. Enterprises needing a predefined, customer-controlled ontology rather than an auto-extracted graph schema must leave the fully managed feature and use either a self-provisioned Amazon Neptune Database with an external retrieval framework or AWS Labs' open-source graphrag-byokg package, because the managed feature explicitly disallows graph-build customization. The managed feature's seven-Region availability footprint is the binding constraint that forces this same choice on any enterprise with a data-residency mandate outside those Regions, independent of its ontology preference.

Key Findings

  1. Amazon Bedrock Knowledge Bases splits into Managed and Customer-managed modes with materially different governance capability: only the Managed mode provides native connectors (Amazon S3, SharePoint, Confluence, Google Drive, OneDrive, web crawler), document-level ACL-based permission filtering at retrieval time, and native integration with AgentCore Gateway.
  2. The fully managed GraphRAG feature, which pairs Bedrock Knowledge Bases with Neptune Analytics, supports only Amazon S3 as a data source, disallows customization of the graph-build configuration, does not autoscale the underlying Neptune Analytics graph, and caps each data source at 1,000 files by default.
  3. Managed GraphRAG is available in only seven AWS Regions (Frankfurt, London, Ireland, Oregon, N. Virginia, Tokyo, Singapore), while Amazon Neptune Database itself operates in over 30 Regions including the Middle East, Israel, Africa, and AWS GovCloud (US), so data-residency-constrained enterprises outside those seven Regions cannot use the managed GraphRAG feature at all.
  4. AWS Labs publishes an open-source graphrag-toolkit containing graphrag-byokg, a package purpose-built for question-answering over a customer's own pre-existing knowledge graph, which is the closest AWS-native path to a predefined-ontology GraphRAG pattern given that the managed Bedrock feature explicitly excludes graph-build customization.
  5. AgentCore Gateway enforces access control at four distinct levels, gateway, tool, operation, and parameter, using either REQUEST interceptors validating JSON Web Token (JWT) claims, Open Authorization (OAuth) authentication, or Cedar-policy IAM principal matching, and it separately handles both ingress (verifying caller identity) and egress (injecting downstream credentials) authentication in one managed service.
  6. AgentCore Memory and Bedrock Knowledge Bases serve different, complementary roles rather than being substitutable: Memory persists what a specific agent has learned about a user or task across sessions, while Knowledge Bases serves durable, shared enterprise source-of-record content, so a Knowledge Context Layer's governed enterprise knowledge belongs in Knowledge Bases with Memory layered on top for personalization.
  7. Bedrock Knowledge Base data-source syncing is incremental at the document level, meaning only added, modified, or deleted files since the last sync are re-parsed and re-embedded, and metadata-only changes to a .metadata.json file can sync without re-embedding the associated content, but the underlying StartIngestionJob API call still processes the entire data source per invocation rather than accepting a targeted file list.
  8. Continuous curation on AWS is implemented as an event-driven pipeline, not a dedicated curation service: Amazon S3 Event Notifications routed through Amazon EventBridge trigger AWS Lambda functions that call the Knowledge Base ingestion API, with Amazon SQS, Amazon SNS, and AWS Step Functions added to respect per-data-source ingestion-job concurrency limits.
  9. Amazon Neptune is a Virtual Private Cloud (VPC)-only service requiring Transport Layer Security (TLS) 1.2 for all connections, and Amazon Bedrock AgentCore separately supports AWS PrivateLink interface VPC endpoints for Gateway, Runtime, and tool traffic, together enabling an end-to-end private-network deployment for both the graph store and the agent runtime.
  10. Amazon Neptune's 2024 engine version 1.3.2.x delivers up to 9 times faster low-latency openCypher query performance and up to 10 times higher openCypher throughput than prior versions, a query-language-specific improvement that AWS's own blog post does not claim extends equally to Gremlin or SPARQL Protocol and RDF Query Language (SPARQL) queries.
  11. AWS Lake Formation adds fine-grained column-, row-, and cell-level access control and tag-based access control (TBAC) over data cataloged in AWS Glue, with a hybrid access mode that lets administrators onboard Lake Formation permissions incrementally alongside existing IAM permissions on the same catalog.
  12. A prior repository evaluation of hosted ontology-first graph databases found that Stardog Cloud and Ontotext GraphDB provide stronger native ontology reasoning capability than the evidence located for Neptune in this investigation, which surfaced no equivalent native Web Ontology Language (OWL) inference engine for Neptune, making formal-ontology-reasoning requirements a genuine reason to look outside the AWS-native services examined here.

Assumptions

Analysis

The evidence separates two governance surfaces that must be designed independently: agent-to-tool access, controlled by AgentCore Gateway's interceptor and Cedar-policy mechanisms, and data-layer access, controlled by Knowledge Base ACL filtering or Lake Formation depending on which acquisition path is used. A design that only implements Gateway-level policy while leaving an incoherent source-system permission estate untouched inherits the weaker of the two, because Gateway can restrict which agent may call a Knowledge Base tool but cannot repair document-level permission errors coming from the source system itself.

The managed-versus-hybrid trade-off is not a single binary choice but three separable constraints that happen to point the same direction in several common enterprise scenarios. Ontology control, non-S3 source connectivity, and Region availability each independently rule out the fully managed GraphRAG tier for a meaningfully sized subset of enterprises: those requiring a predefined schema, those whose content lives outside S3-reachable connectors, and those operating exclusively in Regions outside the seven supported ones. Where an enterprise's requirement is specifically formal ontology reasoning, for example Web Ontology Language (OWL)-based inference over a domain ontology, the rival explanation from a prior repository item, that a dedicated ontology-first hosted graph database outperforms Neptune on this specific dimension, is a stronger fit than any of the three AWS-native tiers examined here, and should be weighed against the integration cost of operating a non-AWS-native graph store behind AgentCore Gateway. This item does not resolve that trade-off, because it falls outside the AWS-native scope, but the evidence gathered here establishes that Neptune's documented strengths lie in query throughput and managed operations rather than in native ontology reasoning, which is a narrower claim than "Neptune is the ontology solution for AWS."

The sync-incrementality tension identified in §2 and §4 (document-level incrementality claimed by official docs versus whole-data-source API scope claimed by the AWS sample repository) is resolved as two facts about different layers rather than a genuine contradiction, but it has a practical consequence: an automation pipeline built only on the official incrementality claim, without reading the sample repository's operational note, could under-provision for the cost and duration of a StartIngestionJob call on a large data source, because that call re-scans the entire source even though only changed content is re-embedded.

This item's finding that "neither Bedrock Knowledge Bases nor AgentCore exposes a dedicated 'curation' service" (§2.1.2) is a gap when weighed against a prior repository item's regulated-enterprise governance requirement that authoritative knowledge for AI follow an intake, validation, publication, correction-to-source, and retirement-or-recertification lifecycle with logs and version metadata proving what changed and when. Amazon EventBridge-triggered re-sync, the mechanism this item identifies as AWS's substitute for a dedicated curation service, satisfies only the "publication" step of that prior lifecycle model directly; it provides no native validation gate before content becomes queryable, no correction-to-source workflow, and no explicit retirement-or-recertification state, so a regulated enterprise adopting the AWS-native pattern in this item would need to layer the prior item's governance lifecycle on top of Knowledge Base sync rather than treat sync automation as a substitute for it.

Risks, Gaps, and Uncertainties

Open Questions


sources


cites
cites TBox-driven vs ABox-emergent ontology approaches in GraphRAG systems
cites Amazon Bedrock AgentCore and related suite: full feature and capability survey
cites Amazon Web Services (AWS) Bedrock platform capabilities: model access, agents, knowledge bases, guardrails, evaluation, and enterprise governance primitives for regulated environments
cites Migration trade-offs from vector Retrieval-Augmented Generation to ontology-backed Knowledge Graph RAG
cites Knowledge curation governance as an enterprise AI capability in regulated financial institutions
related (frontmatter)
related What capabilities, sub-capabilities, architectural patterns, and maturity dimensions define tool-using, semi-autonomous Semantic Knowledge Management systems?
related Knowledge Graph as a data product: data mesh principles, contracts, and ownership for software-agent runtime dependencies
related Ontology Completeness as a World Model for Large Language Model (LLM) Prediction
related Hosted Software-as-a-Service (SaaS) graph database options for knowledge ontology
related Knowledge curation governance as an enterprise AI capability in regulated financial institutions
related Permission-safe Retrieval-Augmented Generation (RAG) in enterprise information architectures: technical constraints, architectural options, and failure modes at scale

Connected items

Loading…

View full knowledge graph →