系统设计

AI CodeReview

%%{ init: { 'flowchart': { 'curve': 'basis' } } }%%
flowchart LR
    webhook[gitlab webhook]
    subgraph AI_CodeReview [AI CodeReview]
        event[push or meger request]
        diff[diff text]
        sys_prompt[system prompt]
        result[result & score]
        event --> diff
    end
    
    llm[LLM]
    gitlab_notes[gitlab notes]
    db[database]
    others[others]
    feishu[feishu
...]
    custom[custom]
    
    webhook --> event
    diff --> llm
    sys_prompt --> llm
    llm --> result
    
    result --> gitlab_notes
    result --> db
    result --> others
    result --> feishu
    result --> custom
    
   
    style event fill:#e6f3ff,stroke:#333,stroke-width:2px
    style diff fill:#d4edda,stroke:#333,stroke-width:2px
    style sys_prompt fill:#d4edda,stroke:#333,stroke-width:2px
    style llm fill:#fff3cd,stroke:#333,stroke-width:2px
    style gitlab_notes fill:#f8f9fa,stroke:#333,stroke-width:2px
    style db fill:#f8f9fa,stroke:#333,stroke-width:2px
    style others fill:#f8f9fa,stroke:#333,stroke-width:2px
    style feishu fill:#f8f9ea,stroke:#333,stroke-width:2px
    style custom fill:#f8f9ea,stroke:#333,stroke-width:2px

RAG

%%{ init: { 'flowchart': { 'curve': 'basis' } } }%%
flowchart LR
    %% 样式定义
    classDef blue fill:#e3f2fd,stroke:#1976d2,stroke-width:2px;
    classDef orange fill:#fff3e0,stroke:#f57c00,stroke-width:2px;
    classDef green fill:#e8f5e9,stroke:#388e3c,stroke-width:2px;
    classDef user fill:#e1f5fe,stroke:#0288d1,stroke-width:2px;
    classDef answer fill:#fce4ec,stroke:#c62828,stroke-width:2px;

    subgraph Pre [构建知识库（提问前）]
        direction LR
        text[故障手册] -->|分段| list[片段列表]
        list --> embedding(Embedding模型):::orange
        embedding -->|向量化| vector[向量]
        vector --> vectorDB[(向量数据库)]:::green
    end

%%{ init: { 'flowchart': { 'curve': 'basis' } } }%%
flowchart LR
    %% 样式定义
    classDef blue fill:#e3f2fd,stroke:#1976d2,stroke-width:2px;
    classDef orange fill:#fff3e0,stroke:#f57c00,stroke-width:2px;
    classDef green fill:#e8f5e9,stroke:#388e3c,stroke-width:2px;
    classDef user fill:#e1f5fe,stroke:#0288d1,stroke-width:2px;
    classDef answer fill:#fce4ec,stroke:#c62828,stroke-width:2px;

    subgraph Answer [回答部分（提问后）]
        direction LR
        user((用户))
        embedding(Embedding模型):::orange
        vector[向量]
        vectorDB[(向量数据库)]:::green
        10segment[相关片段]
        reranker(Reranker模型):::orange
        3segment[相关片段]
        llm(LLM模型):::orange
        
        user -->|提问| embedding
        embedding -->|向量化| vector
        vector -->|相似度计算| vectorDB
        embedding~~~3segment
        vectorDB -.->|召回 10个| 10segment
        10segment -->reranker -->|重排 3个| 3segment
        3segment -->|问题+片段| llm
        llm -->|生成答案| user
    end

MCP

%%{ init: { 'flowchart': { 'curve': 'basis' } } }%%
flowchart TB
    %% 样式定义
    classDef plain fill:#fff,stroke:#333,stroke-width:1px;
    classDef lila fill:#e8dff5,stroke:#333,stroke-width:1px;
    classDef orange fill:#ffe6cc,stroke:#333,stroke-width:1px;
    classDef yellow fill:#fff2cc,stroke:#333,stroke-width:1px;
    classDef green fill:#d9ead3,stroke:#333,stroke-width:1px;
    classDef blue fill:#cfe2f3,stroke:#333,stroke-width:1px;
	
    %% 顶部：用户输入
    UserInput[User Input]:::orange

    %% 顶部：System Prompt 模块
    subgraph SystemPrompt [System prompt]
        direction TB
        Instructions[Instructions]:::plain
        ToolDescription[Tool Description]:::blue
    end

    %% 中间层：Message 与 LLM
    Message[Message]:::orange
    LLM[LLM]:::lila

    %% 下半部分：Tool 调用及 MCP Server
    ToolCallJson[Tool call json]:::yellow
    FinalResult[Final Result]:::orange
    ToolCallResult[Tool call result]:::green

    MCPServer[["MCP Server
tool1 / tool2 / tool3 / ..."]]:::plain

    %% 核心连接关系
    UserInput --> Message
    SystemPrompt --> Message
    Message --> LLM
    LLM --> ToolCallJson --> MCPServer
    MCPServer --> ToolCallResult --> LLM
    LLM --> FinalResult

    %% 补充：Tool Description 与 MCP Server 之间的配置关系
    ToolDescription -.-|提供工具结构化文本描述| MCPServer

故障诊断实际场景

%%{ init: { 'flowchart': { 'curve': 'basis' } } }%%
flowchart TB
    %% 样式定义
    classDef input fill:#fff2cc,stroke:#333,stroke-width:1px;
    classDef intent fill:#ffe6cc,stroke:#333,stroke-width:1px;
    classDef knowledgeBase fill:#e2efda,stroke:#333,stroke-width:1px;
    classDef retrieval fill:#e2efda,stroke:#333,stroke-width:1px;
    classDef agent fill:#e2effa,stroke:#333,stroke-width:1px;
    classDef mcp fill:#fce5cd,stroke:#333,stroke-width:1px;
    classDef output fill:#fff2cc,stroke:#333,stroke-width:1px;
    classDef plain fill:#fff,stroke:#333,stroke-width:1px;

    %% --- 顶层 ---
    subgraph InputLayer [输入层]
        direction TB
        UserInput[用户输入]:::input
        API[API]:::input
    end

    %% --- 知识库构建模块 ---
    subgraph KnowledgeConstruction [知识库构建]
        direction LR
        text[专业知识]:::plain 
        object[文件对象]:::plain
        sub_segment[向量化后的段落]:::plain
        vector_segment[向量化后的段落]:::plain
        knowledgeDB[向量化后的段落]:::plain
          
        text -->|预处理| object  -->|切分|sub_segment -->|向量化| vector_segment-->|索引| knowledgeDB
    end

    %% --- 知识检索模块（左侧） ---
    subgraph KRetrievalProcess [知识检索]
        direction LR
        vector_process[向量化处理]:::plain
        topK[知识库匹配TopK]:::plain
        reranker[Reranker重排序]:::plain
    end
    
    %% --- MCP Server 模块 ---
    subgraph MCPServer [MCP Server]
    end
    
   Intent[意图识别]:::intent
   DiagKnowledgeRetrieval_1[知识检索]:::retrieval
   AgentNode[Agent
规划-执行-观测]:::agent
   DiagKnowledgeRetrieval_2[知识检索]:::retrieval
   KResult[返回答案]:::output
   DiagResult[返回诊断结论]:::output
   
   InputLayer --> Intent
   Intent -->|知识问答| vector_process
   Intent -->|诊断操作| DiagKnowledgeRetrieval_1
   DiagKnowledgeRetrieval_1 --> AgentNode
   AgentNode -->|提取关键字| DiagKnowledgeRetrieval_2
   DiagKnowledgeRetrieval_2-->DiagResult
   
   knowledgeDB --> topK
   reranker--> KResult
   AgentNode <--> MCPServer

参考阅读

Vonng/ddia: 《Designing Data-Intensive Application》DDIA中文翻译

架构案例