session-mesh 用于在分布式通信系统中管理会话拓扑,适合多代理 AI 系统、物联网设备群等需要动态通信的场景;孤立或非分布式系统不适用。
主要能力:发现活跃会话(GET /api/session-mesh/alive,支持 ?filter=active);专长注册表(POST /api/session-mesh/registry,JSON 体如 {"specialization": "image-processing", "agent_id": "123"});调度子代理(CLI 标志 --direction,或 POST /api/session-mesh/steer,负载 {"agent_id": "456", "direction": "east"});终止子代理(session-mesh kill --agent-id 789 或 DELETE /api/session-mesh/agents/789);生成会话密钥(POST /api/session-mesh/keys)。
使用方式:先发现会话,确认存活后再调度或终止;注册专长后可先查询注册表再分配任务。所有请求需带会话密钥,通过 export SESSION_API_KEY=your_secure_key 设置,切勿硬编码。常用命令:session-mesh list --filter alive --output json;session-mesh steer --agent-id 123 --direction west;session-mesh kill --agent-id 456 --force;session-mesh register --spec "data-analysis" --agent-id 789;多会话配置可加载 YAML:session-mesh load-config path/to/config.yaml。
限制与错误处理:无效代理返回 404,密钥无效返回 401,可重新生成密钥后重试;建议校验输入、使用 try-catch 与指数退避,重试不超过 3 次;网络错误需处理瞬态失败。测试可在沙箱中模拟接口响应。与其他技能的集成、收费与价格信息暂未提供。