用途:在 Pi Fabric 上用原语搭建自我组织的持久智能体团队,实现类似信使的协作与任务分派,而非安装现成消息或 swarm 扩展。
主要能力:持久身份用 agents.create;异步委托用 agents.tell(仅在必须阻塞时才用 ask);持久事件与历史用 mesh.publish / mesh.read;在线状态用 mesh.members;原子领取、租约与决策用 mesh.put({ …, ifVersion })。
使用方式:选取短运行键与主题,如 team.auth-migration;任务存于 runs/<run>/tasks/<id>,以 ifVersion: 0 创建,包含 title、status、owner、dependencies、progress、result。将 run 键作为 strings.run、任务作为 JSON strings.tasks、角色指令作为 JSON strings.roles 传入。通过 agents.tell 派发,用 mesh.publish 宣告 run.started。协调保持拉取式:在决策点检查主题历史、任务状态与邮箱,而非持续轮询。
限制与要求:工作方须验证每个依赖任务已完成,仅以等于观测版本的 ifVersion 领取就绪工作,领取失败即停止;发布进度;用前次成功读/写的版本更新 blocked/completed 状态;仅当所有依赖完成后以 CAS 解除依赖方阻塞;问题用 mesh.publish({ topic, to, … }) 定向;尊重路径所有权;仅在阻塞或最终结果时发出 directive。划分文件所有权;agents.steer 仅用于正在运行的一次性工作方,持久 actor 接收 tell/ask 邮件。其余细节暂未提供。