MCP智能体多Agent协作系统设计（Multi-Agent Cooperation）-CSDN博客

单智能体	多智能体协作
功能集中，负载重	职责划分，负载分散
任务处理串行	可并行加速任务执行
难以动态扩展	易于模块化扩展
单点故障风险高	容错与弹性更好

多Agent意味着：

系统更智能
响应更快
扩展性更强

🧠 多Agent协作系统架构设计

整体结构示意：

用户输入
   ↓
总控智能体（Orchestrator Agent）
   ↓
意图识别
   ↓
子智能体分配任务
   ↓
各子智能体调用 MCP 工具执行
   ↓
总控智能体聚合各子任务结果
   ↓
最终输出

主要角色分工：

智能体角色	职责
总控智能体（Orchestrator）	解析用户意图，规划任务，分配子任务，聚合结果
文件专家智能体（FileAgent）	文件检索与内容分析
知识专家智能体（KnowledgeAgent）	知识库搜索与推理
总结专家智能体（SummaryAgent）	多内容综合总结

🛠️ 1. 构建基础智能体基类（Agent Base）

定义所有 Agent 统一继承的基础类：

class AgentBase:
    def __init__(self, name: str):
        self.name = name
        self.client = None

    def connect_server(self, server_address="http://localhost:8000"):
        from mcp.client import MCPClient
        self.client = MCPClient(server_address=server_address)
        self.client.connect()

    def close_connection(self):
        if self.client:
            self.client.disconnect()

    def handle(self, task: str) -> str:
        """子类需要实现具体任务处理逻辑"""
        raise NotImplementedError

🛠️ 2. 定义各专属子智能体（Specialized Agents）

文件专家智能体（FileAgent）

class FileAgent(AgentBase):
    def handle(self, task: str) -> str:
        # 文件相关任务
        if "列出" in task and "txt" in task:
            return self.client.call_tool("list_txt_files", {"directory": "."})
        if "读取" in task:
            filename = task.split("读取")[-1].strip()
            return self.client.call_tool("read_file_content", {"file_path": filename})

知识专家智能体（KnowledgeAgent）

class KnowledgeAgent(AgentBase):
    def handle(self, task: str) -> str:
        # 知识库相关任务
        if "搜索" in task or "知识" in task:
            keyword = task.split("关键词")[-1].strip()
            return self.client.call_tool("search_knowledge_base", {"keyword": keyword})

总结专家智能体（SummaryAgent）

class SummaryAgent(AgentBase):
    def handle(self, task: str) -> str:
        # 总结相关任务
        return self.client.call_tool("summarize_text", {"text": task})

🛠️ 3. 构建总控智能体（OrchestratorAgent）

class OrchestratorAgent(AgentBase):
    def __init__(self):
        super().__init__(name="Orchestrator")
        self.file_agent = FileAgent("FileAgent")
        self.knowledge_agent = KnowledgeAgent("KnowledgeAgent")
        self.summary_agent = SummaryAgent("SummaryAgent")

    def distribute_tasks(self, user_query: str) -> list:
        """简单规则拆解任务，实际可以用更复杂规划器"""
        tasks = []
        if "txt" in user_query or "文件" in user_query:
            tasks.append((self.file_agent, user_query))
        if "知识" in user_query or "搜索" in user_query:
            tasks.append((self.knowledge_agent, user_query))
        if "总结" in user_query or "报告" in user_query:
            tasks.append((self.summary_agent, user_query))
        return tasks

    def handle(self, user_query: str) -> str:
        self.connect_server()
        self.file_agent.connect_server()
        self.knowledge_agent.connect_server()
        self.summary_agent.connect_server()

        tasks = self.distribute_tasks(user_query)
        results = []

        for agent, task in tasks:
            print(f"[{agent.name}] 开始处理任务：{task}")
            result = agent.handle(task)
            results.append(f"[{agent.name}结果] {result}")

        self.file_agent.close_connection()
        self.knowledge_agent.close_connection()
        self.summary_agent.close_connection()
        self.close_connection()

        return "\n".join(results)

🧪 4. 多Agent协作示范运行

if __name__ == "__main__":
    orchestrator = OrchestratorAgent()
    user_input = input("请输入你的需求：")
    final_output = orchestrator.handle(user_input)
    print("最终综合结果：")
    print(final_output)

示例对话：

用户输入：请帮我列出txt文件并总结每个文件内容，同时搜索合同相关知识点。

系统处理：
- FileAgent负责列出txt文件并读取内容
- SummaryAgent负责总结每个文件内容
- KnowledgeAgent负责检索知识库中合同相关内容
- Orchestrator聚合全部结果，输出最终综合报告