内容
# HR-ASSIST: 智能AI系统用于人力资源自动化
> **一个智能AI系统，能够使用模型上下文协议（MCP）自动完成从入职到排程的人力资源工作流程。**
---
## 概述
**HR-ASSIST** 是一个智能自动化系统，作为 **Codebasics Gen AI Bootcamp** 的一部分而构建。
它将Claude Desktop应用程序转变为一个强大的人力资源助手，能够与本地数据库交互，发送真实的电子邮件，并管理日历。
与标准聊天机器人不同，HR-ASSIST使用 **智能工作流** 来自主执行复杂的多步骤任务。
### 问题
人力资源经理花费数小时在人力资源管理系统软件、电子邮件客户端和工单系统之间切换，以为单个员工办理入职手续。
### 解决方案
一个统一的界面，自然语言转化为行动。
* **输入：** *"将Ruchitha作为数据分析师入职。"*
* **输出：** 员工记录创建 + 欢迎电子邮件发送 + IT工单提出 + 定向会议安排。
---
## 看看它的实际效果
| **1. 智能排程** | **2. 预置提示模板** |
| :---: | :---: |
|  |  |
| *智能体智能解析日期以安排会议。* | *用于结构化数据录入的自定义界面表单。* |
---
## 关键功能
| 功能 | 描述 |
|:---------------------------| :--- |
| **MCP提示** | 用于复杂任务（如入职）的预配置模板（界面表单）。 |
| **人力资源管理系统集成** | 自定义工具执行以搜索、添加和更新员工记录。 |
| **电子邮件自动化** | 自动SMTP集成，通过Gmail发送安全凭证。 |
| **工单管理** | IT设备的自动工单生成。 |
| **智能日历** | 自然语言日期解析用于会议管理。 |
---
## 技术架构
```mermaid
graph TD
User[人力资源经理] -->|选择模板| UI[Claude Desktop UI]
UI -->|MCP协议| Server[HR-Assist Python服务器]
Server -->|写入| DB[(本地人力资源数据库)]
Server -->|发送| SMTP[Gmail API]
Server -->|创建| Ticket[工单系统]
```
### 技术栈
* **语言：** Python 3.10+
* **协议：** 模型上下文协议（MCP）由Anthropic提供
* **依赖管理：** `uv`
* **库：** `fastmcp`, `pydantic`, `python-dotenv`
---
## 仓库结构
```text
atliq-hr-assist/
├── hrms/ # 核心业务逻辑包
│ ├── __init__.py # 包初始化
│ ├── employee_manager.py # 员工CRUD操作
│ ├── leave_manager.py # 休假余额逻辑
│ ├── meeting_manager.py # 日历排程
│ ├── ticket_manager.py # IT支持工单
│ └── schemas.py # Pydantic数据模型
├── images/ # 文档截图
│ ├── demo_onboard.png
│ └── demo_schedule.png
├── server.py # MCP服务器主入口
├── emails.py # SMTP电子邮件处理程序
├── utils.py # 帮助函数（数据播种）
├── .env # 凭证（从仓库中排除）
├── .gitignore # Git忽略规则
├── pyproject.toml # 项目依赖配置
└── uv.lock # 依赖锁定文件（确保可复制性）
```
---
## 设置和安装
1. **克隆仓库**
```bash
git clone [https://github.com/YOUR_USERNAME/hr-assist-mcp-agent.git](https://github.com/YOUR_USERNAME/hr-assist-mcp-agent.git)
cd hr-assist-mcp-agent
```
2. **安装依赖**
```bash
uv init
uv add "mcp[cli]" python-dotenv
```
3. **配置环境**
为您的凭证创建 `.env` 文件：
```env
CB_EMAIL=your_email@gmail.com
CB_EMAIL_PWD=your_app_password
```
4. **连接到Claude**
将服务器路径添加到您的 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"hr-assist": {
"command": "uv",
"args": ["--directory", "ABSOLUTE_PATH", "run", "server.py"],
"env": { "CB_EMAIL": "...", "CB_EMAIL_PWD": "..." }
}
}
}
```
---
## 使用指南
### 方法1：自然语言
只需在聊天栏中输入：
> "为E001员工安排明天上午10点的会议，讨论项目启动。"
### 方法2：MCP提示模板（推荐）
1. 点击 **附件** 按钮或在Claude中输入 `/`。
2. 选择 **`onboard_new_employee`**。
3. 填写表单字段：
* **员工姓名：** `Ruchitha`
* **经理姓名：** `Dhaval`
4. 点击 **运行**。智能代理将自动执行整个工作流程。
---
## 未来改进
* **数据库：** 从内存存储迁移到SQLite/PostgreSQL。
* **前端：** 构建Streamlit仪表盘以查看生成的工单。
* **身份验证：** 添加基于角色的访问控制（RBAC）以进行经理审批。
---
## 📄 许可证
- 作为 **Codebasics Gen AI Bootcamp** 的一部分开发。
- 版权所有 © Codebasics Inc.
