How the reference builds are put together.

flowchart TB
  subgraph external["Outside AWS"]
    User["Demo user"]
    Trace["Tracing optional"]
    Web["Web search optional"]
  end

  subgraph aws["AWS account"]
    CDK["CDK / CloudFormation"]
    SM["Secrets Manager"]

    subgraph vpc["VPC"]
      NAT["NAT Gateway"]
      NLB["NLB HTTP"]
      ALB["ALB HTTPS plus Cognito"]

      subgraph eks["Managed Kubernetes"]
        subgraph showcase["showcase"]
          UI["Showcase UI SSE gateway"]
        end
        subgraph agents["agents"]
          LG["Research agents"]
        end
        subgraph rag["rag"]
          Ing["Ingestion API"]
          Qdrant["Vector store"]
          Redis["Cache"]
        end
        subgraph system["cluster add-ons"]
          ALBC["Load balancer controller"]
          EBS["Block storage CSI"]
        end
        Node["Worker nodes"]
      end

      S3["Object storage"]
      Cognito["Cognito user pool"]
      Budget["Model budget alerts"]
      Bedrock["Bedrock Claude and Titan"]
    end
  end

  User --> NLB
  User -.->|after cert ready| ALB
  ALB --> Cognito
  Cognito --> ALB
  NLB --> UI
  ALB -.-> UI
  UI -->|SSE events| LG
  UI --> Ing
  LG --> Qdrant
  LG --> Ing
  Ing -->|SWAG filter CRAG grade| Bedrock
  LG --> Bedrock
  LG -.-> Trace
  LG -.-> Web
  Ing --> S3
  Ing --> Qdrant
  Ing --> Bedrock
  SM -.-> UI
  SM -.-> LG
  SM -.-> Ing
  CDK --> vpc
  CDK --> Cognito
  CDK --> Budget
  CDK --> SM
  ALBC --> ALB
  EBS --> Qdrant
  NAT --> Bedrock
  NAT --> Trace

flowchart LR
  Q[Query] --> R[Vector retrieve]
  R --> P[Ensure SWAG profiles]
  P --> S[SWAG rerank and noise filter]
  S --> G[CRAG grader capped]
  G -->|relevant| F[Return filtered chunks]
  G -->|ambiguous| RW[Rewrite query]
  RW --> R
  G -->|irrelevant| W[Optional web fallback]
  W --> F
  F --> A[Researcher or UI]

sequenceDiagram
  actor User
  participant Edge as Edge HTTPS Cognito
  participant UI as Showcase UI gateway
  participant LG as Research agents
  participant Ing as Ingestion API
  participant Q as Vector store
  participant BR as Bedrock
  participant Web as Web search optional
  participant Trace as Tracing optional

  User->>Edge: HTTPS
  Edge->>UI: Forward
  User->>UI: Research topic
  UI->>LG: Start streamed run
  LG-->>UI: Run started
  LG->>LG: Coordinator plan
  LG-->>UI: Plan review interrupt
  User->>UI: Approve plan
  UI->>LG: Resume
  Note over LG,Ing: researchers use SWAG then CRAG per sub-question
  LG->>Ing: Search with SWAG then CRAG
  Ing->>Q: Vector retrieve candidates
  Q-->>Ing: Chunks plus SWAG metadata
  Ing->>BR: SWAG rerank and CRAG grade capped
  BR-->>Ing: Reranked graded chunks
  alt weak RAG
    Ing-->>LG: web fallback
    LG->>Web: Web search
    Web-->>LG: Web snippets
  else good RAG
    Ing-->>LG: Filtered chunks
  end
  LG->>BR: Synthesize findings
  LG-->>UI: Critique review interrupt
  User->>UI: Synthesize or more research
  LG-->>UI: Report
  LG-->>Trace: Traces

sequenceDiagram
  actor User
  participant Edge as NLB or ALB Cognito
  participant UI as Showcase UI
  participant Ing as Ingestion
  participant S3 as S3
  participant BR as Bedrock
  participant Q as Qdrant

  User->>Edge: HTTP or HTTPS
  Edge->>UI: Forward
  User->>UI: Upload file
  UI->>Ing: Ingest request
  Ing->>S3: Store raw
  Ing->>Ing: Chunk and classify nav or body
  Ing->>BR: Titan embeddings
  BR-->>Ing: Vectors
  Ing->>Ing: Heuristic SWAG chunk profiles
  Ing->>Q: Upsert vectors and SWAG payload
  Ing-->>UI: Done

flowchart LR
  Visitor["Website visitor HTML form"] -->|"POST JSON"| API["API Gateway HTTP API"]
  API --> Lambda["AWS Lambda processor"]
  Lambda -->|save lead| DDB["DynamoDB leads table"]
  Lambda -.->|optional scoring| BR["Amazon Bedrock"]
  Lambda -->|send email| SES["Amazon SES verified sender"]
  SES -->|score grade summary| Owner["Sales or owner inbox"]
  API -->|JSON response| Visitor
  SAM["AWS SAM to CloudFormation"] --> API
  SAM --> Lambda
  SAM --> DDB

sequenceDiagram
  actor Visitor
  participant API as API Gateway HTTP API
  participant L as Lambda processor
  participant B as Bedrock optional
  participant D as DynamoDB
  participant M as SES
  participant Owner as Sales inbox
  Visitor->>API: POST JSON lead
  API->>L: Invoke proxy integration
  L->>L: validate
  opt scoring enabled
    L->>B: qualify
    B-->>L: score plus grade
  end
  L->>D: save lead
  L->>M: send email
  M-->>Owner: Lead email score grade summary
  L-->>API: 200 JSON
  API-->>Visitor: Response