用途:教智能体管理 Oodle 仪表盘与文件夹,避免丢失面板状态、避免仪表盘孤立在根目录。
主要能力:列出/获取/创建/更新/删除仪表盘,列出与创建文件夹;更新通过 create -f save.json 并设 "overwrite": true(无 dashboards update)。删除文件夹无 CLI 命令,需用 Oodle UI。
必要用法:先安装并配置,brew install oodle-ai/oodle/oodle 后 oodle configure,或设置 OODLE_API_KEY、OODLE_INSTANCE、OODLE_DEPLOYMENT。执行前先确认资源 ID,必要时用 oodle dashboards list -o json 发现,结果不明确时向用户确认。更新前必须先 get 完整定义再改,否则会丢面板。创建时始终设置 folderUid,否则落入根目录。共享仪表盘删除采用两阶段:先重命名为 [MARKED FOR DELETION],等待至少 7 天后再 oodle dashboards delete <uid> --force。
限制与注意:面板查询窗口不要用 $__range,应使用 $__rate_interval、$__dd_interval、$__large_interval;stat 面板按窗口汇总而非 $__range。常见错误包括 401、404、连接被拒、folder not found、更新后面板消失、429 等,需按资料给出的方式处理。
适用场景:需要批量或安全维护 Oodle 仪表盘、组织文件夹、避免破坏外部链接的运维与平台团队。