Skip to content

Z5Research/def-core

Repository files navigation

DEF - Digital Employee Framework

企业级数字员工框架

License Python Version Status

English | 日本語 | 文档


📖 简介

DEF (Digital Employee Framework) 是一个企业级数字员工框架,支持复杂任务、多角色协作、长期记忆和全渠道部署。

数字员工 = 角色定义 + 技能系统 + 长期记忆 + 多 Agent 协作 + 企业集成

DEF 基于 6 大主流 AI Agent 框架的核心优势设计,为企业提供完整的数字员工解决方案。


💜 AI 领导力理念

DEF 框架融合了《AI 领导力》(刘言午著)的核心理念,以**"善用 AI,人人受益"**为核心价值观:

理念 DEF 实现
🎯 善用 AI,人人受益 让每个组织都能享受 AI 红利
🤝 人机共融 数字员工与人类员工协同工作
📚 道法术器 四层架构设计理念(价值观→方法论→技能→工具)
🔄 持续进化 AI 领导力飞轮的学习机制
👥 领导 AI+ 人才 从领导人才到领导数字员工的转变

推荐阅读: 《AI 领导力》深度研究 | 整合方案


✨ 核心特性

特性 说明
🎭 角色化 每个数字员工有明确岗位职责,支持 HR、销售、客服、技术等多种角色
🛠️ 技能系统 三层技能架构(原子→组合→领域),可组合、可复用、可扩展
🧠 四层记忆 工作记忆→情景记忆→语义记忆→程序记忆,跨会话知识沉淀
🤝 团队协作 多员工协同完成复杂任务,自动任务分配与结果整合
🌐 全渠道 微信、钉钉、飞书、Slack、邮件、WebChat 统一接入
🔒 企业集成 CRM/ERP 系统对接,RBAC 权限管理,完整审计日志
🏠 本地优先 敏感数据本地处理,支持私有化部署

🏗️ 架构设计

┌─────────────────────────────────────────────────────────────────┐
│                    Digital Employee Framework                     │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────────────────────────────────────────────────────┐ │
│  │                  Employee Layer (员工层)                      │ │
│  │  ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐   │ │
│  │  │  HR 助手   │ │ 销售助手  │ │ 客服助手  │ │ 技术助手  │   │ │
│  │  └───────────┘ └───────────┘ └───────────┘ └───────────┘   │ │
│  └─────────────────────────────────────────────────────────────┘ │
│                              │                                    │
│  ┌─────────────────────────────────────────────────────────────┐ │
│  │                  Team Layer (团队编排层)                      │ │
│  │  ┌───────────────────────────────────────────────────────┐  │ │
│  │  │              Team Orchestrator (团队协调器)              │  │ │
│  │  │  - 任务分解  - 员工分配  - 结果整合  - 冲突解决        │  │ │
│  │  └───────────────────────────────────────────────────────┘  │ │
│  └─────────────────────────────────────────────────────────────┘ │
│                              │                                    │
│  ┌─────────────────────────────────────────────────────────────┐ │
│  │                  Core Layer (核心能力层)                      │ │
│  │  ┌───────────┬───────────┬───────────┬───────────┐         │ │
│  │  │  Skills   │  Memory   │   Tools   │  Channels │         │ │
│  │  │  技能系统  │  记忆系统  │  工具集    │  渠道网关  │         │ │
│  │  └───────────┴───────────┴───────────┴───────────┘         │ │
│  └─────────────────────────────────────────────────────────────┘ │
│                              │                                    │
│  ┌─────────────────────────────────────────────────────────────┐ │
│  │                Infrastructure Layer (基础设施层)               │ │
│  │  ┌───────────┬───────────┬───────────┬───────────┐         │ │
│  │  │  Sandbox  │   Vector  │   SQLite  │   Redis   │         │ │
│  │  │  沙箱     │   DB      │  数据库    │  缓存     │         │ │
│  │  └───────────┴───────────┴───────────┴───────────┘         │ │
│  └─────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘

🚀 快速开始

安装

# 克隆项目
git clone https://github.com/Z5Research/def-core.git
cd def-core

# 安装依赖
pip install -e .

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件,填入必要的 API 密钥

基础示例

from def_core import Employee, Team, SkillRegistry

# 创建技能注册表
registry = SkillRegistry()

# 定义数字员工
sales_agent = Employee(
    id="emp-001",
    name="销售助手 - 小李",
    role="销售支持专员",
    skills=["customer-service", "product-recommendation", "quote-generation"],
    channels=["wechat", "email"]
)

# 创建团队
team = Team(
    name="客户服务团队",
    members=[sales_agent],
    orchestrator="auto"
)

# 启动团队服务
team.start()

# 处理客户请求
response = team.handle_request("我想了解一下你们的企业版产品")
print(response)

📦 核心模块

模块 说明 文档
def_core.employee 数字员工定义与管理 文档
def_core.skills 技能系统与注册表 文档
def_core.memory 四层记忆系统 文档
def_core.team 团队编排与协作 文档
def_core.channels 全渠道网关 文档
def_core.tools 企业工具集成 文档

📊 与主流框架对比

维度 DEF LangChain CrewAI Hermes
角色定义
技能系统 ⚠️
长周期任务
四层记忆 ⚠️
多员工协作 ⚠️ ⚠️
全渠道
企业集成
本地优先

✅ 原生支持 ⚠️ 部分支持 ❌ 不支持


🎯 应用场景

客户服务

  • 7×24 小时自动响应
  • 智能问题分类与路由
  • 多渠道统一服务体验

销售支持

  • 客户咨询自动跟进
  • 产品推荐与报价生成
  • CRM 系统无缝对接

技术支持

  • 代码问题自动排查
  • 文档智能检索
  • 工单自动创建与跟踪

运营管理

  • 内容自动生产
  • 数据分析报告
  • 跨系统工作流自动化

📋 实施路线图

阶段 时间 目标
Phase 1 4-6 周 基础框架:员工层、技能系统 v1、记忆系统 v1
Phase 2 6-8 周 能力增强:语义记忆、50+ 工具、团队编排
Phase 3 8-12 周 企业集成:CRM/ERP 对接、安全加固、合规审计
Phase 4 12-16 周 规模扩展:高可用、性能优化、技能市场

🔒 安全与合规

  • 认证授权: OAuth2/JWT + RBAC 权限管理
  • 数据加密: AES-256 静态加密 + TLS 1.3 传输加密
  • 执行隔离: Docker 沙箱 + 资源限制
  • 审计日志: 完整操作记录,支持合规审计
  • 数据脱敏: 敏感信息自动过滤

🤝 贡献指南

我们欢迎各种形式的贡献!

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

详见 贡献指南


📄 许可证

本项目采用 Apache 2.0 许可证 - 详见 LICENSE 文件


📬 联系方式


⚡ 让 AI 成为您的得力员工,而非简单工具

开始使用 · 查看文档 · 报告问题

Made with 💜 by Z5Research

About

Digital Employee Framework - Enterprise-grade AI agent framework for role-based digital employees with skills, memory, and multi-agent collaboration

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages