# aws-samples/sample-agentic-platform architecture

> Architecture diagram of the GitHub repository aws-samples/sample-agentic-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aws-samples/sample-agentic-platform
- Repository: https://github.com/aws-samples/sample-agentic-platform

## Overview

Agentic Platform is a reference platform for running framework-diverse agents with shared core abstractions and gateway services. A user invokes an agent through its HTTP server; the server routes requests to a controller and agent, which returns a response or stream. The wider product includes chat, RAG, workflow, Jira and data agents; memory and retrieval gateways; and MCP servers. README documents AWS gateway-mediated access, but most agent internals and integrations were not sampled, so those links are shown only where documented or left out.

Main entry points: [`src/agentic_platform/core/client/llm_gateway/llm_gateway_client.py`](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/client/llm_gateway/llm_gateway_client.py) (LLM Client), [`src/agentic_platform/agent/agentic_chat/server.py`](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_chat/server.py) (Chat HTTP), [`src/agentic_platform/agent/agentic_chat/controller/agentic_chat_controller.py`](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_chat/controller/agentic_chat_controller.py) (Chat Controller), [`src/agentic_platform/agent/agentic_rag/server.py`](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_rag/server.py) (RAG HTTP)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agents["Agent Applications"]
  node_chat_server["Chat HTTP<br/>[server.py]"]
  node_chat_controller["Chat Controller"]
  node_chat_agent["Strands Chat"]
  node_rag_server["RAG HTTP<br/>[server.py]"]
  node_rag_controller["RAG Controller"]
  node_rag_agent["Strands RAG"]
  node_rag_tool["Knowledge Tool<br/>[kb_tool.py]"]
  node_langgraph["LangGraph Chat<br/>[chat_workflow.py]"]
  node_langgraph_controller["Workflow Controller<br/>[chat_controller.py]"]
  node_jira_agent["Jira Agent<br/>[jira_agent.py]"]
  node_jira_controller["Jira Controller<br/>[jira_controller.py]"]
  node_athena_agent["Glue Athena Agent<br/>[agent_service.py]"]
  node_athena_controller["Data Controller"]
end

subgraph group_shared["Shared Core"]
  node_api_types["API Models<br/>[api_models.py]"]
  node_stream_types["Stream Models"]
  node_memory_types["Memory Models<br/>[memory_models.py]"]
  node_middleware["Request Middleware"]
  node_llm_client["LLM Client"]
  node_llm_gateway["LiteLLM Client"]
  node_retrieval_client["Retrieval Client"]
end

subgraph group_gateways["Gateway Services"]
  node_memory_gateway["Memory Gateway<br/>[server.py]"]
  node_memory_api["Memory Controllers"]
  node_memory_store["Memory Clients<br/>[memory_client.py]"]
  node_retrieval_gateway["Retrieval Gateway<br/>[server.py]"]
  node_retrieve_controller["Retrieve Controller"]
  node_vector_client["Vector Search Client"]
end

subgraph group_mcp["MCP Servers"]
  node_kb_mcp["Bedrock KB MCP<br/>[server.py]"]
  node_code_mcp["Code Graph MCP<br/>[server.py]"]
  node_code_queries["Graph Queries<br/>[query_tools.py]"]
  node_code_graph["Code Graph<br/>[graph.py]"]
end

node_user(("User"))
node_bedrock_kb[("Bedrock Knowledge Base")]
node_litellm_service["LiteLLM Gateway Service"]

node_user -->|"invokes"| node_chat_server
node_chat_server -->|"routes to"| node_chat_controller
node_chat_controller -->|"invokes"| node_chat_agent
node_user -->|"invokes"| node_rag_server
node_rag_server -->|"routes to"| node_rag_controller
node_rag_controller -->|"invokes"| node_rag_agent
node_rag_agent -.->|"uses"| node_rag_tool
node_rag_tool -.->|"queries"| node_bedrock_kb
node_user -->|"invokes"| node_langgraph_controller
node_langgraph_controller -->|"runs"| node_langgraph
node_user -->|"invokes"| node_jira_controller
node_jira_controller -->|"invokes"| node_jira_agent
node_user -->|"invokes"| node_athena_controller
node_athena_controller -->|"delegates to"| node_athena_agent
node_chat_server -->|"configures"| node_middleware
node_rag_server -->|"configures"| node_middleware
node_chat_server -->|"uses"| node_api_types
node_rag_server -->|"uses"| node_api_types
node_chat_controller -->|"accepts"| node_api_types
node_chat_controller -->|"emits"| node_stream_types
node_rag_controller -->|"accepts"| node_api_types
node_rag_controller -->|"emits"| node_stream_types
node_langgraph_controller -->|"uses"| node_memory_types
node_llm_client -->|"delegates to"| node_llm_gateway
node_llm_gateway -->|"requests"| node_litellm_service
node_retrieval_client -->|"posts retrieval"| node_retrieval_gateway
node_memory_gateway -->|"registers routes"| node_memory_api
node_memory_api -->|"calls"| node_memory_store
node_retrieval_gateway -.->|"registers route"| node_retrieve_controller
node_retrieve_controller -->|"retrieves"| node_vector_client
node_user -->|"uses MCP"| node_kb_mcp
node_user -->|"uses MCP"| node_code_mcp
node_code_mcp -->|"calls"| node_code_queries
node_code_queries -->|"queries"| node_code_graph
node_chat_agent -.->|"uses gateway"| node_llm_client
node_rag_agent -.->|"uses gateway"| node_llm_client
node_jira_agent -.->|"uses gateway"| node_llm_client
node_athena_agent -.->|"uses gateway"| node_llm_client
node_chat_agent -.->|"uses gateway"| node_memory_gateway
node_rag_agent -.->|"uses gateway"| node_retrieval_gateway

click node_chat_server "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_chat/server.py"
click node_chat_controller "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_chat/controller/agentic_chat_controller.py"
click node_chat_agent "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_chat/agent/agentic_chat_agent.py"
click node_rag_server "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_rag/server.py"
click node_rag_controller "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_rag/controller/agentic_rag_controller.py"
click node_rag_agent "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_rag/agent/agentic_rag_agent.py"
click node_rag_tool "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_rag/tool/kb_tool.py"
click node_langgraph "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/langgraph_chat/chat_workflow.py"
click node_langgraph_controller "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/langgraph_chat/chat_controller.py"
click node_jira_agent "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/jira_agent/jira_agent.py"
click node_jira_controller "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/jira_agent/jira_controller.py"
click node_athena_agent "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/strands_glue_athena/agent_service.py"
click node_athena_controller "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/strands_glue_athena/agent_controller.py"
click node_api_types "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/models/api_models.py"
click node_stream_types "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/models/streaming_models.py"
click node_memory_types "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/models/memory_models.py"
click node_middleware "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/middleware/configure_middleware.py"
click node_llm_client "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/client/llm_gateway/llm_gateway_client.py"
click node_llm_gateway "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/client/llm_gateway/litellm_gateway_client.py"
click node_retrieval_client "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/client/retrieval_gateway/retrieval_gateway_client.py"
click node_memory_gateway "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/service/memory_gateway/server.py"
click node_memory_api "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/service/memory_gateway/api/create_memory_controller.py"
click node_memory_store "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/service/memory_gateway/client/memory/memory_client.py"
click node_retrieval_gateway "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/service/retrieval_gateway/server.py"
click node_retrieve_controller "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/service/retrieval_gateway/api/retrieve_controller.py"
click node_vector_client "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/service/retrieval_gateway/client/vectorsearch_client.py"
click node_kb_mcp "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/mcp_server/bedrock_kb_mcp_server/server.py"
click node_code_mcp "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/mcp_server/code_graph_mcp_server/server.py"
click node_code_queries "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/mcp_server/code_graph_mcp_server/tool/query_tools.py"
click node_code_graph "https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/mcp_server/code_graph_mcp_server/tool/graph.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_chat_server,node_chat_controller,node_chat_agent,node_rag_server,node_rag_controller,node_rag_agent,node_rag_tool,node_langgraph,node_langgraph_controller,node_jira_agent,node_jira_controller,node_athena_agent,node_athena_controller,node_user toneBlue
class node_api_types,node_stream_types,node_memory_types,node_middleware,node_llm_client,node_llm_gateway,node_retrieval_client,node_bedrock_kb toneAmber
class node_memory_gateway,node_memory_api,node_memory_store,node_retrieval_gateway,node_retrieve_controller,node_vector_client toneMint
class node_kb_mcp,node_code_mcp,node_code_queries,node_code_graph toneRose
class node_litellm_service toneIndigo
```

## Components

### Agent Applications

- [Chat HTTP](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_chat/server.py): `src/agentic_platform/agent/agentic_chat/server.py`
- [Chat Controller](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_chat/controller/agentic_chat_controller.py): `src/agentic_platform/agent/agentic_chat/controller/agentic_chat_controller.py`
- [Strands Chat](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_chat/agent/agentic_chat_agent.py): `src/agentic_platform/agent/agentic_chat/agent/agentic_chat_agent.py`
- [RAG HTTP](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_rag/server.py): `src/agentic_platform/agent/agentic_rag/server.py`
- [RAG Controller](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_rag/controller/agentic_rag_controller.py): `src/agentic_platform/agent/agentic_rag/controller/agentic_rag_controller.py`
- [Strands RAG](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_rag/agent/agentic_rag_agent.py): `src/agentic_platform/agent/agentic_rag/agent/agentic_rag_agent.py`
- [Knowledge Tool](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/agentic_rag/tool/kb_tool.py): `src/agentic_platform/agent/agentic_rag/tool/kb_tool.py`
- [LangGraph Chat](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/langgraph_chat/chat_workflow.py): `src/agentic_platform/agent/langgraph_chat/chat_workflow.py`
- [Workflow Controller](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/langgraph_chat/chat_controller.py): `src/agentic_platform/agent/langgraph_chat/chat_controller.py`
- [Jira Agent](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/jira_agent/jira_agent.py): `src/agentic_platform/agent/jira_agent/jira_agent.py`
- [Jira Controller](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/jira_agent/jira_controller.py): `src/agentic_platform/agent/jira_agent/jira_controller.py`
- [Glue Athena Agent](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/strands_glue_athena/agent_service.py): `src/agentic_platform/agent/strands_glue_athena/agent_service.py`
- [Data Controller](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/agent/strands_glue_athena/agent_controller.py): `src/agentic_platform/agent/strands_glue_athena/agent_controller.py`

### Shared Core

- [API Models](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/models/api_models.py): `src/agentic_platform/core/models/api_models.py`
- [Stream Models](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/models/streaming_models.py): `src/agentic_platform/core/models/streaming_models.py`
- [Memory Models](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/models/memory_models.py): `src/agentic_platform/core/models/memory_models.py`
- [Request Middleware](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/middleware/configure_middleware.py): `src/agentic_platform/core/middleware/configure_middleware.py`
- [LLM Client](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/client/llm_gateway/llm_gateway_client.py): `src/agentic_platform/core/client/llm_gateway/llm_gateway_client.py`
- [LiteLLM Client](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/client/llm_gateway/litellm_gateway_client.py): `src/agentic_platform/core/client/llm_gateway/litellm_gateway_client.py`
- [Retrieval Client](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/core/client/retrieval_gateway/retrieval_gateway_client.py): `src/agentic_platform/core/client/retrieval_gateway/retrieval_gateway_client.py`

### Gateway Services

- [Memory Gateway](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/service/memory_gateway/server.py): `src/agentic_platform/service/memory_gateway/server.py`
- [Memory Controllers](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/service/memory_gateway/api/create_memory_controller.py): `src/agentic_platform/service/memory_gateway/api/create_memory_controller.py`
- [Memory Clients](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/service/memory_gateway/client/memory/memory_client.py): `src/agentic_platform/service/memory_gateway/client/memory/memory_client.py`
- [Retrieval Gateway](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/service/retrieval_gateway/server.py): `src/agentic_platform/service/retrieval_gateway/server.py`
- [Retrieve Controller](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/service/retrieval_gateway/api/retrieve_controller.py): `src/agentic_platform/service/retrieval_gateway/api/retrieve_controller.py`
- [Vector Search Client](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/service/retrieval_gateway/client/vectorsearch_client.py): `src/agentic_platform/service/retrieval_gateway/client/vectorsearch_client.py`

### MCP Servers

- [Bedrock KB MCP](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/mcp_server/bedrock_kb_mcp_server/server.py): `src/agentic_platform/mcp_server/bedrock_kb_mcp_server/server.py`
- [Code Graph MCP](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/mcp_server/code_graph_mcp_server/server.py): `src/agentic_platform/mcp_server/code_graph_mcp_server/server.py`
- [Graph Queries](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/mcp_server/code_graph_mcp_server/tool/query_tools.py): `src/agentic_platform/mcp_server/code_graph_mcp_server/tool/query_tools.py`
- [Code Graph](https://github.com/aws-samples/sample-agentic-platform/blob/main/src/agentic_platform/mcp_server/code_graph_mcp_server/tool/graph.py): `src/agentic_platform/mcp_server/code_graph_mcp_server/tool/graph.py`

### Other components

- **User**
- **Bedrock Knowledge Base**
- **LiteLLM Gateway Service**

## Connections

- User → Chat HTTP: invokes (evidence: `README.md`)
- Chat HTTP → Chat Controller: routes to (evidence: `src/agentic_platform/agent/agentic_chat/server.py`)
- Chat Controller → Strands Chat: invokes (evidence: `src/agentic_platform/agent/agentic_chat/controller/agentic_chat_controller.py`)
- User → RAG HTTP: invokes (evidence: `README.md`)
- RAG HTTP → RAG Controller: routes to (evidence: `src/agentic_platform/agent/agentic_rag/server.py`)
- RAG Controller → Strands RAG: invokes (evidence: `src/agentic_platform/agent/agentic_rag/controller/agentic_rag_controller.py`)
- Strands RAG → Knowledge Tool: uses (evidence: `src/agentic_platform/agent/agentic_rag/agent/agentic_rag_agent.py`)
- Knowledge Tool → Bedrock Knowledge Base: queries
- User → Workflow Controller: invokes (evidence: `README.md`)
- Workflow Controller → LangGraph Chat: runs (evidence: `src/agentic_platform/agent/langgraph_chat/chat_controller.py`)
- User → Jira Controller: invokes (evidence: `README.md`)
- Jira Controller → Jira Agent: invokes (evidence: `src/agentic_platform/agent/jira_agent/jira_controller.py`)
- User → Data Controller: invokes (evidence: `README.md`)
- Data Controller → Glue Athena Agent: delegates to (evidence: `src/agentic_platform/agent/strands_glue_athena/agent_controller.py`)
- Chat HTTP → Request Middleware: configures (evidence: `src/agentic_platform/agent/agentic_chat/server.py`)
- RAG HTTP → Request Middleware: configures (evidence: `src/agentic_platform/agent/agentic_rag/server.py`)
- Chat HTTP → API Models: uses (evidence: `src/agentic_platform/agent/agentic_chat/server.py`)
- RAG HTTP → API Models: uses (evidence: `src/agentic_platform/agent/agentic_rag/server.py`)
- Chat Controller → API Models: accepts (evidence: `src/agentic_platform/agent/agentic_chat/controller/agentic_chat_controller.py`)
- Chat Controller → Stream Models: emits (evidence: `src/agentic_platform/agent/agentic_chat/controller/agentic_chat_controller.py`)
- RAG Controller → API Models: accepts (evidence: `src/agentic_platform/agent/agentic_rag/controller/agentic_rag_controller.py`)
- RAG Controller → Stream Models: emits (evidence: `src/agentic_platform/agent/agentic_rag/controller/agentic_rag_controller.py`)
- Workflow Controller → Memory Models: uses (evidence: `src/agentic_platform/agent/langgraph_chat/chat_controller.py`)
- LLM Client → LiteLLM Client: delegates to (evidence: `src/agentic_platform/core/client/llm_gateway/llm_gateway_client.py`)
- LiteLLM Client → LiteLLM Gateway Service: requests (evidence: `src/agentic_platform/core/client/llm_gateway/litellm_gateway_client.py`)
- Retrieval Client → Retrieval Gateway: posts retrieval (evidence: `src/agentic_platform/core/client/retrieval_gateway/retrieval_gateway_client.py`)
- Memory Gateway → Memory Controllers: registers routes (evidence: `src/agentic_platform/service/memory_gateway/server.py`)
- Memory Controllers → Memory Clients: calls (evidence: `src/agentic_platform/service/memory_gateway/api/create_memory_controller.py`)
- Retrieval Gateway → Retrieve Controller: registers route
- Retrieve Controller → Vector Search Client: retrieves (evidence: `src/agentic_platform/service/retrieval_gateway/api/retrieve_controller.py`)
- User → Bedrock KB MCP: uses MCP (evidence: `README.md`)
- User → Code Graph MCP: uses MCP (evidence: `README.md`)
- Code Graph MCP → Graph Queries: calls (evidence: `src/agentic_platform/mcp_server/code_graph_mcp_server/server.py`)
- Graph Queries → Code Graph: queries (evidence: `src/agentic_platform/mcp_server/code_graph_mcp_server/tool/query_tools.py`)
- Strands Chat → LLM Client: uses gateway (evidence: `README.md`)
- Strands RAG → LLM Client: uses gateway (evidence: `README.md`)
- Jira Agent → LLM Client: uses gateway (evidence: `README.md`)
- Glue Athena Agent → LLM Client: uses gateway (evidence: `README.md`)
- Strands Chat → Memory Gateway: uses gateway (evidence: `README.md`)
- Strands RAG → Retrieval Gateway: uses gateway (evidence: `README.md`)
