# azure/copilot-studio-and-azure architecture

> Architecture diagram of the GitHub repository azure/copilot-studio-and-azure, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azure/copilot-studio-and-azure
- Repository: https://github.com/azure/copilot-studio-and-azure

## Overview

This repository is a Copilot Studio and Azure solution showcase: its React app introduces the platform and accelerators, while the documented accelerators implement knowledge ingestion/retrieval and voice experiences. The principal SharePoint flow is scoped SharePoint content through queued processing into secured Azure AI Search, then retrieval by a Copilot Studio knowledge topic. Edges for that accelerator and unsampled solutions reflect README claims; implementation-level wiring is shown only where excerpts establish it.

Main entry points: [`accelerators/sharepoint-connector/document_processor.py`](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/document_processor.py) (Document processing), [`accelerators/sharepoint-connector/function_app.py`](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/function_app.py) (Queue processor), [`accelerators/sharepoint-connector/search_client.py`](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/search_client.py) (Search and trimming), [`src/App.tsx`](https://github.com/azure/copilot-studio-and-azure/blob/main/src/App.tsx) (Overview app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_showcase["Solution showcase"]
  node_react_app["Overview app<br/>[App.tsx]"]
  node_react_entry["React entry<br/>[main.tsx]"]
  node_error_ui["Error fallback<br/>[ErrorFallback.tsx]"]
  node_button["Button primitive<br/>[button.tsx]"]
end

subgraph group_sharepoint["SharePoint indexing"]
  node_sharepoint(("SharePoint source"))
  node_dispatcher["File dispatcher<br/>[enqueue_files.py]"]
  node_queue_worker["Queue processor<br/>[function_app.py]"]
  node_document_processing["Document processing"]
  node_chunking["Chunking<br/>[chunker.py]"]
  node_multimodal["Multimodal extraction"]
  node_embeddings["Embeddings"]
  node_indexer["Index writer<br/>[indexer.py]"]
  node_search_index[("AI Search index")]
  node_search_api["Search and trimming<br/>[search_client.py]"]
  node_permissions["Permission filters<br/>[search_security.py]"]
end

subgraph group_knowledge["Knowledge accelerators"]
  node_copilot(("Copilot Studio"))
  node_content_flow["Content Flow"]
  node_agentic_retrieval["Foundry IQ retrieval"]
  node_ai_search_flow["AI Search Flow"]
  node_video_rag["Video RAG"]
  node_content_understanding["Content Understanding"]
  node_visio["Visio conversion<br/>[visio_to_text.py]"]
end

subgraph group_voice["Voice channel"]
  node_voice_ui["Voice web UI<br/>[client.js]"]
  node_voice_server["Voice API<br/>[main.py]"]
  node_voice_relay["Voice relay<br/>[voice_live.py]"]
  node_voice_live["Azure Voice Live"]
  node_foundry_agent["Foundry agent"]
end

node_visitor(("Site visitor"))
node_voice_user(("Voice user"))

node_visitor -->|"views"| node_react_app
node_react_entry -->|"renders"| node_react_app
node_react_entry -->|"uses on failure"| node_error_ui
node_react_app -->|"renders"| node_button
node_sharepoint -.->|"enumerates files"| node_dispatcher
node_dispatcher -.->|"queues files"| node_queue_worker
node_queue_worker -.->|"processes files"| node_document_processing
node_document_processing -.->|"chunks content"| node_chunking
node_document_processing -.->|"extracts content"| node_multimodal
node_document_processing -.->|"creates embeddings"| node_embeddings
node_indexer -.->|"writes documents"| node_search_index
node_queue_worker -.->|"indexes content"| node_indexer
node_copilot -.->|"requests knowledge"| node_search_api
node_search_api -->|"queries"| node_search_index
node_search_api -->|"builds permission filter"| node_permissions
node_search_index -.->|"returns trimmed results"| node_copilot
node_content_flow -.->|"enhances RAG"| node_copilot
node_ai_search_flow -.->|"enables search"| node_copilot
node_video_rag -.->|"grounds answers"| node_search_index
node_content_understanding -.->|"provides extraction"| node_copilot
node_visio -.->|"prepares process text"| node_copilot
node_copilot -.->|"uses retrieval"| node_agentic_retrieval
node_voice_user -.->|"speaks"| node_voice_ui
node_voice_ui -.->|"connects by WebSocket"| node_voice_server
node_voice_server -->|"routes socket"| node_voice_relay
node_voice_relay -->|"relays audio and events"| node_voice_live
node_voice_live -.->|"runs agent mode"| node_foundry_agent
node_foundry_agent -.->|"calls assistant"| node_copilot

click node_react_app "https://github.com/azure/copilot-studio-and-azure/blob/main/src/App.tsx"
click node_react_entry "https://github.com/azure/copilot-studio-and-azure/blob/main/src/main.tsx"
click node_error_ui "https://github.com/azure/copilot-studio-and-azure/blob/main/src/ErrorFallback.tsx"
click node_button "https://github.com/azure/copilot-studio-and-azure/blob/main/src/components/ui/button.tsx"
click node_dispatcher "https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/enqueue_files.py"
click node_queue_worker "https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/function_app.py"
click node_document_processing "https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/document_processor.py"
click node_chunking "https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/chunker.py"
click node_multimodal "https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/content_understanding_client.py"
click node_embeddings "https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/multimodal_embeddings_client.py"
click node_indexer "https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/indexer.py"
click node_search_api "https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/search_client.py"
click node_permissions "https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/search_security.py"
click node_agentic_retrieval "https://github.com/azure/copilot-studio-and-azure/tree/main/labs/2.4-microsoft-foundry-agentic-retrieval"
click node_ai_search_flow "https://github.com/azure/copilot-studio-and-azure/tree/main/accelerators/aisearch"
click node_video_rag "https://github.com/azure/copilot-studio-and-azure/tree/main/accelerators/Video-RAG"
click node_content_understanding "https://github.com/azure/copilot-studio-and-azure/tree/main/accelerators/contentunderstanding"
click node_visio "https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/visio-process-to-text/visio_to_text.py"
click node_voice_ui "https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/voice-channel/server/app/static/client.js"
click node_voice_server "https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/voice-channel/server/app/main.py"
click node_voice_relay "https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/voice-channel/server/app/voice_live.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_react_app,node_react_entry,node_error_ui,node_button,node_voice_user toneBlue
class node_sharepoint,node_dispatcher,node_queue_worker,node_document_processing,node_chunking,node_multimodal,node_embeddings,node_indexer,node_search_index,node_search_api,node_permissions toneAmber
class node_copilot,node_content_flow,node_agentic_retrieval,node_ai_search_flow,node_video_rag,node_content_understanding,node_visio toneMint
class node_voice_ui,node_voice_server,node_voice_relay,node_voice_live,node_foundry_agent toneRose
class node_visitor toneIndigo
```

## Components

### Solution showcase

- [Overview app](https://github.com/azure/copilot-studio-and-azure/blob/main/src/App.tsx): `src/App.tsx`
- [React entry](https://github.com/azure/copilot-studio-and-azure/blob/main/src/main.tsx): `src/main.tsx`
- [Error fallback](https://github.com/azure/copilot-studio-and-azure/blob/main/src/ErrorFallback.tsx): `src/ErrorFallback.tsx`
- [Button primitive](https://github.com/azure/copilot-studio-and-azure/blob/main/src/components/ui/button.tsx): `src/components/ui/button.tsx`

### SharePoint indexing

- **SharePoint source**
- [File dispatcher](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/enqueue_files.py): `accelerators/sharepoint-connector/enqueue_files.py`
- [Queue processor](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/function_app.py): `accelerators/sharepoint-connector/function_app.py`
- [Document processing](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/document_processor.py): `accelerators/sharepoint-connector/document_processor.py`
- [Chunking](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/chunker.py): `accelerators/sharepoint-connector/chunker.py`
- [Multimodal extraction](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/content_understanding_client.py): `accelerators/sharepoint-connector/content_understanding_client.py`
- [Embeddings](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/multimodal_embeddings_client.py): `accelerators/sharepoint-connector/multimodal_embeddings_client.py`
- [Index writer](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/indexer.py): `accelerators/sharepoint-connector/indexer.py`
- **AI Search index**
- [Search and trimming](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/search_client.py): `accelerators/sharepoint-connector/search_client.py`
- [Permission filters](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/sharepoint-connector/search_security.py): `accelerators/sharepoint-connector/search_security.py`

### Knowledge accelerators

- **Copilot Studio**
- **Content Flow**
- [Foundry IQ retrieval](https://github.com/azure/copilot-studio-and-azure/tree/main/labs/2.4-microsoft-foundry-agentic-retrieval): `labs/2.4-microsoft-foundry-agentic-retrieval`
- [AI Search Flow](https://github.com/azure/copilot-studio-and-azure/tree/main/accelerators/aisearch): `accelerators/aisearch`
- [Video RAG](https://github.com/azure/copilot-studio-and-azure/tree/main/accelerators/Video-RAG): `accelerators/Video-RAG`
- [Content Understanding](https://github.com/azure/copilot-studio-and-azure/tree/main/accelerators/contentunderstanding): `accelerators/contentunderstanding`
- [Visio conversion](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/visio-process-to-text/visio_to_text.py): `accelerators/visio-process-to-text/visio_to_text.py`

### Voice channel

- [Voice web UI](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/voice-channel/server/app/static/client.js): `accelerators/voice-channel/server/app/static/client.js`
- [Voice API](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/voice-channel/server/app/main.py): `accelerators/voice-channel/server/app/main.py`
- [Voice relay](https://github.com/azure/copilot-studio-and-azure/blob/main/accelerators/voice-channel/server/app/voice_live.py): `accelerators/voice-channel/server/app/voice_live.py`
- **Azure Voice Live**
- **Foundry agent**

### Other components

- **Site visitor**
- **Voice user**

## Connections

- Site visitor → Overview app: views (evidence: `src/App.tsx`)
- React entry → Overview app: renders (evidence: `src/main.tsx`)
- React entry → Error fallback: uses on failure (evidence: `src/main.tsx`)
- Overview app → Button primitive: renders (evidence: `src/App.tsx`)
- SharePoint source → File dispatcher: enumerates files (evidence: `README.md`)
- File dispatcher → Queue processor: queues files (evidence: `README.md`)
- Queue processor → Document processing: processes files (evidence: `README.md`)
- Document processing → Chunking: chunks content (evidence: `README.md`)
- Document processing → Multimodal extraction: extracts content (evidence: `README.md`)
- Document processing → Embeddings: creates embeddings (evidence: `README.md`)
- Index writer → AI Search index: writes documents (evidence: `README.md`)
- Queue processor → Index writer: indexes content (evidence: `README.md`)
- Copilot Studio → Search and trimming: requests knowledge (evidence: `README.md`)
- Search and trimming → AI Search index: queries (evidence: `accelerators/sharepoint-connector/search_client.py`)
- Search and trimming → Permission filters: builds permission filter (evidence: `accelerators/sharepoint-connector/search_client.py`)
- AI Search index → Copilot Studio: returns trimmed results (evidence: `README.md`)
- Content Flow → Copilot Studio: enhances RAG (evidence: `README.md`)
- AI Search Flow → Copilot Studio: enables search (evidence: `README.md`)
- Video RAG → AI Search index: grounds answers (evidence: `README.md`)
- Content Understanding → Copilot Studio: provides extraction (evidence: `README.md`)
- Visio conversion → Copilot Studio: prepares process text (evidence: `README.md`)
- Copilot Studio → Foundry IQ retrieval: uses retrieval (evidence: `README.md`)
- Voice user → Voice web UI: speaks (evidence: `README.md`)
- Voice web UI → Voice API: connects by WebSocket (evidence: `README.md`)
- Voice API → Voice relay: routes socket (evidence: `accelerators/voice-channel/server/app/main.py`)
- Voice relay → Azure Voice Live: relays audio and events (evidence: `accelerators/voice-channel/server/app/voice_live.py`)
- Azure Voice Live → Foundry agent: runs agent mode (evidence: `README.md`)
- Foundry agent → Copilot Studio: calls assistant (evidence: `README.md`)
