# build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra architecture

> Architecture diagram of the GitHub repository build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra
- Repository: https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra

## Overview

##### Project type and purpose
- This is a serverless, full-stack “customer support bot” app built with AWS CDK (Python).
- It uses AWS Lambda for compute, API Gateway as the webhook entry point, Amazon Bedrock (LLM) + LangChain for natural-language processing, Amazon Kendra for Q&A over a PDF knowledge base, DynamoDB for session and passenger data, Amazon Transcribe for voice notes, and optionally an S3+CloudFront site for static hosting.

##### High-level file-structure analysis
- Top level: project metadata (README, LICENSE, CODE_OF_CONDUCT, etc.) and a “customer-support-bot” subfolder which contains:
- CDK app (`app.py`, `cdk.json`)
- Two CDK stacks under `customer_support_bot/`:
– `customer_support_bot_stack.py` (main infra)
– `application_insights_stack.py` (observability)
- Constructs for Kendra (`kendra_constructs/`), databases (`databases/`), S3+CloudFront (`s3_cloudfront/`).
- A `lambdas/` folder with per-Lambda subfolders under `code/`, plus helper modules (`datasource.py`, `project_lambdas.py`).
- A `layers/` folder bundling common Python utilities and third-party libs.
- A sample airline dataset and PDF Q&A base under `airline-dataset/` and `airline-qa-base/`.

##### Core architecture components
a. External interfaces
- WhatsApp Business (incoming messages + webhooks)
- Facebook/Meta webhook API
- Developer’s AWS CDK CLI (deploys all infra)
b. Ingress/API Layer
- API Gateway (HTTP endpoint) receives WhatsApp webhook calls
c. Compute (AWS Lambda functions)
- whatsapp_in: parses webhook payloads, persists raw events
- langchain_agent_text: orchestrates LLM calls (Bedrock), calls DynamoDB-based memory, invokes Kendra search, builds the response
- audio_job_transcriptor, process_stream, transcriber_done: handle audio streams via Amazon Transcribe
- query_dynamodb_passanger: lookup passenger record by reservation ID
- dynamodb_put_item: write session state or passenger data
- whatsapp_out: posts responses back to WhatsApp API
- data_source_creator: (one-off) populates/upserts the Kendra data source for PDF ingestion
d. Data layer
- Amazon DynamoDB:
- `session_table` (conversation history)
- `session_active_table` (session timeouts)
- `Passenger_ID` (sample passenger data)
- Amazon Kendra Index + DataSource (PDFs under `airline-qa-base`)
e. AI/ML services
- Amazon Bedrock LLM (text generation)
- Amazon Transcribe (speech-to-text)
f. Configuration and secrets
- AWS Secrets Manager (WhatsApp credentials)
- CDK Parameter overrides (e.g. `DISPLAY_PHONE_NUMBER`)

##### Data-flow and relationships
1. User sends text or voice on WhatsApp
2. Meta/WhatsApp webhook → API Gateway → `whatsapp_in` Lambda
3. For voice: `whatsapp_in` uploads media to S3, triggers `audio_job_transcriptor` → Transcribe → `transcriber_done` → pushes transcript back into the flow
4. `langchain_agent_text` Lambda:
- retrieves session history from DynamoDB
- calls Amazon Kendra for Q&A lookup over PDFs
- calls Amazon Bedrock (via LangChain) with prompt + memory + Kendra results
- writes updated memory to DynamoDB
5. Query passenger info via `query_dynamodb_passanger` if requested
6. Formulate final response JSON → `whatsapp_out` Lambda → Meta API → user

##### Architectural patterns and design principles
- Serverless, event-driven (Lambda + triggers)
- Single-responsibility Lambdas (each function does one job)
- Infrastructure as Code (AWS CDK) following modular constructs
- Layered Python code (common utilities in Lambda Layers)
- Data-driven AI orchestration (DynamoDB memory + Kendra context + LLM)
- Secure secret management (Secrets Manager for WhatsApp tokens)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External
    subgraph "External" 
        WhatsApp["WhatsApp Business"]:::external
        Facebook["Facebook/Meta API"]:::external
        DevCLI["Developer CDK CLI"]:::external
    end

    %% Infrastructure as Code
    subgraph "Infrastructure as Code"
        CDKApp["app.py"]:::infra
        CDKConfig["cdk.json"]:::infra
        MainStack["customer_support_bot_stack.py"]:::infra
        InsightsStack["application_insights_stack.py"]:::infra
        KendraDSConstruct["datasource.py"]:::infra
        KendraIndexConstruct["index.py"]:::infra
        KendraRoles["roles.py"]:::infra
        DBConstruct["databases.py"]:::infra
        S3Website["s3_cloudfront_website.py"]:::infra
        APIConstruct["webhooks.py"]:::infra
    end

    %% API & Compute
    subgraph "API & Compute"
        APIGW["API Gateway HTTP Endpoint"]:::compute
        IngressLambda["whatsapp_in Lambda"]:::compute
        LangChainLambda["langchain_agent_text Lambda"]:::compute
        AudioTranscribeLambda["audio_job_transcriptor Lambda"]:::compute
        ProcessStreamLambda["process_stream Lambda"]:::compute
        TranscriberDoneLambda["transcriber_done Lambda"]:::compute
        DataSourceCreator["data_source_creator Lambda"]:::compute
        DynamoPut["dynamodb_put_item Lambda"]:::compute
        QueryPassenger["query_dynamodb_passanger Lambda"]:::compute
        WhatsappOut["whatsapp_out Lambda"]:::compute
    end

    %% Data & AI Services
    subgraph "Data & AI Services"
        SessionTable["DynamoDB session_table"]:::data
        ActiveTable["DynamoDB session_active_table"]:::data
        PassengerTable["DynamoDB Passenger_ID table"]:::data
        KendraIndex["Kendra Index"]:::ai
        KendraDS["Kendra DataSource"]:::ai
        S3Bucket["S3 Bucket"]:::data
        CloudFront["CloudFront CDN"]:::data
        Bedrock["Amazon Bedrock LLM"]:::ai
        TranscribeService["Amazon Transcribe"]:::ai
        SecretsMgr["Secrets Manager"]:::data
    end

    %% External to API
    WhatsApp -->|HTTP POST| APIGW
    Facebook -->|HTTP POST| APIGW

    %% API to Lambdas
    APIGW -->|Invoke| IngressLambda

    %% Ingress Lambda flows
    IngressLambda -->|S3 PutObject| S3Bucket
    S3Bucket -->|S3 event| AudioTranscribeLambda
    AudioTranscribeLambda -->|Start Transcription| TranscribeService
    TranscribeService -->|Transcription Completed| TranscriberDoneLambda
    TranscriberDoneLambda -->|Invoke| LangChainLambda
    IngressLambda -->|Invoke| LangChainLambda

    %% LangChain orchestration
    LangChainLambda -->|DynamoDB GetItem| SessionTable
    LangChainLambda -->|DynamoDB GetItem| ActiveTable
    LangChainLambda -->|Kendra Query| KendraIndex
    LangChainLambda -->|Bedrock Call| Bedrock
    LangChainLambda -->|DynamoDB PutItem| DynamoPut
    LangChainLambda -->|Optional Query| QueryPassenger
    QueryPassenger -->|DynamoDB GetItem| PassengerTable
    LangChainLambda -->|Invoke| WhatsappOut

    %% Responses
    WhatsappOut -->|HTTP POST| WhatsApp

    %% Secrets
    SecretsMgr -->|Env Vars| IngressLambda
    SecretsMgr -->|Env Vars| WhatsappOut

    %% Developer deployment flow
    DevCLI -->|cdk deploy| CDKApp
    CDKApp --> CDKConfig
    CDKApp --> MainStack
    CDKApp --> InsightsStack
    MainStack --> KendraDSConstruct
    MainStack --> KendraIndexConstruct
    MainStack --> KendraRoles
    MainStack --> DBConstruct
    MainStack --> S3Website
    MainStack --> APIConstruct

    %% Click events
    click CDKApp "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/app.py"
    click CDKConfig "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/cdk.json"
    click MainStack "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/customer_support_bot/customer_support_bot_stack.py"
    click InsightsStack "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/customer_support_bot/application_insights_stack.py"
    click KendraDSConstruct "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/kendra_constructs/datasource.py"
    click KendraIndexConstruct "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/kendra_constructs/index.py"
    click KendraRoles "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/kendra_constructs/roles.py"
    click DBConstruct "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/databases/databases.py"
    click S3Website "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/s3_cloudfront/s3_cloudfront_website.py"
    click APIConstruct "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/apis/webhooks.py"
    click IngressLambda "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/lambdas/code/whatsapp_in/lambda_function.py"
    click LangChainLambda "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/lambdas/code/langchain_agent_text/lambda_function.py"
    click AudioTranscribeLambda "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/lambdas/code/audio_job_transcriptor/lambda_function.py"
    click ProcessStreamLambda "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/lambdas/code/process_stream/lambda_function.py"
    click TranscriberDoneLambda "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/lambdas/code/transcriber_done/lambda_function.py"
    click DataSourceCreator "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/lambdas/code/data_source_creator/lambda_function.py"
    click DynamoPut "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/lambdas/code/dynamodb_put_item/lambda_function.py"
    click QueryPassenger "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/lambdas/code/query_dynamodb_passanger/lambda_function.py"
    click WhatsappOut "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/lambdas/code/whatsapp_out/lambda_function.py"
    click S3Bucket "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/tree/main/customer-support-bot/airline-qa-base/PDF/"
    click PassengerTable "https://github.com/build-on-aws/elevating-customer-support-with-rag-langchain-agent-bedrock-dynamodb-and-kendra/blob/main/customer-support-bot/airline-dataset/dataset.csv"

    %% Styles
    classDef external fill:#e0f3db,stroke:#2d6a4f,color:#1b4332
    classDef compute fill:#e5dbf0,stroke:#6a4c93,color:#4c1d95
    classDef data fill:#d0ebff,stroke:#1c7ed6,color:#1864ab
    classDef ai fill:#ffe5b4,stroke:#ff9f1c,color:#cc5803
    classDef infra fill:#f0f0f0,stroke:#999999,color:#333333
```
