# microsoft/ignite26-prel42 architecture

> Architecture diagram of the GitHub repository microsoft/ignite26-prel42, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/ignite26-prel42
- Repository: https://github.com/microsoft/ignite26-prel42

## Overview

This repository is a hands-on workshop for building context-aware AI applications with Foundry IQ, Fabric IQ, Work IQ, and Web IQ. The learner’s path is to provision sample data and services, run notebook labs to create knowledge and business-data sources, then query IQ endpoints or exercise agents locally and in Foundry. The graph preserves documented capabilities even where their implementation is represented only by a directory. Some subsystem links are dashed because the relevant notebook or deployment wiring was not excerpted.

Main entry points: [`src/agent-workiq-maf/main.py`](https://github.com/microsoft/ignite26-prel42/blob/main/src/agent-workiq-maf/main.py) (Workmate Agent), [`notebooks`](https://github.com/microsoft/ignite26-prel42/tree/main/notebooks) (IQ Notebooks), [`infra/create-search-indexes.py`](https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-search-indexes.py) (Search Indexes), [`infra/create-lakehouse.py`](https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-lakehouse.py) (DIY Lakehouse)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lab["Workshop Labs"]
  node_labs["IQ Notebooks"]
  node_webiq["Web IQ Lab"]
end

subgraph group_fabric["Fabric IQ Data"]
  node_fabric_data[("DIY Lakehouse")]
  node_web_data[("Analytics Lakehouse")]
  node_semantic["Analytics Model"]
  node_graph[("Product Graph")]
  node_data_agent["Fabric Data Agent"]
end

subgraph group_foundry["Foundry IQ Retrieval"]
  node_search[("Search Indexes")]
  node_knowledge["Knowledge Retrieval<br/>[main.py]"]
end

subgraph group_workiq["Work IQ Agents"]
  node_workmate["Workmate Agent<br/>[main.py]"]
  node_auth["Delegated Sign-in<br/>[workiq_auth.py]"]
  node_invoke["Agent Invoker<br/>[invoke.py]"]
end

subgraph group_provision["Provisioning"]
  node_workiq_setup["Work IQ OAuth Setup<br/>[workiq_oauth.py]"]
  node_workiq_entra["Work IQ Entra Setup"]
end

node_learner(("Learner"))
node_fabric_service["Microsoft Fabric"]
node_search_service[("Azure AI Search")]
node_workiq_service["Work IQ MCP"]
node_foundry_service["Microsoft Foundry"]
node_graph_service["Microsoft Graph"]

node_learner -->|"runs labs"| node_labs
node_learner -.->|"calls endpoints"| node_webiq
node_labs -.->|"creates data"| node_fabric_data
node_labs -.->|"builds knowledge"| node_search
node_labs -.->|"runs agents"| node_workmate
node_fabric_data -->|"loads tables"| node_fabric_service
node_web_data -->|"loads analytics"| node_fabric_service
node_semantic -->|"publishes model"| node_fabric_service
node_graph -->|"reads lakehouse"| node_fabric_data
node_graph -->|"creates graph"| node_fabric_service
node_data_agent -->|"creates agent"| node_fabric_service
node_search -->|"creates indexes"| node_search_service
node_search -->|"creates knowledge base"| node_foundry_service
node_knowledge -.->|"retrieves context"| node_search_service
node_workiq_setup -->|"configures connection"| node_foundry_service
node_workiq_setup -->|"provisions OAuth"| node_graph_service
node_workiq_entra -->|"configures permissions"| node_graph_service
node_invoke -->|"posts question"| node_workmate
node_invoke -->|"gets token"| node_auth
node_workmate -->|"acquires token"| node_auth
node_workmate -->|"asks MCP"| node_workiq_service
node_workmate -.->|"runs hosted"| node_foundry_service

click node_labs "https://github.com/microsoft/ignite26-prel42/tree/main/notebooks"
click node_webiq "https://github.com/microsoft/ignite26-prel42/tree/main/notebooks"
click node_fabric_data "https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-lakehouse.py"
click node_web_data "https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-web-analytics-lakehouse.py"
click node_semantic "https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-semantic-model.py"
click node_graph "https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-fabric-graph.py"
click node_data_agent "https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-fabric-data-agent.py"
click node_search "https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-search-indexes.py"
click node_knowledge "https://github.com/microsoft/ignite26-prel42/blob/main/src/agent-foundryiq-mcp/main.py"
click node_workiq_setup "https://github.com/microsoft/ignite26-prel42/blob/main/infra/workiq_oauth.py"
click node_workiq_entra "https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-workiq-entra.py"
click node_workmate "https://github.com/microsoft/ignite26-prel42/blob/main/src/agent-workiq-maf/main.py"
click node_auth "https://github.com/microsoft/ignite26-prel42/blob/main/src/agent-workiq-maf/workiq_auth.py"
click node_invoke "https://github.com/microsoft/ignite26-prel42/blob/main/src/agent-workiq-maf/invoke.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_labs,node_webiq toneBlue
class node_fabric_data,node_web_data,node_semantic,node_graph,node_data_agent,node_search_service toneAmber
class node_search,node_knowledge toneMint
class node_workmate,node_auth,node_invoke toneRose
class node_workiq_setup,node_workiq_entra,node_learner,node_fabric_service,node_workiq_service,node_foundry_service,node_graph_service toneIndigo
```

## Components

### Workshop Labs

- [IQ Notebooks](https://github.com/microsoft/ignite26-prel42/tree/main/notebooks): `notebooks`
- [Web IQ Lab](https://github.com/microsoft/ignite26-prel42/tree/main/notebooks): `notebooks`

### Fabric IQ Data

- [DIY Lakehouse](https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-lakehouse.py): `infra/create-lakehouse.py`
- [Analytics Lakehouse](https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-web-analytics-lakehouse.py): `infra/create-web-analytics-lakehouse.py`
- [Analytics Model](https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-semantic-model.py): `infra/create-semantic-model.py`
- [Product Graph](https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-fabric-graph.py): `infra/create-fabric-graph.py`
- [Fabric Data Agent](https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-fabric-data-agent.py): `infra/create-fabric-data-agent.py`

### Foundry IQ Retrieval

- [Search Indexes](https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-search-indexes.py): `infra/create-search-indexes.py`
- [Knowledge Retrieval](https://github.com/microsoft/ignite26-prel42/blob/main/src/agent-foundryiq-mcp/main.py): `src/agent-foundryiq-mcp/main.py`

### Work IQ Agents

- [Workmate Agent](https://github.com/microsoft/ignite26-prel42/blob/main/src/agent-workiq-maf/main.py): `src/agent-workiq-maf/main.py`
- [Delegated Sign-in](https://github.com/microsoft/ignite26-prel42/blob/main/src/agent-workiq-maf/workiq_auth.py): `src/agent-workiq-maf/workiq_auth.py`
- [Agent Invoker](https://github.com/microsoft/ignite26-prel42/blob/main/src/agent-workiq-maf/invoke.py): `src/agent-workiq-maf/invoke.py`

### Provisioning

- [Work IQ OAuth Setup](https://github.com/microsoft/ignite26-prel42/blob/main/infra/workiq_oauth.py): `infra/workiq_oauth.py`
- [Work IQ Entra Setup](https://github.com/microsoft/ignite26-prel42/blob/main/infra/create-workiq-entra.py): `infra/create-workiq-entra.py`

### Other components

- **Learner**
- **Microsoft Fabric**
- **Azure AI Search**
- **Work IQ MCP**
- **Microsoft Foundry**
- **Microsoft Graph**

## Connections

- Learner → IQ Notebooks: runs labs (evidence: `README.md`)
- Learner → Web IQ Lab: calls endpoints (evidence: `README.md`)
- IQ Notebooks → DIY Lakehouse: creates data (evidence: `README.md`)
- IQ Notebooks → Search Indexes: builds knowledge (evidence: `README.md`)
- IQ Notebooks → Workmate Agent: runs agents (evidence: `README.md`)
- DIY Lakehouse → Microsoft Fabric: loads tables (evidence: `infra/create-lakehouse.py`)
- Analytics Lakehouse → Microsoft Fabric: loads analytics (evidence: `infra/create-web-analytics-lakehouse.py`)
- Analytics Model → Microsoft Fabric: publishes model (evidence: `infra/create-semantic-model.py`)
- Product Graph → DIY Lakehouse: reads lakehouse (evidence: `infra/create-fabric-graph.py`)
- Product Graph → Microsoft Fabric: creates graph (evidence: `infra/create-fabric-graph.py`)
- Fabric Data Agent → Microsoft Fabric: creates agent (evidence: `infra/create-fabric-data-agent.py`)
- Search Indexes → Azure AI Search: creates indexes (evidence: `infra/create-search-indexes.py`)
- Search Indexes → Microsoft Foundry: creates knowledge base (evidence: `infra/create-search-indexes.py`)
- Knowledge Retrieval → Azure AI Search: retrieves context
- Work IQ OAuth Setup → Microsoft Foundry: configures connection (evidence: `infra/workiq_oauth.py`)
- Work IQ OAuth Setup → Microsoft Graph: provisions OAuth (evidence: `infra/workiq_oauth.py`)
- Work IQ Entra Setup → Microsoft Graph: configures permissions (evidence: `infra/create-workiq-entra.py`)
- Agent Invoker → Workmate Agent: posts question (evidence: `src/agent-workiq-maf/invoke.py`)
- Agent Invoker → Delegated Sign-in: gets token (evidence: `src/agent-workiq-maf/invoke.py`)
- Workmate Agent → Delegated Sign-in: acquires token (evidence: `src/agent-workiq-maf/main.py`)
- Workmate Agent → Work IQ MCP: asks MCP (evidence: `src/agent-workiq-maf/main.py`)
- Workmate Agent → Microsoft Foundry: runs hosted (evidence: `README.md`)
