Agent通信系统
一个复杂的多代理通信框架，通过MCP（模型上下文协议）工具实现AI代理之间的无缝协作，支持实时消息路由、管理控制和双语操作。
🌟 特性
- 多代理通信：使代理1和代理2能够高效通信
- 管理控制系统：具有SOURCE标签权限的绝对优先级命令
- 实时消息路由：智能交付和手动路由选项
- 双语支持：越南语和英语规则集
- 高级UI控制器：消息管理的综合界面
- 文件和图像附件：支持混合内容通信
- 工作空间感知：针对不同工作空间的智能路径处理
📋 先决条件
- python
- MCP兼容的AI环境（例如，Claude、Cursor）
- Git用于存储库克隆
⚙️ 安装
1.克隆存储库
git clone https://github.com/your-repo/mcp-server-agent-comm.git
cd mcp-server-agent-comm2.安装依赖项
pip install -r requirements.txt3.MCP服务器配置
将以下配置添加到MCP设置中：
{
"agent_chat_1": {
"command": "python",
"args": ["E:/MCP-servers-github/Utils/mcp_server_agent1.py"],
"stdio": true,
"enabled": true
},
"agent_chat_2": {
"command": "python",
"args": ["E:/MCP-servers-github/Utils/mcp_server_agent2.py"],
"stdio": true,
"enabled": true
}
}备注：更新路径 E:/MCP-servers-github/Utils/ 以匹配您的实际安装目录。
📚 规则配置
语言选项
根据您的首选语言选择一个规则文件：
- 越南语:
rule_for_AI_VI.txt - 英语:
rule_for_AI_EN.txt
在游标中设置
- 打开光标设置
- 导航到“人工智能规则”部分
- 复制并粘贴所选规则文件的内容
- 保存配置
🚀 用法
步骤1：启动控制器UI
打开终端/命令提示符并运行：
python E:\MCP-servers-github\Utils\main_controller.py备注：替换 E:\MCP-servers-github\Utils\ 使用您的实际安装路径。
控制器UI将打开，允许您监视和控制代理通信。
功能“AI聊天”->用户可以与所有等待的客服聊天。
步骤2：在Cursor中设置代理
- 打开两个选项卡：在Cursor中创建两个单独的聊天选项卡
- 表1-代理1：键入激活命令以启动代理1
- 表2-代理2：键入激活命令以启动代理2
- 执行工具：允许AI调用MCP服务器代理聊天工具
- 监视器控制器：检查控制器UI以查找已注册的代理
- 路由消息：使用控制器UI管理消息传递
激活命令
对于AI交互模式：
- 越南语:
start ai_interaction - 英语:
start ai_interaction
对于代理通信模式：
- 越南语:
start agent chat 1或start agent chat 2 - 英语:
start agent chat 1或start agent chat 2
通信流
- 代理商注册：代理人使用各自的工具进行注册
- 消息路由：控制器UI管理消息传递
- 优先权制度：管理员命令（SOURCE=Admin）具有绝对优先级
- 协作：代理讨论并确认管理任务的执行计划
详细工作流程
初始设置：
- 使用启动控制器UI
python main_controller.py - 使用两个聊天选项卡打开Cursor
- 激活选项卡1中的代理1：
start agent chat 1 - 在选项卡2中激活代理2：
start agent chat 2 - 验证两个代理是否都出现在控制器UI的“等待代理”部分
消息通信：
- 从代理1发送消息（将出现在消息队列中）
- 使用控制器UI将消息路由到代理2
- 代理2接收并可以响应
- 通过控制器UI路由继续对话
管理员控制：
- 以绝对优先级发送管理员消息
- 使用“智能配送”进行自动路由
- 监控实时代理状态
- 需要时清除数据
管理员控制
- 绝对权威：管理员消息覆盖所有代理活动
- 智能配送：自动路由到可用代理
- 手动路由：对消息传递的精确控制
- 实时监控：等待代理和消息队列的实时状态
🏗️ 项目结构
Utils/
├── agent_comm/
│ ├── core/ # Core system components
│ │ ├── config_manager.py # Configuration management
│ │ ├── flow_manager.py # Message flow control
│ │ ├── message_handler.py # Message processing
│ │ └── state_manager.py # System state management
│ ├── ui/ # User interface components
│ │ ├── controller_ui.py # Main controller interface
│ │ └── styles.py # UI styling
│ ├── chat_ui/ # Chat interface system
│ └── shared_data/ # Persistent data storage
├── mcp_server_agent1.py # Agent 1 MCP server
├── mcp_server_agent2.py # Agent 2 MCP server
├── rule_for_AI_VI.txt # Vietnamese rules
├── rule_for_AI_EN.txt # English rules
└── README.md # This file🎯 关键组件
客服聊天工具
- mcp_agent_chat_1_agent_chat_1工具：代理1的通信工具
- mcp_agent_chat_2_agent_chat_2工具：Agent 2的通信工具
控制器功能
- 消息队列管理
- 代理状态监控
- 智能配送系统
- 文件和图像附件支持
- 实时刷新能力
规则系统
- 来源标签机构：admin=绝对优先级，agent=标准
- 初始化规则：基于关键字的激活系统
- 工作流合规性：强制性工具召回和思维障碍
- 语言一致性：在整个交流过程中使用越南语或英语
🔧 高级功能
消息类型
- 文本消息：标准通信
- 文件附件：文档和代码共享
- 图像支持：视觉内容交流
- 混合内容：组合文本、文件和图像
优先权制度
- 管理员命令：立即执行，覆盖所有活动
- 代理消息：标准对等通信
- 需要协作：代理必须讨论管理任务的执行
UI控制器
- 实时更新：1.5秒刷新间隔
- 多选：消息的批处理操作
- 智能路由：自动代理选择
- 状态跟踪：全面的系统监控
🐛 故障排除
常见问题
- MCP服务器未启动
- 验证配置中的Python路径 - 检查文件权限 - 确保安装了所有依赖项
- 代理人不沟通
- 确认两个代理都已注册 - 检查控制器UI中是否有等待的代理 - 验证规则文件是否配置正确
- 消息队列问题
- 在控制器UI中使用“清除所有数据” - 重新启动MCP服务器 - 检查shared_data目录权限
💡 相关项目：
https://github.com/KhaiHuynhVN/MCP-Server_AI-interaction