内容
# 🤖 Jarvis 数字孪生
一款智能、适用于生产的 AI 数字孪生，结合 **自主 AI**、**检索增强生成 (RAG)** 和 **模型上下文协议 (MCP)**，提供知识检索和现实任务执行。
与传统聊天机器人不同，Jarvis 可以回答关于我的职业作品集的问题，执行诸如安排会议和发送电子邮件等操作，并智能地通过专用的 AI 管道路由请求。
---
## ✨ 功能特点
* 🧠 **自主路由**，用于智能意图分类
* 📚 **高级 RAG 管道**，由 Pinecone 和 Gemini 提供支持
* ⚡ **混合检索**（语义 + 关键词搜索）
* 🎯 **LLM 重新排序**，用于高度相关的响应
* 📅 **谷歌日历集成**
* 📧 **Gmail 集成**
* 🔐 **谷歌 OAuth 身份验证**
* 👥 **基于角色的访问控制 (RBAC)**
* 🔧 **模型上下文协议 (MCP)**
* 🚀 **生产就绪架构**
---
# 🏗️ 系统架构
```
用户
│
▼
Express 后端
│
▼
自主路由
(OpenAI GPT-4o)
┌───────────┴───────────┐
│ │
▼ ▼
检索管道 操作管道
(Gemini RAG) (MCP 代理)
│ │
▼ ▼
Pinecone DB 谷歌服务
│
┌──────────────┴──────────────┐
▼ ▼
谷歌日历 Gmail API
```
---
# 🧠 请求流程
每个传入的请求在执行前由 **路由代理** 分类。
### 知识查询
示例：
* 告诉我关于你的项目。
* 解释 Agentic-CX。
* 你知道哪些技术？
流程
```
用户
│
▼
路由代理
│
▼
RAG 管道
│
▼
Gemini 嵌入
│
▼
Pinecone
│
▼
Gemini Flash
│
▼
响应
```
---
### 操作请求
示例：
* 预订会议
* 取消明天的约会
* 发送电子邮件
流程
```
用户
│
▼
路由代理
│
▼
操作管道
│
▼
RBAC
│
▼
OpenAI 代理
│
▼
MCP 服务器
│
▼
谷歌 API
```
---
# 🔍 高级检索管道
检索系统设计用于生产级准确性。
功能包括：
* 混合搜索
* 语义向量搜索
* 动态 Top-K 检索
* 元数据过滤
* 查询重写
* 多查询检索
* 上下文扩展
* 父子检索
* LLM 重新排序
* 上下文压缩
* 引用跟踪
---
# 🔐 身份验证和授权
身份验证由 **谷歌 OAuth** 提供支持。
支持两种用户角色：
### 访问者
* 查询知识库
* 检查日历可用性
* 预订约会
### 管理员
* 完整日历访问权限
* 查看约会
* 取消约会
* 阻止日历时间段
* 管理 MCP 工具
---
# 🛠️ 技术栈
## 前端
* React 18
* TypeScript
* Vite
* Tailwind CSS
* Framer Motion
* React Three Fiber
* Three.js
## 后端
* Node.js
* Express.js
* Prisma ORM
* PostgreSQL
* Pinecone
* OpenAI
* 谷歌 Gemini
* LangChain
* 模型上下文协议 (MCP)
---
# 📁 项目结构
```
frontend/
backend/
architecture/
├── rag-pipeline.md
├── agentic-router.md
├── mcp-server.md
└── auth-and-roles.md
```
---
# 📖 架构文档
每个子系统的详细文档可在 **architecture** 目录中找到。
* 📘 RAG 管道
* 📗 自主路由
* 📙 MCP 服务器
* 📕 身份验证和 RBAC
---
# 🚀 主要亮点
* 生产级自主 AI 架构
* 独立的路由、RAG 和操作管道
* 高级检索增强生成
* 安全的谷歌 OAuth 身份验证
* 实时日历和 Gmail 集成
* 模块化和可扩展的后端设计
* 企业级项目结构
本项目仅用于教育和作品集目的。
