Agentra + WisdomAI — Enterprise Agentic & Knowledge Platform

flowchart LR
  subgraph Req["Requesters"]
    R1["External customers"]
    R2["Internal employees"]
    R3["Frontline / blue-collar"]
  end
  subgraph Ch["Channel Layer"]
    CH["Adapters → one envelope"]
  end
  subgraph Plat["Platform — per tenant data plane"]
    direction TB
    OR["Orchestration Core"]
    WIS["WisdomAI RAG (USP1)"]
    AGT["Agentra Packs (USP2)"]
    MEM["Memory"]
  end
  subgraph Ext["Systems of Record via MCP / A2A"]
    E1["OMS·WMS·TMS·PSS·GDS"]
    E2["Payments·LOS·LMS·Bureaus"]
    E3["CRM·POS·PSA·KB"]
    E4["Partner agents (A2A)"]
  end
  subgraph GW["OpenLLM Gateway"]
    G1["LLM-agnostic routing"]
  end
  subgraph CP["Control Plane"]
    P1["Provisioning"]
    P2["Capability Registry"]
    P3["Identity Auth0+Okta"]
    P4["Entitlements·Vault"]
  end
  R1 & R2 & R3 --> CH --> OR
  OR --> WIS & AGT
  WIS & AGT <--> MEM
  AGT <--> Ext
  WIS <--> Ext
  WIS & AGT --> GW
  CP -.-> Plat
  classDef r fill:#1a3a5e,stroke:#6ea8fe,color:#e6edf3
  classDef p fill:#1f2937,stroke:#6ea8fe,color:#e6edf3
  classDef e fill:#3b2e4a,stroke:#c79bf0,color:#e6edf3
  classDef c fill:#1f3a2f,stroke:#7ee0c0,color:#e6edf3
  class R1,R2,R3 r
  class OR,WIS,AGT,MEM,CH p
  class E1,E2,E3,E4 e
  class P1,P2,P3,P4,G1 c
    

flowchart TB
  EXP["EXPERIENCE — customer apps · employee apps · consoles · Frontline Mobile Shell"]
  CHN["CHANNEL LAYER — adapters → normalized InboundMessage (web·voice·IVR·WhatsApp·Slack·Teams·SMS·handheld·kiosk·push)"]
  ORC["ORCHESTRATION CORE — Triage → Context → Router/Supervisor → [Knowledge | Agentic] · durable state · guardrail supervisors"]
  WIS["WISDOMAI RAG ENGINE (USP1) — ingest·index·retrieve·rerank·ground·cite"]
  AGT["AGENTRA PACK RUNTIME (USP2) — specialist agents · reusable core · frontline shell"]
  INT["INTEGRATION — MCP servers (read/write-tagged) · A2A · tool gateway · capability registry"]
  GW["OPENLLM GATEWAY — LLM-agnostic · routing · fallback · cache · guardrails · virtual keys"]
  DAT["DATA & PLATFORM — vector · Postgres · Redis · graph · trace · bus · KMS/Vault · tenancy · security · obs"]
  EXP --> CHN --> ORC
  ORC --> WIS
  ORC --> AGT
  WIS --> INT
  AGT --> INT
  INT --> GW
  INT --> DAT
  GW --> DAT
  classDef l fill:#1f2937,stroke:#6ea8fe,color:#e6edf3
  classDef u fill:#16302a,stroke:#7ee0c0,color:#e6edf3
  class EXP,CHN,ORC,INT,GW,DAT l
  class WIS,AGT u
    

flowchart LR
  CL["Caller (OpenAI-shaped)"] --> A1["1 AuthN/Z
virtual key → tenant/scope"]
  A1 --> A2["2 Rate + budget
(Redis)"]
  A2 --> A3["3 INPUT guards
injection·moderation·PII"]
  A3 --> A4["4 Cache
exact → semantic (per-tenant)"]
  A4 --> A5["5 Router
cost·latency·complexity·pinned"]
  A5 --> A6["6 Provider adapter"]
  A6 --> P1["Anthropic"]
  A6 --> P2["OpenAI"]
  A6 --> P3["Vertex"]
  A6 --> P4["Bedrock"]
  A6 --> P5["self-hosted vLLM/NIM"]
  A6 --> A7["7 Resilience
retry·fallback·cooldown·LB"]
  A7 --> A8["8 OUTPUT guards + cache write"]
  A8 --> A9["9 Stream SSE + trace + spend"]
  classDef s fill:#1f2937,stroke:#6ea8fe,color:#e6edf3
  classDef pv fill:#3b2e4a,stroke:#c79bf0,color:#e6edf3
  class A1,A2,A3,A4,A5,A6,A7,A8,A9 s
  class P1,P2,P3,P4,P5 pv
    

flowchart LR
  subgraph IN["Ingest"]
    I1["Connectors
content + ACL"]
    I2["Layout-aware parse"]
    I3["Parent-child chunk"]
    I4["Contextual embed"]
    I5["Index (vector + sparse)"]
  end
  subgraph QY["Query"]
    Q1["Rewrite / expand / plan"]
    Q2["ACL pre-filter"]
    Q3["Hybrid retrieve
dense+sparse RRF"]
    Q4["Multi-vector (opt)"]
    Q5["Cross-encoder rerank"]
    Q6["Pre-LLM permission re-check"]
    Q7["Grounded synthesis
cite-or-abstain"]
    Q8["Grounding validator"]
  end
  I1-->I2-->I3-->I4-->I5
  Q1-->Q2-->Q3-->Q4-->Q5-->Q6-->Q7-->Q8
  I5-.->Q3
  classDef i fill:#16302a,stroke:#7ee0c0,color:#e6edf3
  classDef q fill:#1f2937,stroke:#6ea8fe,color:#e6edf3
  class I1,I2,I3,I4,I5 i
  class Q1,Q2,Q3,Q4,Q5,Q6,Q7,Q8 q
    

flowchart LR
  subgraph DIG["Digital"]
    D1["Web · Mobile SDK"]
    D2["Email"]
    D3["Slack · Teams"]
    D4["WhatsApp·RCS·Apple"]
  end
  subgraph VOX["Voice"]
    V1["SIP / Media Streams"]
    V2["IVR"]
  end
  subgraph FL["Frontline"]
    F1["Handheld / scanner"]
    F2["In-cab / field app"]
    F3["Kiosk · SMS · push"]
  end
  AD["Channel Adapters
auth · normalize · identity · rich-element xlate"]
  EN["InboundMessage envelope
tenant-stamped · PII-scrubbed"]
  RT["Orchestration Core"]
  D1 & D2 & D3 & D4 --> AD
  V1 & V2 --> AD
  F1 & F2 & F3 --> AD
  AD --> EN --> RT
  classDef d fill:#1f2937,stroke:#6ea8fe,color:#e6edf3
  classDef v fill:#3a2f24,stroke:#f0a868,color:#e6edf3
  classDef f fill:#16302a,stroke:#7ee0c0,color:#e6edf3
  classDef a fill:#3b2e4a,stroke:#c79bf0,color:#e6edf3
  class D1,D2,D3,D4 d
  class V1,V2 v
  class F1,F2,F3 f
  class AD,EN a
    

sequenceDiagram
  participant CH as Channel
  participant OR as Orchestrator
  participant TR as Triage
  participant CTX as Context Assembly
  participant GATE as Mode Gate
  participant WIS as WisdomAI RAG
  participant SUP as Supervisor
  participant SP as Specialists (parallel)
  participant GRD as Guardrail Supervisors
  participant MEM as Memory
  CH->>OR: InboundMessage
  OR->>TR: classify
  TR-->>OR: intent · urgency · locale
  OR->>CTX: assemble (memory + identity)
  OR->>GATE: read entitlement
  alt knowledge tier (WisdomAI)
    GATE->>WIS: retrieve + rerank + ground
    WIS-->>OR: cited answer (or abstain)
  else agentic tier (Agentra)
    GATE->>SUP: dispatch (pack)
    SUP->>SP: Promise.allSettled (parallel)
    SP->>WIS: ground via RAG
    SP-->>SUP: AgentResult[]
    SUP->>SUP: synthesize + apply policies
    SUP->>GRD: validate (policy·PII·threat)
    GRD-->>SUP: pass / block / HITL
    SUP-->>OR: ResolutionDirective (+ actions)
  end
  OR->>CH: OutboundMessage (rich)
  OR-)MEM: persist (async)
    

flowchart LR
  subgraph AG["Specialist Agent / WisdomAI"]
    A1["execute()"]
    A2["mcp.callTool()"]
  end
  subgraph MC["MCP Client (core)"]
    M1["Discover via registry"]
    M2["Tenant credential resolve (Vault)"]
    M3["sideEffects gate (read/write/financial)"]
    M4["Audit · idempotency · retry · mTLS"]
  end
  subgraph SV["MCP Server (per vendor)"]
    S1["Vendor auth (OAuth refresh)"]
    S2["Rate limit · circuit breaker"]
    S3["Tool handler"]
  end
  VEN["Vendor API
OMS·PSS·GDS·LOS·POS·PSA…"]
  AG --> MC --> SV --> VEN
  classDef a fill:#1f2937,stroke:#6ea8fe,color:#e6edf3
  classDef c fill:#16302a,stroke:#7ee0c0,color:#e6edf3
  classDef s fill:#3b2e4a,stroke:#c79bf0,color:#e6edf3
  classDef v fill:#3a2424,stroke:#f87171,color:#e6edf3
  class A1,A2 a
  class M1,M2,M3,M4 c
  class S1,S2,S3 s
  class VEN v
    

sequenceDiagram
  participant EM as Employee (Slack)
  participant CH as Slack Adapter
  participant OR as Orchestrator
  participant TR as Triage
  participant WIS as WisdomAI RAG
  participant ACL as Permissions
  EM->>CH: refund SLA enterprise EMEA?
  CH->>OR: InboundMessage (internal, Okta id)
  OR->>TR: classify
  TR-->>OR: intent=knowledge.policy_lookup
  OR->>ACL: resolve principals (Okta groups)
  OR->>WIS: rewrite/expand → ACL pre-filter
  WIS->>WIS: hybrid retrieve + cross-encoder rerank
  WIS->>ACL: pre-LLM permission re-check
  WIS->>WIS: grounded synthesis + grounding validator
  WIS-->>OR: cited answer (or abstain)
  OR->>CH: Block Kit answer + source links
    

sequenceDiagram
  participant CU as Customer (web)
  participant OR as Orchestrator
  participant TR as Triage
  participant SUP as Supervisor
  participant RET as Returns & Refunds
  participant FRA as Fraud / Risk
  participant WIS as WisdomAI (policy)
  participant GRD as Guardrails
  participant OMS as OMS (MCP)
  participant PAY as Payment (MCP)
  CU->>OR: return damaged #12345
  OR->>TR: classify (sentiment -0.6)
  OR->>SUP: dispatch (pack=ecommerce)
  par parallel specialists
    SUP->>RET: eligibility + RMA
    RET->>OMS: getOrder / getReturnPolicy
    SUP->>FRA: serial-returner check
    SUP->>WIS: damage-return policy (cited)
  end
  SUP->>SUP: synthesize ResolutionDirective
  SUP->>GRD: policy (refund ≤ threshold?) + PII
  GRD-->>SUP: pass (within threshold)
  RET->>OMS: createReturn (write)
  RET->>PAY: refund (financial · idempotent · double-gate)
  SUP-->>OR: directive
  OR->>CU: RMA + label + refund (cited policy)
    

sequenceDiagram
  participant FA as Field Agent (offline shell)
  participant CH as Field-app Adapter
  participant OR as Orchestrator
  participant SUP as Supervisor
  participant FCC as Field Collections Copilot
  participant POL as RBI Compliance
  participant LMS as LMS (MCP)
  participant PAY as Payment (MCP)
  FA->>CH: log visit (queued offline)
  CH->>OR: on reconnect → InboundMessage (hi-IN)
  OR->>SUP: dispatch (pack=nbfc)
  SUP->>FCC: handle field visit
  FCC->>POL: enforce contact-hours + vernacular script + anti-harassment
  POL-->>FCC: compliant script (Hindi)
  FCC->>LMS: getAccount (read) → history
  FCC->>PAY: recordCollection (financial · cash recon · HITL on amount)
  FCC-->>OR: receipt + geo/photo to LMS
  OR->>CH: idempotent replay if connectivity drops