bambu-agent

🛠️ Skill: Bambu Farm Agent (拓竹农场助手)\r

1. 技能概述\r 本技能允许 Agent 深度接入局域网内的拓竹 (Bambu Lab) 打印机集群。Agent 可以实时监控打印状态、解析复杂的 HMS 错误码，并为用户提供可视化的 Web 监控入口。\r \r
2. Agent 调用规范 (Tool Use)\r 2.1 状态获取 (GET /api/farm/status)\r 适用场景：用户询问进度、时间、温度或查询整体农场状态时。\r \r 数据结构说明：\r \r status_color:\r \r red: 严重错误（HMS 报错或打印失败），Agent 应立即发出语音警告。\r \r yellow: 正在打印或准备中，Agent 应汇报具体百分比和剩余时间。\r \r green: 空闲或已完成，Agent 可告知用户可以安排新任务或取走成品。\r \r ams: 包含耗材颜色和类型，Agent 可用于回答“还剩什么颜色的线”等问题。\r \r 2.2 语音摘要获取 (GET /api/agent/brief)\r 适用场景：作为定时主动提醒的数据源。\r \r 逻辑：Agent 每一小时或在任务状态变更时调用此接口，获取一行总结性的播报文本。\r \r
3. 推理逻辑引导 (Reasoning Logic)\r 当用户提出以下请求时，请按如下逻辑推理：\r \r 请求： “帮我看看打印机。”\r 推理： 调用 /api/farm/status -> 检查 status_color -> 如果有 red，先报错误；如果没有，按列表顺序汇报 yellow 状态的进度。\r \r 请求： “打印完了吗？”\r 推理： 调用 /api/farm/status -> 查找 state == "打印完成" 的实例 -> 告知用户具体机器名称。\r \r 请求： “报错了怎么办？”\r 推理： 提取数据中的 hms_error -> 引导用户检查对应的硬件部位（如：0300 开头通常与热床有关）。\r \r
4. 交互限制与安全\r 局域网限制：如果接口返回超时，请告知用户确保运行设备与打印机处于同一 WiFi 下。\r \r 隐私：不要在交互中完整暴露打印机的序列号 (SN)，仅使用备注名称（如“一号机”）。