CometAgent 是一个先进的多智能体协作操作系统，通过集成大语言模型、工具调用和任务规划能力，为用户提供智能化的任务执行和问题解决体验。
- 🧠 多智能体协作: 智能任务分解与协作执行
- 🔧 强大工具集成: 支持MCP协议和多种外部API
- 📈 智能任务规划: 复杂任务的图式化处理
- 🔌 灵活插件架构: 易于扩展的模块化设计
- 💾 记忆管理系统: 长期和短期记忆管理
graph TB
A[用户输入] --> B[MetaAgent协调]
B --> C[任务规划器]
B --> D[Agent路由器]
C --> E[任务图处理]
D --> F[专业智能体]
F --> G[工具调用系统]
G --> H[插件管理器]
E --> I[任务执行]
H --> J[MCP服务集成]
subgraph "智能体集合"
F1[XWebSearchAgent]
F2[XDeepThinkingAgent]
F3[XFileOperatorAgent]
F4[XCreatorAgent]
F5[XSThinkingAgent]
F6[XGUIUseAgent]
F7[XLifeGetAgent]
end
F --> F1
F --> F2
F --> F3
F --> F4
F --> F5
F --> F6
F --> F7
CometAgent/
├── 📁 .CometPlugins/ # 🔌 插件系统
│ ├── CometBaseTool/ # 基础工具插件
│ ├── MathCalc/ # 数学计算插件
│ ├── PyEnv/ # Python环境插件
│ └── XCanva/ # 画布工具插件
├── 📁 Agents/ # 🤖 智能体集合
│ ├── XWebSearchAgent/ # 🌐 网络搜索智能体
│ ├── XDeepThinkingAgent/ # 🧠 深度思考智能体
│ ├── XFileOperatorAgent/ # 📁 文件操作智能体
│ ├── XCreatorAgent/ # ✨ 内容创建智能体
│ ├── XSThinkingAgent/ # 💭 思考智能体
│ ├── XGUIUseAgent/ # 🖱️ GUI操作智能体
│ └── XLifeGetAgent/ # 🌍 生活助手智能体
├── 📁 Core/ # 🔧 核心功能模块
│ ├── Agent.py # 基础智能体框架
│ ├── Tool_Use.py # 工具调用系统
│ ├── BaseLLMCall.py # LLM调用接口
│ └── Utils.py # 工具函数库
├── 📁 Modules/ # 📦 核心模块
│ ├── TaskGraph/ # 🎯 任务图处理
│ ├── Planner/ # 📋 任务规划器
│ ├── Context/ # 🧠 上下文管理
│ ├── Memory/ # 💾 记忆系统
│ ├── AgentRouter/ # 🗺️ 智能体路由
│ └── Connector/ # 🔗 连接器模块
├── 📁 Framework/ # 🔨 框架组件
│ └── XComputerUse/ # 🖥️ 计算机使用框架
├── 📁 Plugin/ # 🔧 插件核心
├── 📁 Prompts/ # 📝 提示模板
├── 📁 TaskBox/ # 📋 任务管理
├── 📁 CometLoop/ # 🔄 循环处理系统
└── 🎯 XCometAgent.py # 主入口点
# 克隆项目
git clone https://github.com/CUI-Hyg/CometAgent..git
cd CometAgent.
# 安装依赖
pip install -r requirements.txt
# 配置环境变量
cp Core/.env.example Core/.env
# 编辑 .env 文件，填入你的API密钥# 启动交互式界面
python XCometAgent.py
# 或者直接使用Python API
python -c "
from Core.Agent import CometAgentRunner
result = CometAgentRunner('请帮我分析这个项目的结构', 'Core', 'yes')
print(result)
"# 单一智能体调用
result = plugin.TaskGraph('agent:XDeepThinkingAgent:解释什么是机器学习')
# 多智能体工作流
workflow = {
"name": "研究任务",
"agents": [
{"name": "XWebSearchAgent", "task": "搜索最新的AI发展动态"},
{"name": "XDeepThinkingAgent", "task": "分析搜索结果并总结趋势"}
]
}
result = plugin.TaskGraph(json.dumps(workflow))| 智能体 | 功能描述 | 特殊能力 |
|---|---|---|
| 🌐 XWebSearchAgent | 网络搜索与信息收集 | 实时网络搜索、API集成 |
| 🧠 XDeepThinkingAgent | 深度思考与分析 | 复杂推理、问题分解 |
| 📁 XFileOperatorAgent | 文件操作与管理 | 批量处理、格式转换 |
| ✨ XCreatorAgent | 内容创作与生成 | 文章写作、创意生成 |
| 💭 XSThinkingAgent | 思维导图与规划 | 结构化思考、可视化 |
| 🖱️ XGUIUseAgent | GUI自动化操作 | 界面操作、自动化测试 |
| 🌍 XLifeGetAgent | 生活助手服务 | 实用功能、日常帮助 |
- 🔧 MCP协议支持: Model Context Protocol标准化工具调用
- ⚡ 并行处理: 多工具并发执行，提高效率
- 🎯 智能选择: 基于任务自动选择最适合的工具
- 📊 性能监控: 实时工具调用性能监控
- 📈 任务规划: 自动生成多步骤执行计划
- 💾 记忆管理:
- 短期记忆：会话上下文保持
- 长期记忆：重要信息持久化存储
- 🔍 上下文检索: 智能上下文压缩和检索
- 📦 模块化设计: 插件独立开发、测试、部署
- 🔄 动态加载: 运行时插件热插拔
- 🛡️ 安全沙箱: 插件隔离执行，确保系统安全
| 指标 | 规格 |
|---|---|
| 🐍 Python版本 | 3.14+ |
| 💻 操作系统 | Windows 11 (推荐) |
| 🔌 插件系统 | 动态加载、版本管理 |
| 🌐 MCP协议 | Model Context Protocol |
| 🔄 异步支持 | 完整异步I/O支持 |
| 📊 内存管理 | 智能内存分配与回收 |
# Core/.env
LLM_API_KEY=your_api_key_here
LLM_BASE_URL=https://your-llm-endpoint.com
MCP_SERVER_PATH=./mcp/servers/
LOG_LEVEL=INFO
# 暂停使用：
# Framework/XComputerUse/.env
SCREENSHOT_PATH=./screenshots
AUTOMATION_DELAY=0.5{
"mcpServers": {
"filesystem": {
"command": "python",
"args": ["./mcp-servers/filesystem-server.py"],
"env": {}
},
"websearch": {
"command": "python",
"args": ["./mcp-servers/websearch-server.py"],
"env": {"API_KEY": "your_search_api_key"}
}
}
}# 运行完整系统测试
python -m pytest tests/ -v
# 性能基准测试
python tests/benchmark.py
# 插件兼容性测试
python tests/plugin_compatibility.py# 核心模块导入测试
python -c "
try:
from Core.Agent import CometAgentRunner
from Plugin.PluginCore import PluginManager
print('✅ 核心模块导入成功')
except ImportError as e:
print(f'❌ 导入失败: {e}')
"
# 智能体功能测试
python -c "
from .CometPlugins.CometBaseTool.CometBaseTool import CometBaseToolPlugin
plugin = CometBaseToolPlugin('CometBaseTool', {})
agents = plugin.Agents_Get()
print(f'✅ 发现 {len(agents)} 个智能体')
"def CometAgentRunner(user_input: str, mode: str = "Core", tools: str = "yes") -> str:
"""
主要的智能体执行接口
Args:
user_input: 用户输入的任务描述
mode: 运行模式 ("Core", "Agent", "Tool")
tools: 是否启用工具 ("yes", "no")
Returns:
执行结果字符串
"""class PluginBase:
def __init__(self, name: str, config: Dict):
"""插件基类"""
def execute(self, operation: str, **kwargs):
"""执行插件操作"""
def get_functions(self):
"""获取可用功能列表"""- 🔧 内存管理: 定期清理临时文件，优化内存使用
- ⚡ 并发处理: 合理配置线程池大小，避免资源竞争
- 📊 缓存策略: 启用智能缓存，提高响应速度
- 🎯 负载均衡: 合理分配智能体任务负载
# 性能监控示例
performance_metrics = {
"agent_response_time": "平均响应时间",
"task_success_rate": "任务成功率",
"memory_usage": "内存使用情况",
"plugin_load_time": "插件加载时间"
}我们欢迎所有形式的贡献！
- 🐛 Bug报告: 通过Issues报告发现的bug
- 💡 功能建议: 提出新功能想法和改进建议
- 📝 文档改进: 完善文档和使用说明
- 🔧 代码贡献: 提交Pull Request
# Fork并克隆项目
git clone https://github.com/CUI-Hyg/CometAgent..git
# 安装开发依赖
pip install -r requirements.txt
# 运行代码质量检查
black . && flake8 . && mypy .- 📝 提交信息: 使用Conventional Commits规范
- 🧪 测试要求: 新功能必须包含相应测试
- 📖 文档更新: 更新相关文档和API参考
- 🔧 插件热重载功能
- 🌐 Web界面支持
- 📊 性能监控面板
- 🤖 新增专业智能体
- ☁️ 云端部署支持
- 🔒 企业级安全功能
- 📱 移动端适配
- 🌍 多语言国际化
| 文档 | 描述 | 链接 |
|---|---|---|
| 📖 CLAUDE.md | 完整技术架构文档 | 查看 |
| 🔌 插件开发指南 | 插件开发规范和示例 | 查看 |
| 🏗️ 开发文档 | 项目开发指南 | 查看 |
| 📋 使用示例 | 实际使用案例 | 查看 |
| 问题 | 解决方案 |
|---|---|
| ❌ 导入错误 | 检查Python路径和依赖安装 |
| 🌐 MCP连接失败 | 验证配置文件和API密钥 |
| 🔄 异步错误 | 检查事件循环配置 |
| 💾 内存泄漏 | 定期重启服务，监控内存使用 |
# 启用详细日志
import logging
logging.basicConfig(level=logging.DEBUG)
# 内存使用分析
from memory_profiler import profile
@profile
def your_function():
pass
MIT License - 详见 LICENSE 文件