# workAgent
**Repository Path**: marching-ants_admin_admin/work-agent
## Basic Information
- **Project Name**: workAgent
- **Description**: workAgent是一个依附于企业微信来运行的无人值守群管理机器人程序，workAgent。您可以使用本应用程序来自动执行一个自己企业微信里的账号（当做机器人账号），并可通过后台调用对应的 API 来驱动机器人自动执行任务，如收发消息、自动应答、自动建群、拉人踢人等，不需要root，适用99%的Android手机。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-09
- **Last Updated**: 2026-05-09
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# FlowAgent - 企业微信自动化与 AI 客服中台
FlowAgent 是一套面向企业微信私域运营场景的自动化助手系统，包含 Android 自动化客户端、Python FastAPI 后端服务、Vue 管理后台与 LangGraph AI Agent 能力。系统通过 WebSocket 长连接连接移动端与服务端，可用于消息接收、自动回复、规则引擎、客户跟进、内容管理和智能客服等业务场景。
## 界面预览
## 项目亮点
- **企业微信自动化**：基于 Android Accessibility Service 实现消息监听、会话操作和指令执行
- **实时通信链路**：Android 客户端通过 WebSocket 与服务端保持长连接
- **规则引擎**：支持关键词、正则、固定话术、AI 回复和 Agent 回复
- **AI 智能客服**：集成 LangGraph / LangChain，可扩展记忆检索、知识库检索和意图识别
- **管理后台**：提供机器人、消息、规则、客户、内容、跟进、监控等管理能力
- **多模块架构**：移动端、后端、前端分层清晰，适合二次开发和私有化部署
## 适用场景
- 企业微信私域客户消息自动化处理
- 销售线索收集、分配与跟进提醒
- 客户标签、客户画像和会话记录管理
- 固定话术、活动内容、SOP 触达管理
- AI 客服、知识库问答、智能意图识别
- 机器人中台、RPA 自动化、客服工作台原型验证
## 技术栈
### Android 客户端
- Kotlin / Java
- Android Accessibility Service
- WebSocket 长连接
- Material Design
### 后端服务
- Python 3
- FastAPI + Uvicorn
- MySQL + SQLAlchemy ORM
- WebSocket
- LangGraph + LangChain
- OpenAI Compatible API
### 管理后台
- Vue 3
- Vite
- REST API
## 系统架构
```text
┌────────────────────┐
│ 企业微信 Android │
└─────────┬──────────┘
│ Accessibility Service
┌─────────▼──────────┐
│ FlowAgent Android │
│ 自动化客户端 │
└─────────┬──────────┘
│ WebSocket
┌─────────▼──────────┐
│ FastAPI Server │
│ 消息 / 规则 / AI │
└─────────┬──────────┘
│ REST API
┌─────────▼──────────┐
│ Vue Admin Console │
│ 管理后台 │
└────────────────────┘
```
## 核心功能
### 机器人连接管理
- 机器人在线状态维护
- WebSocket 心跳保活
- 多机器人接入
- 连接监控与状态展示
### 消息处理
- 企业微信消息接收
- 消息历史存储
- 消息去重
- 文本、图片等消息类型扩展
- 回调与指令下发
### 自动回复规则
- 关键词匹配
- 正则匹配
- 固定内容回复
- AI 智能回复
- Agent 工作流回复
### AI Agent
- 意图识别
- 记忆检索
- 知识库检索
- 决策生成
- 多模型兼容
### 客户与运营
- 客户资料管理
- 客户标签
- 线索管理
- 跟进记录
- 活动与内容管理
- 转化数据看板
## 目录结构
```text
.
├── app/ # Android 自动化客户端
│ └── src/main/java/ # Kotlin / Java 核心代码
├── worktool-server/ # 后端服务与管理后台
│ ├── main.py # FastAPI 入口
│ ├── config.py # 配置管理
│ ├── database.py # 数据库连接
│ ├── models.py # SQLAlchemy 模型
│ ├── routers/ # API / WebSocket 路由
│ ├── services/ # 业务服务
│ ├── agent/ # LangGraph Agent
│ ├── frontend/ # Vue 3 管理后台
│ └── requirements.txt # Python 依赖
├── WEBSOCKET_API.md # WebSocket 协议说明
└── README.md # 项目说明
```
## 快速开始
### 1. 启动后端服务
```bash
cd worktool-server
pip install -r requirements.txt
cp .env.example .env
python main.py
```
服务启动后默认访问：
- API 文档：`http://localhost:8084/docs`
- 管理后台：`http://localhost:8084`
- 健康检查：`http://localhost:8084/health`
### 2. 编译 Android 客户端
环境要求：
- JDK 17
- Android Studio
- Android 设备或模拟器
```bash
JAVA_HOME=$(brew --prefix openjdk@17)/libexec/openjdk.jdk/Contents/Home ./gradlew assembleDebug
```
### 3. 配置客户端连接
在 Android 客户端中配置服务端 WebSocket 地址：
```text
ws://{server_host}/webserver/wework/{robot_id}
```
连接成功后，服务端即可接收客户端上报的企业微信消息，并根据规则或 AI Agent 返回自动化指令。
## 环境变量
后端配置通过 `.env` 管理，常见配置包括：
```env
DATABASE_URL=mysql+pymysql://user:password@host:3306/database
CALLBACK_BASE_URL=http://localhost:8084
DASHSCOPE_API_KEY=
DIFY_BASE_URL=
DIFY_API_KEY=
```
请勿将真实数据库密码、API Key 或生产环境配置提交到公开仓库。
## API 能力
- `GET /health`：服务健康检查
- `/api/robots/*`：机器人管理
- `/api/messages/*`：消息查询
- `/api/rules/*`：自动回复规则
- `/api/ai/*`：AI 配置管理
- `/api/agent/*`：Agent 配置
- `/webserver/wework/{robot_id}`：Android 客户端 WebSocket 接入
## 商业合作
如果你正在寻找企业微信自动化、AI 客服、私域运营中台、RPA 自动化或智能销售助手相关解决方案，可以基于本项目进行二次开发、私有化部署或业务定制。
欢迎通过 Issue、Discussion 或下方二维码交流需求。
## 免责声明
本项目仅用于技术研究、自动化测试和企业内部效率工具建设。使用者应遵守所在地区法律法规、企业微信平台规则及相关服务协议。因不当使用造成的风险由使用者自行承担。
## License
Apache License 2.0