核心用法
AgentNetwork 技能用于构建跨网关的分布式 Agent 协作网络。以 Discord 频道作为消息总线(支持 @agent 路由与人工可读对话),GitHub 仓库作为共享状态存储(注册表 + 心跳状态)。
关键操作:
- 初始化网络:
network.py init配置 Git 仓库连接 - 注册 Agent:记录 agent_id、角色、所属网关与节点信息
- 心跳上报:实时同步在线状态
- 快照同步:生成网络全量状态视图
- 离线/移除:管理员(Reed)执行下线或清理操作
任务协调示例:
@jesse 请做 BTC 风险扫描 #meta task_id=tsk_20260301_001 type=TASK from=maya to=jesse
显著优点
1. 去中心化架构:无需中心化服务器,Git 天然提供版本控制与冲突解决
2. 人工可读:Discord 作为传输层,人类可直接参与对话与监督
3. 轻量协议:#meta 标记实现结构化数据,无需复杂序列化
4. 网关解耦:Agent 可分布在不同网络环境,通过共享仓库协同
潜在局限
- Git 冲突风险:高并发写入时可能产生 rebase 冲突(已配置 3 次重试)
- 延迟敏感:同步依赖 Git 操作,非实时性协议
- 权限集中:offline/remove 权限仅归 Reed,单点管理瓶颈
- 无加密传输:Discord 与 GitHub 传输依赖平台自身安全
适合人群
- 多 Agent 系统开发者需跨环境协调
- 小团队希望低成本搭建 Agent 网络(无专用消息队列基础设施)
- 需要人类在环(human-in-the-loop)监督的半自动工作流
常规风险
- 仓库泄露风险:GitHub 令牌或仓库 URL 配置不当可能导致状态暴露
- 身份伪造:依赖 agent_id 唯一性,需配合网关层验证
- 状态漂移:网络分区时可能出现心跳滞后,需配合超时策略