Mahilo是腾讯开源的创新型多智能体协作框架,支持创建具备人机协同能力的智能体团队。Mahilo框架允许不同来源的智能体(包括其他框架创建的智能体)在统一平台中实现信息共享与协作,并始终保持人类监督者的控制权。

创建或注册多种智能体

可以基于框架自带的BaseAgent创建新的智能体,也可以集成其他框架(如LangGraph)中的智能体。

构建智能体团队

将这些智能体组合成一个团队,让他们可以相互交流、共享信息。

实现人机协作 (Human-in-the-Loop)

通过客户端连接到每个智能体,进行实时的语音或者文本交互,对智能体的决策进行监督和指导。

控制智能体通信

可以限制智能体可以联系的其他智能体,构建灵活的通信模式(点对点、层级结构)。

1、智能体管理中枢

支持创建自定义智能体(继承BaseAgent类)

可集成LangGraph等其他框架的智能体

动态激活机制(按需启用智能体)

智能体通讯权限管理(can_contact白名单)

2、实时协作系统

# 典型使用示例
from mahilo import BaseAgent, AgentManager

# 创建销售智能体
sales_agent = BaseAgent(
type="sales_agent",
description=prompt_template,
tools=sales_tools
)

# 构建智能体团队
manager = AgentManager()
manager.register_agent(sales_agent)

3、通讯架构

WebSocket实时通信(默认localhost:8000)

支持语音交互(需安装PyAudio)

双模式通讯:

点对点模式:智能体自主决策交互

中心调度模式:通过调度器协调

4、上下文管理

自动维护最近N轮对话记录

跨智能体上下文共享

对话持久化存储(Session类)

快速入门指南

环境准备

# 基础安装
pip install mahilo

# 语音功能支持
pip install mahilo[voice]
export OPENAI_API_KEY=<your_key>

启动服务

# 初始化服务管理器
server = ServerManager(agent_manager)
server.run()  # 启动WebSocket服务

客户端连接

# 连接营销智能体(文字模式)
mahilo connect --agent-name marketing_agent

# 语音交互模式
mahilo connect --agent-name sales_agent --voice

典型应用场景

1、应急响应系统(医疗/消防/警务联动)

2、客户服务中枢(售前-售中-售后全流程协作)

3、物联网设备协同(多终端智能设备管理)

4、游戏NPC生态(智能NPC群体行为模拟)

架构优势解析

灵活扩展:通过templates目录快速创建领域智能体

多用户支持:单智能体可服务多个终端用户

混合协作:人类操作员与AI智能体协同决策

上下文感知:智能体自动获取相关对话历史

项目结构

mahilo/
├── agent_manager.py  # 智能体管理核心
├── server.py         # WebSocket服务实现
├── session.py        # 对话会话管理
└── templates/        # 智能体模板库
└── emergency_health/  # 公共卫生应急示例

通过Mahilo框架,开发者可以快速构建具备人机协同能力的智能体系统,在保持人类控制权的同时充分发挥AI的协作潜力,该框架特别适用于需要多方协调的复杂业务场景,为智能化系统开发提供了新的范式。