# azure/azure-search-vector-samples architecture

> Architecture diagram of the GitHub repository azure/azure-search-vector-samples, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azure/azure-search-vector-samples
- Repository: https://github.com/azure/azure-search-vector-samples

## Overview

##### Core Services Layer
- Azure AI Search (central component)
- Azure OpenAI Service (for embeddings)
- Azure AI Vision (for image processing)
- Azure Storage (for document storage)

##### Language Implementation Layer
- Python Implementation
- .NET Implementation
- Java Implementation
- JavaScript Implementation

##### Feature Categories Layer
- Vector Indexing
- Vector Queries
- Integrated Data Chunking
- Integrated Embedding
- Index Projections
- Vectorizers
- Scalar Quantization

##### Integration Components
- Community Frameworks (LangChain, LlamaIndex, Hugging Face)
- Custom Vectorizers
- Data Processing Pipeline

##### Component Grouping
- Separate GA and Preview features visually

##### Data Flow Paths
- Document ingestion → Vector Processing → Index Storage
- Query Processing → Vector Generation → Search Execution
- Custom Vectorization Workflows

##### Integration Points
- Azure OpenAI Service connections for embedding generation
- Storage account interactions for document management
- Community framework integrations

##### Cross-Component Features
- Shared vector storage mechanisms
- Common API endpoints
- Unified search capabilities

Additional Considerations:

##### Metadata Sections
- Supported API versions
- SDK compatibility
- Feature availability matrix

##### Implementation Details
- Sample workflow paths
- Different vector search algorithms
- Quantization options

## Diagram (Mermaid)

```mermaid
graph TB
    %% Core Services Layer
    subgraph CoreServices
        AzureSearch[Azure AI Search]:::core
        AzureOpenAI[Azure OpenAI Service]:::core
        AzureVision[Azure AI Vision]:::core
        AzureStorage[Azure Storage]:::core
    end

    %% Feature Categories Layer
    subgraph Features
        VectorOps[Vector Operations]:::feature
        DataChunking[Data Chunking]:::feature
        IntegratedVec[Integrated Vectorization]:::feature
        VectorQuant[Vector Quantization]:::preview
        CustomVec[Custom Vectorizers]:::feature
    end

    %% Community Frameworks Layer
    subgraph Frameworks
        LangChain[LangChain]:::framework
        LlamaIndex[LlamaIndex]:::framework
        HuggingFace[Hugging Face]:::framework
        Cohere[Cohere]:::framework
    end

    %% Language Implementation Layer
    subgraph Implementations
        Python[Python Implementation]:::lang
        DotNet[.NET Implementation]:::lang
        Java[Java Implementation]:::lang
        JavaScript[JavaScript Implementation]:::lang
    end

    %% Infrastructure Components
    subgraph Infrastructure
        SearchServices[Search Services]:::infra
        StorageServices[Storage Services]:::infra
        Security[Security]:::infra
        Monitoring[Monitoring]:::infra
    end

    %% Data Processing Layer
    subgraph DataProcessing
        IndexOps[Index Operations]:::data
        Indexers[Indexers]:::data
        Evaluation[Ragas Evaluation]:::data
    end

    %% Relationships
    AzureSearch --> VectorOps
    AzureOpenAI --> IntegratedVec
    AzureVision --> CustomVec
    AzureStorage --> StorageServices

    VectorOps --> Python
    VectorOps --> DotNet
    VectorOps --> Java
    VectorOps --> JavaScript

    IntegratedVec --> LangChain
    IntegratedVec --> LlamaIndex
    IntegratedVec --> HuggingFace
    IntegratedVec --> Cohere

    %% Click Events
    click Python "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/"
    click DotNet "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-dotnet/"
    click Java "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-java/"
    click JavaScript "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-javascript/"
    click VectorOps "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/basic-vector-workflow/"
    click DataChunking "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/data-chunking/"
    click IntegratedVec "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/integrated-vectorization/"
    click VectorQuant "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/vector-quantization-and-storage/"
    click CustomVec "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/custom-vectorizer/"
    click LangChain "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/community-integration/langchain/"
    click LlamaIndex "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/community-integration/llamaindex/"
    click HuggingFace "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/community-integration/hugging-face/"
    click Cohere "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/community-integration/cohere/"
    click SearchServices "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/custom-vectorizer/infra/core/search/"
    click StorageServices "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/custom-vectorizer/infra/core/storage/"
    click Security "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/custom-vectorizer/infra/core/security/"
    click Monitoring "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/custom-vectorizer/infra/core/monitor/"
    click IndexOps "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/index-backup-restore/"
    click Indexers "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/indexers/"
    click Evaluation "https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/evals/ragas/"

    %% Styling
    classDef core fill:#1f77b4,stroke:#333,stroke-width:2px
    classDef feature fill:#2ca02c,stroke:#333,stroke-width:2px
    classDef preview fill:#ff7f0e,stroke:#333,stroke-width:2px
    classDef framework fill:#7f7f7f,stroke:#333,stroke-width:2px
    classDef lang fill:#9467bd,stroke:#333,stroke-width:2px
    classDef infra fill:#8c564b,stroke:#333,stroke-width:2px
    classDef data fill:#e377c2,stroke:#333,stroke-width:2px
```
