# mongodb-industry-solutions/multiagent-predictive-maintenance architecture

> Architecture diagram of the GitHub repository mongodb-industry-solutions/multiagent-predictive-maintenance, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mongodb-industry-solutions/multiagent-predictive-maintenance
- Repository: https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance

## Overview

This is a predictive-maintenance demo combining a multi-agent maintenance workflow with a Unified Namespace (UNS) factory-operations experience. Users can explore factory data and chat with an agent; the documented agent workflow detects anomalies, diagnoses causes, drafts work orders, and schedules maintenance. The graph includes the API/agent runtime and factory-data layer. Some agent and UI implementations were not sampled, so their relationships are included only where the README or SOURCE INDEX supports them.

Main entry points: [`src/agents/callAgent.js`](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/callAgent.js) (Agent Runtime), [`src/agents/supervisor/graph.js`](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/supervisor/graph.js) (Supervisor), [`src/agents/failure/graph.js`](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/failure/graph.js) (Failure Diagnosis), [`src/agents/workorder/graph.js`](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/workorder/graph.js) (Work Order)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Application API"]
  node_chat_api["Chat API<br/>[route.js]"]
  node_thread_api["Thread API<br/>[route.js]"]
  node_action_api["Database Action API<br/>[route.js]"]
end

subgraph group_agents["Maintenance Agents"]
  node_call_agent["Agent Runtime<br/>[callAgent.js]"]
  node_registry["Agent Registry<br/>[config.js]"]
  node_supervisor["Supervisor<br/>[graph.js]"]
  node_failure["Failure Diagnosis<br/>[graph.js]"]
  node_workorder["Work Order<br/>[graph.js]"]
  node_planning["Work Planning<br/>[graph.js]"]
  node_uns_agent["UNS Chat Agent<br/>[graph.js]"]
  node_chat_history[("Chat History<br/>[chatHistory.js]")]
end

subgraph group_factory["Factory Operations"]
  node_factory_ui["Factory Data Provider"]
  node_factory_chat["Factory Chat<br/>[useFactoryChat.js]"]
  node_factory_client["Factory Client<br/>[factoryClient.js]"]
  node_local_factory["Local Simulation<br/>[localFactory.js]"]
  node_planning_sim["Planning Simulation<br/>[planning.js]"]
end

subgraph group_data["Data and AI Providers"]
  node_mongo[("MongoDB<br/>[client.js]")]
  node_vector_search["Vector Search<br/>[vectorSearch.js]"]
  node_embedding_factory["Embedding Provider Factory"]
end

node_operator(("Operator"))
node_external_factory["Factory Simulator"]
node_chat_provider["Chat Provider"]

node_operator -->|"sends message"| node_chat_api
node_chat_api -->|"invokes"| node_call_agent
node_thread_api -->|"invokes"| node_call_agent
node_thread_api -->|"loads thread"| node_chat_history
node_call_agent -->|"resolves agent"| node_registry
node_call_agent -->|"connects to"| node_mongo
node_call_agent -->|"creates graph"| node_supervisor
node_call_agent -->|"creates graph"| node_failure
node_call_agent -->|"creates graph"| node_workorder
node_call_agent -->|"creates graph"| node_planning
node_call_agent -->|"creates graph"| node_uns_agent
node_supervisor -->|"dispatches"| node_failure
node_supervisor -->|"dispatches"| node_workorder
node_supervisor -->|"dispatches"| node_planning
node_failure -->|"retrieves context"| node_vector_search
node_vector_search -->|"searches"| node_mongo
node_vector_search -->|"generates embeddings"| node_embedding_factory
node_operator -->|"asks questions"| node_factory_chat
node_factory_chat -->|"reads snapshot"| node_factory_ui
node_factory_chat -->|"sends chat"| node_chat_api
node_factory_ui -->|"fetches remote data"| node_factory_client
node_factory_ui -->|"restores local state"| node_local_factory
node_factory_client -->|"requests simulator API"| node_external_factory
node_action_api -->|"executes database actions"| node_mongo
node_planning -->|"uses planning logic"| node_planning_sim
node_supervisor -->|"uses chat model"| node_chat_provider
node_failure -.->|"diagnosis informs action"| node_workorder
node_workorder -.->|"tasks get scheduled"| node_planning

click node_chat_api "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/app/api/chat/route.js"
click node_thread_api "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/app/api/chat/%5BthreadId%5D/route.js"
click node_action_api "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/app/api/action/%5Baction%5D/route.js"
click node_call_agent "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/callAgent.js"
click node_registry "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/config.js"
click node_supervisor "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/supervisor/graph.js"
click node_failure "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/failure/graph.js"
click node_workorder "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/workorder/graph.js"
click node_planning "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/planning/graph.js"
click node_uns_agent "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/uns-chat/graph.js"
click node_chat_history "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/chatHistory.js"
click node_factory_ui "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/components/factoryDataProvider/FactoryDataProvider.js"
click node_factory_chat "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/components/unsChat/useFactoryChat.js"
click node_factory_client "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/lib/factory/factoryClient.js"
click node_local_factory "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/lib/factory/localFactory.js"
click node_planning_sim "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/lib/simulation/planning.js"
click node_mongo "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/integrations/mongodb/client.js"
click node_vector_search "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/integrations/mongodb/vectorSearch.js"
click node_embedding_factory "https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/integrations/embeddings_factory.js"

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_api,node_thread_api,node_action_api toneBlue
class node_call_agent,node_registry,node_supervisor,node_failure,node_workorder,node_planning,node_uns_agent,node_chat_history toneAmber
class node_factory_ui,node_factory_chat,node_factory_client,node_local_factory,node_planning_sim toneMint
class node_mongo,node_vector_search,node_embedding_factory toneRose
class node_operator,node_external_factory,node_chat_provider toneIndigo
```

## Components

### Application API

- [Chat API](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/app/api/chat/route.js): `src/app/api/chat/route.js`
- [Thread API](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/app/api/chat/%5BthreadId%5D/route.js): `src/app/api/chat/[threadId]/route.js`
- [Database Action API](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/app/api/action/%5Baction%5D/route.js): `src/app/api/action/[action]/route.js`

### Maintenance Agents

- [Agent Runtime](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/callAgent.js): `src/agents/callAgent.js`
- [Agent Registry](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/config.js): `src/agents/config.js`
- [Supervisor](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/supervisor/graph.js): `src/agents/supervisor/graph.js`
- [Failure Diagnosis](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/failure/graph.js): `src/agents/failure/graph.js`
- [Work Order](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/workorder/graph.js): `src/agents/workorder/graph.js`
- [Work Planning](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/planning/graph.js): `src/agents/planning/graph.js`
- [UNS Chat Agent](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/uns-chat/graph.js): `src/agents/uns-chat/graph.js`
- [Chat History](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/agents/chatHistory.js): `src/agents/chatHistory.js`

### Factory Operations

- [Factory Data Provider](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/components/factoryDataProvider/FactoryDataProvider.js): `src/components/factoryDataProvider/FactoryDataProvider.js`
- [Factory Chat](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/components/unsChat/useFactoryChat.js): `src/components/unsChat/useFactoryChat.js`
- [Factory Client](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/lib/factory/factoryClient.js): `src/lib/factory/factoryClient.js`
- [Local Simulation](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/lib/factory/localFactory.js): `src/lib/factory/localFactory.js`
- [Planning Simulation](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/lib/simulation/planning.js): `src/lib/simulation/planning.js`

### Data and AI Providers

- [MongoDB](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/integrations/mongodb/client.js): `src/integrations/mongodb/client.js`
- [Vector Search](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/integrations/mongodb/vectorSearch.js): `src/integrations/mongodb/vectorSearch.js`
- [Embedding Provider Factory](https://github.com/mongodb-industry-solutions/multiagent-predictive-maintenance/blob/main/src/integrations/embeddings_factory.js): `src/integrations/embeddings_factory.js`

### Other components

- **Operator**
- **Factory Simulator**
- **Chat Provider**

## Connections

- Operator → Chat API: sends message (evidence: `src/app/api/chat/route.js`)
- Chat API → Agent Runtime: invokes (evidence: `src/app/api/chat/route.js`)
- Thread API → Agent Runtime: invokes (evidence: `src/app/api/chat/[threadId]/route.js`)
- Thread API → Chat History: loads thread (evidence: `src/app/api/chat/[threadId]/route.js`)
- Agent Runtime → Agent Registry: resolves agent (evidence: `src/agents/callAgent.js`)
- Agent Runtime → MongoDB: connects to (evidence: `src/agents/callAgent.js`)
- Agent Runtime → Supervisor: creates graph
- Agent Runtime → Failure Diagnosis: creates graph
- Agent Runtime → Work Order: creates graph
- Agent Runtime → Work Planning: creates graph
- Agent Runtime → UNS Chat Agent: creates graph
- Supervisor → Failure Diagnosis: dispatches (evidence: `src/agents/supervisor/graph.js`)
- Supervisor → Work Order: dispatches (evidence: `src/agents/supervisor/graph.js`)
- Supervisor → Work Planning: dispatches (evidence: `src/agents/supervisor/graph.js`)
- Failure Diagnosis → Vector Search: retrieves context
- Vector Search → MongoDB: searches (evidence: `src/integrations/mongodb/vectorSearch.js`)
- Vector Search → Embedding Provider Factory: generates embeddings (evidence: `src/integrations/mongodb/vectorSearch.js`)
- Operator → Factory Chat: asks questions (evidence: `src/components/unsChat/useFactoryChat.js`)
- Factory Chat → Factory Data Provider: reads snapshot (evidence: `src/components/unsChat/useFactoryChat.js`)
- Factory Chat → Chat API: sends chat (evidence: `src/components/unsChat/useFactoryChat.js`)
- Factory Data Provider → Factory Client: fetches remote data (evidence: `src/components/factoryDataProvider/FactoryDataProvider.js`)
- Factory Data Provider → Local Simulation: restores local state (evidence: `src/components/factoryDataProvider/FactoryDataProvider.js`)
- Factory Client → Factory Simulator: requests simulator API (evidence: `src/lib/factory/factoryClient.js`)
- Database Action API → MongoDB: executes database actions (evidence: `src/app/api/action/[action]/route.js`)
- Work Planning → Planning Simulation: uses planning logic
- Supervisor → Chat Provider: uses chat model (evidence: `src/agents/supervisor/graph.js`)
- Failure Diagnosis → Work Order: diagnosis informs action (evidence: `README.md`)
- Work Order → Work Planning: tasks get scheduled (evidence: `README.md`)
