# jinguanghui123/ai-agent-platform architecture

> Architecture diagram of the GitHub repository jinguanghui123/ai-agent-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jinguanghui123/ai-agent-platform
- Repository: https://github.com/jinguanghui123/ai-agent-platform

## Overview

这是一个面向个人与团队的 AI Agent 平台：用户注册或登录后，可进行多模型对话、管理历史，并通过 Agent 工作流完成协作任务；知识库文档可供检索增强生成使用。平台还提供自定义模型、用量统计及企业管理能力。图中保留了 README 记载但未采样实现的功能分支；这些分支之间只在路由注册或文档明确支持时连线，未采样模块的内部调用不作推断。

Main entry points: [`server/app/main.py`](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/main.py) (FastAPI 应用), [`server/app/core/database.py`](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/core/database.py) (关系数据库), [`server/app/services/model_gateway.py`](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/model_gateway.py) (模型网关), [`server/app/services/knowledge_service.py`](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/knowledge_service.py) (知识处理与检索)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["用户界面"]
  node_web_app["Web 应用<br/>[App.vue]"]
  node_chat_view["对话界面<br/>[Chat.vue]"]
  node_agent_view["Agent 工作台<br/>[AgentChat.vue]"]
  node_knowledge_view["知识库界面<br/>[Knowledge.vue]"]
end

subgraph group_identity["身份与企业管理"]
  node_auth_api["认证 API<br/>[auth.py]"]
  node_security["身份安全<br/>[security.py]"]
  node_team_api["团队 API<br/>[team.py]"]
  node_sso_api["SSO API<br/>[sso.py]"]
  node_audit_api["审计 API<br/>[audit.py]"]
  node_admin_api["管理 API<br/>[admin.py]"]
  node_team_service["团队服务<br/>[team_service.py]"]
end

subgraph group_conversation["对话与模型"]
  node_chat_api["对话 API<br/>[chat.py]"]
  node_model_api["模型 API<br/>[model.py]"]
  node_model_gateway["模型网关<br/>[model_gateway.py]"]
  node_user_model_service["用户模型配置"]
end

subgraph group_agents_knowledge["Agent 与知识库"]
  node_agent_api["Agent API<br/>[agent.py]"]
  node_agent_service["Agent 编排<br/>[agent_service.py]"]
  node_workflow_api["工作流模板 API"]
  node_knowledge_api["知识库 API<br/>[knowledge.py]"]
  node_knowledge_service["知识处理与检索"]
  node_document_processor["文档解析分块"]
end

subgraph group_platform["平台数据与集成"]
  node_file_storage["文件存储<br/>[file_storage.py]"]
  node_usage_api["用量 API<br/>[usage.py]"]
  node_feishu_api["飞书 API<br/>[feishu.py]"]
  node_database[("关系数据库<br/>[database.py]")]
  node_application["FastAPI 应用<br/>[main.py]"]
end

node_user(("用户"))
node_model_providers{{"模型服务商"}}

node_user -->|"使用"| node_web_app
node_web_app -.->|"呈现"| node_chat_view
node_web_app -.->|"呈现"| node_agent_view
node_web_app -.->|"呈现"| node_knowledge_view
node_application -->|"注册路由"| node_auth_api
node_application -->|"注册路由"| node_chat_api
node_application -->|"注册路由"| node_model_api
node_application -->|"注册路由"| node_agent_api
node_application -->|"注册路由"| node_workflow_api
node_application -->|"注册路由"| node_knowledge_api
node_application -->|"注册路由"| node_team_api
node_application -->|"注册路由"| node_sso_api
node_application -->|"注册路由"| node_audit_api
node_application -->|"注册路由"| node_admin_api
node_application -->|"注册路由"| node_usage_api
node_application -->|"注册路由"| node_feishu_api
node_auth_api -->|"验证凭据"| node_security
node_auth_api -->|"读写用户"| node_database
node_chat_api -->|"请求生成"| node_model_gateway
node_chat_api -->|"读写会话"| node_database
node_model_api -->|"管理模型"| node_user_model_service
node_model_api -->|"探测模型"| node_model_gateway
node_model_gateway -->|"解析凭据"| node_user_model_service
node_model_gateway -.->|"调用模型"| node_model_providers
node_agent_api -->|"执行编排"| node_agent_service
node_agent_service -->|"调用模型"| node_model_gateway
node_agent_service -->|"检索上下文"| node_knowledge_service
node_agent_service -->|"保存工作流"| node_database
node_workflow_api -.->|"访问模板"| node_database
node_knowledge_api -->|"处理请求"| node_knowledge_service
node_knowledge_service -->|"解析分块"| node_document_processor
node_knowledge_service -->|"存取文件"| node_file_storage
node_knowledge_service -.->|"读写文档块"| node_database
node_team_api -.->|"管理团队"| node_team_service
node_team_service -.->|"访问团队数据"| node_database
node_sso_api -.->|"关联账户"| node_database
node_audit_api -->|"读取审计记录"| node_database
node_audit_api -->|"查询团队"| node_team_service
node_admin_api -->|"管理账户"| node_database
node_admin_api -.->|"记录审计"| node_audit_api
node_usage_api -.->|"聚合用量"| node_database
node_feishu_api -->|"请求模型"| node_model_gateway

click node_web_app "https://github.com/jinguanghui123/ai-agent-platform/blob/master/web/src/App.vue"
click node_chat_view "https://github.com/jinguanghui123/ai-agent-platform/blob/master/web/src/views/Chat.vue"
click node_agent_view "https://github.com/jinguanghui123/ai-agent-platform/blob/master/web/src/views/AgentChat.vue"
click node_knowledge_view "https://github.com/jinguanghui123/ai-agent-platform/blob/master/web/src/views/Knowledge.vue"
click node_auth_api "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/auth.py"
click node_security "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/core/security.py"
click node_team_api "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/team.py"
click node_sso_api "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/sso.py"
click node_audit_api "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/audit.py"
click node_admin_api "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/admin.py"
click node_chat_api "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/chat.py"
click node_model_api "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/model.py"
click node_model_gateway "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/model_gateway.py"
click node_agent_api "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/agent.py"
click node_agent_service "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/agent_service.py"
click node_workflow_api "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/workflow_template.py"
click node_knowledge_api "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/knowledge.py"
click node_knowledge_service "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/knowledge_service.py"
click node_document_processor "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/document_processor.py"
click node_file_storage "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/file_storage.py"
click node_user_model_service "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/user_model_service.py"
click node_team_service "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/team_service.py"
click node_usage_api "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/usage.py"
click node_feishu_api "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/feishu.py"
click node_database "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/core/database.py"
click node_application "https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/main.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_web_app,node_chat_view,node_agent_view,node_knowledge_view toneBlue
class node_auth_api,node_security,node_team_api,node_sso_api,node_audit_api,node_admin_api,node_team_service toneAmber
class node_chat_api,node_model_api,node_model_gateway,node_user_model_service toneMint
class node_agent_api,node_agent_service,node_workflow_api,node_knowledge_api,node_knowledge_service,node_document_processor toneRose
class node_file_storage,node_usage_api,node_feishu_api,node_database,node_application,node_user,node_model_providers toneIndigo
```

## Components

### 用户界面

- [Web 应用](https://github.com/jinguanghui123/ai-agent-platform/blob/master/web/src/App.vue): `web/src/App.vue`
- [对话界面](https://github.com/jinguanghui123/ai-agent-platform/blob/master/web/src/views/Chat.vue): `web/src/views/Chat.vue`
- [Agent 工作台](https://github.com/jinguanghui123/ai-agent-platform/blob/master/web/src/views/AgentChat.vue): `web/src/views/AgentChat.vue`
- [知识库界面](https://github.com/jinguanghui123/ai-agent-platform/blob/master/web/src/views/Knowledge.vue): `web/src/views/Knowledge.vue`

### 身份与企业管理

- [认证 API](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/auth.py): `server/app/api/v1/auth.py`
- [身份安全](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/core/security.py): `server/app/core/security.py`
- [团队 API](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/team.py): `server/app/api/v1/team.py`
- [SSO API](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/sso.py): `server/app/api/v1/sso.py`
- [审计 API](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/audit.py): `server/app/api/v1/audit.py`
- [管理 API](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/admin.py): `server/app/api/v1/admin.py`
- [团队服务](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/team_service.py): `server/app/services/team_service.py`

### 对话与模型

- [对话 API](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/chat.py): `server/app/api/v1/chat.py`
- [模型 API](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/model.py): `server/app/api/v1/model.py`
- [模型网关](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/model_gateway.py): `server/app/services/model_gateway.py`
- [用户模型配置](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/user_model_service.py): `server/app/services/user_model_service.py`

### Agent 与知识库

- [Agent API](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/agent.py): `server/app/api/v1/agent.py`
- [Agent 编排](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/agent_service.py): `server/app/services/agent_service.py`
- [工作流模板 API](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/workflow_template.py): `server/app/api/v1/workflow_template.py`
- [知识库 API](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/knowledge.py): `server/app/api/v1/knowledge.py`
- [知识处理与检索](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/knowledge_service.py): `server/app/services/knowledge_service.py`
- [文档解析分块](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/document_processor.py): `server/app/services/document_processor.py`

### 平台数据与集成

- [文件存储](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/services/file_storage.py): `server/app/services/file_storage.py`
- [用量 API](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/usage.py): `server/app/api/v1/usage.py`
- [飞书 API](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/api/v1/feishu.py): `server/app/api/v1/feishu.py`
- [关系数据库](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/core/database.py): `server/app/core/database.py`
- [FastAPI 应用](https://github.com/jinguanghui123/ai-agent-platform/blob/master/server/app/main.py): `server/app/main.py`

### Other components

- **用户**
- **模型服务商**

## Connections

- 用户 → Web 应用: 使用 (evidence: `README.md`)
- Web 应用 → 对话界面: 呈现
- Web 应用 → Agent 工作台: 呈现
- Web 应用 → 知识库界面: 呈现
- FastAPI 应用 → 认证 API: 注册路由 (evidence: `server/app/main.py`)
- FastAPI 应用 → 对话 API: 注册路由 (evidence: `server/app/main.py`)
- FastAPI 应用 → 模型 API: 注册路由 (evidence: `server/app/main.py`)
- FastAPI 应用 → Agent API: 注册路由 (evidence: `server/app/main.py`)
- FastAPI 应用 → 工作流模板 API: 注册路由 (evidence: `server/app/main.py`)
- FastAPI 应用 → 知识库 API: 注册路由 (evidence: `server/app/main.py`)
- FastAPI 应用 → 团队 API: 注册路由 (evidence: `server/app/main.py`)
- FastAPI 应用 → SSO API: 注册路由 (evidence: `server/app/main.py`)
- FastAPI 应用 → 审计 API: 注册路由 (evidence: `server/app/main.py`)
- FastAPI 应用 → 管理 API: 注册路由 (evidence: `server/app/main.py`)
- FastAPI 应用 → 用量 API: 注册路由 (evidence: `server/app/main.py`)
- FastAPI 应用 → 飞书 API: 注册路由 (evidence: `server/app/main.py`)
- 认证 API → 身份安全: 验证凭据 (evidence: `server/app/api/v1/auth.py`)
- 认证 API → 关系数据库: 读写用户 (evidence: `server/app/api/v1/auth.py`)
- 对话 API → 模型网关: 请求生成 (evidence: `server/app/api/v1/chat.py`)
- 对话 API → 关系数据库: 读写会话 (evidence: `server/app/api/v1/chat.py`)
- 模型 API → 用户模型配置: 管理模型 (evidence: `server/app/api/v1/model.py`)
- 模型 API → 模型网关: 探测模型 (evidence: `server/app/api/v1/model.py`)
- 模型网关 → 用户模型配置: 解析凭据 (evidence: `server/app/services/model_gateway.py`)
- 模型网关 → 模型服务商: 调用模型
- Agent API → Agent 编排: 执行编排 (evidence: `server/app/api/v1/agent.py`)
- Agent 编排 → 模型网关: 调用模型 (evidence: `server/app/services/agent_service.py`)
- Agent 编排 → 知识处理与检索: 检索上下文 (evidence: `server/app/services/agent_service.py`)
- Agent 编排 → 关系数据库: 保存工作流 (evidence: `server/app/services/agent_service.py`)
- 工作流模板 API → 关系数据库: 访问模板
- 知识库 API → 知识处理与检索: 处理请求 (evidence: `server/app/api/v1/knowledge.py`)
- 知识处理与检索 → 文档解析分块: 解析分块 (evidence: `server/app/services/knowledge_service.py`)
- 知识处理与检索 → 文件存储: 存取文件 (evidence: `server/app/services/knowledge_service.py`)
- 知识处理与检索 → 关系数据库: 读写文档块
- 团队 API → 团队服务: 管理团队
- 团队服务 → 关系数据库: 访问团队数据
- SSO API → 关系数据库: 关联账户
- 审计 API → 关系数据库: 读取审计记录 (evidence: `server/app/api/v1/audit.py`)
- 审计 API → 团队服务: 查询团队 (evidence: `server/app/api/v1/audit.py`)
- 管理 API → 关系数据库: 管理账户 (evidence: `server/app/api/v1/admin.py`)
- 管理 API → 审计 API: 记录审计
- 用量 API → 关系数据库: 聚合用量
- 飞书 API → 模型网关: 请求模型 (evidence: `server/app/api/v1/feishu.py`)
