---
title: "labring/tentix: TenTix (10x Efficiency) - An AI native customer service platform with 10x accelerated resolution. Support MCP extension, and AI knowlage base system."
source: "https://github.com/labring/tentix/blob/main/README.zh-CN.md"
author:
- "[[GitHub]]"
published:
created: 2026-03-28
description: "TenTix (10x Efficiency) - An AI native customer service platform with 10x accelerated resolution. Support MCP extension, and AI knowlage base system. - labring/tentix"
tags:
- "clippings"
---
## Tentix = Ten (10x 效率) Tix (工单系统)
[English](https://github.com/labring/tentix/blob/main/README.md) | [中文](https://github.com/labring/tentix/blob/main/README.zh-CN.md)
基于 AI 的客服平台,提供 10 倍加速的解决方案。
- 🚀 10 倍更快的响应速度
- 🤖 10 倍减少人工干预
- 😊 10 倍提升用户满意度
[](https://private-user-images.githubusercontent.com/8912557/450527336-798dbbd3-4b78-4412-bf69-fda27f12d128.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ2OTMzOTEsIm5iZiI6MTc3NDY5MzA5MSwicGF0aCI6Ii84OTEyNTU3LzQ1MDUyNzMzNi03OThkYmJkMy00Yjc4LTQ0MTItYmY2OS1mZGEyN2YxMmQxMjgucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDMyOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjAzMjhUMTAxODExWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MDZjYTE4ZTdlN2JkN2FiMzg4NDgyMzU3NWYwNGEwNGZmYTA1MjZiY2FhMmU5MjQyYzUwYzQ0YmQ2YTQ5MDc5MiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.leixvWjQE3dcnCIgiuzi7KBlXopimsGKMJkZmZasRng)
## 🖥 在 Sealos 上体验
在应用市场一键部署,只需配置一个 ai 客服,一个员工,即可体验。
[](https://bja.sealos.run/?openapp=system-template%3FtemplateName%3Dtentix)
## 目录
## 核心架构
```
graph TD
A[工单数据源] --> B[知识库构建模块]
C[通用文档] --> B
D[收藏对话] --> B
B --> E[统一向量知识库
PostgreSQL + pgvector]
E --> F[LangGraph AI Agent]
G[用户消息] --> H[查询提炼模块]
I[工单信息] --> H
H --> J[知识检索模块]
E --> J
J --> F
F --> K[生成回复]
subgraph "知识来源优先级"
L[1. 收藏对话
权重: 1.0]
M[2. 历史工单
权重: 0.8]
N[3. 通用知识
权重: 0.6]
end
```
```
graph TD
A[开始构建] --> B{选择知识类型}
B -->|收藏对话| C[提取收藏的工单/消息]
B -->|历史工单| D[筛选高质量已解决工单]
B -->|通用知识| E[加载文档文件]
C --> F[AI增强处理
生成摘要和检索词]
D --> G[构建工单文档
提取关键对话]
E --> H[文档分块处理]
F --> I[向量化处理]
G --> I
H --> I
I --> J[存储到统一知识库]
J --> K[完成]
```
## 已实现特性
- 客服聊天系统
- AI 能力(LangGraph 工作流:分析 → 生成查询 → 检索 → 生成答复)
- 多渠道通知推送,飞书已支持,其它 IM/表单可按模块化接入
- 🔧 可扩展架构:模块化设计,支持按需扩展
- 统一认证设计:插拔式配置第三方接口,便于对接第三方系统
- 向量后端:支持 PostgreSQL + pgvector 或外部向量服务切换 (FastGPT)
- Agent 模型配置:在后台预留模型/温度/TopP/最大 Token 等参数位
## 部署要求
- Bun ≥ 1.2.16
- PostgreSQL(支持 pgvector 扩展)
- MinIO(或兼容的对象存储)
- OpenAI/FastGPT 等 AI 服务凭证
## 部署
### 1\. 通过 Dockerfile 构建镜像
```
docker build -t tentix:latest .
```
### 2\. 配置 PostgreSQL 完成数据库同步
> 说明:迁移脚本会读取项目根目录的 `.env.local` ,需要配置 DATABASE\_URL。
```
cd server
bun run migrate
```
### 3\. 配置应用必须的环境变量
- 必需(必须配置):
```
DATABASE_URL="postgres://USER:PASSWORD@HOST:PORT/DB"
# 生成 Base64 加密密钥(在 server 目录执行)
# cd server && bun run script/getCryptoKey.ts
ENCRYPTION_KEY="<上一步生成的Base64密钥>"
# 存储对话中的图片等多媒体
MINIO_ACCESS_KEY=""
MINIO_SECRET_KEY=""
MINIO_BUCKET=""
MINIO_ENDPOINT="" # 例如:http://minio:9000
```
- AI 相关(按需配置):
```
OPENAI_BASE_URL=""
OPENAI_API_KEY=""
SUMMARY_MODEL="<用于摘要的模型名>"
EMBEDDING_MODEL="<用于向量化的模型名>"
CHAT_MODEL="<用于对话的模型名>"
MAX_AI_RESPONSES_PER_TICKET=3 # 单工单 AI 回复次数上限,默认 3
```
- 可选(飞书群聊与员工推送):
```
FEISHU_APP_ID=""
FEISHU_APP_SECRET=""
FEISHU_CHAT_ID=""
APP_URL="<对外可访问的应用地址>"
```
### 5\. 运行容器
```
docker run -d \
--name tentix \
-p 3000:3000 \
--env-file ./.env.local \
tentix:latest
```
- 健康检查: `/health`
- 默认端口: `3000`
## 开发指南
> 开发帮助:可参阅 [DEVELOPMENT\_GUIDE.md](https://github.com/labring/tentix/blob/main/DEVELOPMENT_GUIDE.md) · [server/README.md](https://github.com/labring/tentix/blob/main/server/README.md) · [frontend/README.md](https://github.com/labring/tentix/blob/main/frontend/README.md)
按以下步骤快速启动本地开发环境。
### 克隆与安装
```
git clone https://github.com/labring/tentix.git
cd tentix
bun install
```
### 配置数据库与迁移
> 说明:迁移脚本会读取项目根目录的 `.env.local` ,需要先配置 `DATABASE_URL` 。
你可以在 [Sealos 控制台](https://bja.sealos.run/) 启用一个 PostgreSQL 数据库,Sealos 提供便捷的数据库创建与自带管理工具。
```
# 在项目根目录创建/编辑 .env.local,至少包含:
echo 'DATABASE_URL="postgres://USER:PASSWORD@HOST:PORT/DB"' >> .env.local
# 进入 server 并执行迁移
cd server
bun run migrate
```
完成数据库同步。
### 配置环境变量
```
cp .env.template .env.local
# 按需补全/覆盖 .env.local 中的变量(如 ENCRYPTION_KEY、MINIO_*、OPENAI_* 等)
```
> 提示:如需生成 `ENCRYPTION_KEY` ,在 `server` 下执行 `bun run script/getCryptoKey.ts` ,将结果填写到 `.env.local` 。
### 启动开发环境
```
cd .. # 回到项目根目录(若当前在 server 下)
bun run dev
```
### 常用命令
```
bun run lint
bun run typecheck
bun run format
bun run build
# Dry run build for testing and check build errors
bun run build --dry
# Force build
bun run build --force
```
## 路线图
以下为优先级排序的功能规划,覆盖 Admin 与 客服端 数据面板:
- Admin 功能
- 人员管理面板:修改角色(含客服),管理账号与绑定(Sealos/飞书)
- 知识库索引:新增“通用文档”和“历史工单”的索引能力
- 历史工单索引:支持定时任务(如每 7/14 天)
- 通用文档:上传、解析与结构化抽取,形成统一知识条目
- 知识库命中测试:无需新建工单即可测试检索命中与答复质量
- 知识库图形面板:收藏对话/通用文档/历史工单的索引查看与可视化
- 知识图谱可视化:知识条目、关系与权重的图形化展示
- 提示词定制化:Agent 工作流提示词可视化配置与 A/B 实验
- 工作流编排:将当前固定工作流演进为可编排机器人模式
- 数据分析面板
- 工单分布:按种类的饼图、反馈工单占比(饼图)
- 知识库命中率:趋势与分布
- 工单数量:按时间分布(折线图)
- 工单反馈数据:按时间(折线)与星级占比(饼图)
- 转人工数据:转人工/未转人工/总量对比
- 客服端面板与功能
- 知识库命中测试入口
- 索引管理与可视化查看
- 个人工单指标:
- 分派给自己/参与的/与自己有关的工单量(支持过滤:转人工/未转人工/全部)
- 按模块分布的统计与趋势
Todo 列表(摘要):
- Admin:人员管理与账号绑定(Sealos/飞书)
- Admin:通用文档与历史工单索引(含定时任务)
- Admin:知识库命中测试与图形面板
- Admin:提示词定制化与工作流编排
- 分析:工单分布、命中率、数量与反馈趋势
- 客服端:命中测试与索引可视化;个人指标看板
## 🤝 参与贡献
### 提交代码
1. Fork 本项目到你的 GitHub 账号
2. 创建功能分支: `git checkout -b feature/your-feature`
3. 提交变更: `git commit -m 'feat: your change'`
4. 推送分支: `git push origin feature/your-feature`
5. 发起 Pull Request(PR)
### 提交信息规范
采用 [Conventional Commits](https://www.conventionalcommits.org/) 规范:
```
feat: add new feature
fix: fix bug
docs: update documentation
style: format code
refactor: refactor code
test: add tests
chore: update dependencies
```
### 代码评审
所有代码变更需要通过 Pull Request 进行评审:
- 确保所有测试通过
- 遵循项目的代码规范
- 补充必要的文档与注释
- 更新相关测试用例
## 🆘 支持
如遇到问题或有疑问:
1. 先在 [Issues](https://github.com/labring/tentix/issues) 中搜索是否已有类似问题
2. 新建 Issue 详细描述你的问题
3. 联系项目维护者
---
**祝编码愉快!🎉**