Work with AI
约 896 字大约 3 分钟
Harbor 让 AI 面对的不是一段可能已经过时的启动说明,而是项目的“可执行 README”。 Task 与 Group 给出明确的运行方式,harbor_core API 则让 AI 可以读取真实状态、修改 配置、执行任务并检查结果。
你只需要描述目标,不必再把 README 中的每一步操作翻译成按钮或命令。
从建议到执行
普通的 AI 助手只能告诉你“应该怎样做”。Harbor Skill 可以通过 Core API 直接完成:
- 读取当前 Core、Workspace、Task、Group 和 UUID 冲突。
- 创建、读取、更新和删除 Task 或 Group 配置。
- 添加搜索路径、刷新发现结果、切换 Workspace。
- 启动、停止或重启 Task,启动或停止整个 Group。
- 持续读取运行状态和增量日志,确认操作是否真正成功。
- 根据错误修改配置,再次运行并验证结果。
因此一次 AI 请求可以形成完整闭环:
理解目标 → 检查状态 → 修改配置 → 执行任务 → 读取日志 → 验证结果Harbor GUI 与 AI 使用同一套 API。无论操作来自界面还是 AI,你看到的都是同一个 Core 中的真实状态。
直接完成任务
告诉 AI 最终目标,而不是逐步指导它如何点击界面:
使用 $harbor,把当前项目接入 Harbor。使用 $harbor,启动 perception。这类请求不只生成文件。AI 会先读取 /health 与 /snapshot,通过 YAML API 保存配置,再调用运行 API,并根据状态与日志判断结果。
用 Harbor Tag 指定任务
双击任务名称即可复制 Harbor Tag。Tag 同时包含运行位置、项目路径和任务 ID,可以直接粘贴给 AI:
Harbor:local:/home/me/robot_ws:camera
Harbor:remote@robot@10.43.30.29:/home/robot/robot_ws:cameralocal 表示本机任务;remote@SSH目标 表示远端任务。这样即使本地与远端存在相同路径或同名任务,AI 也不会仅凭路径猜测运行位置。SSH 使用默认端口 22 时不会显示端口,其他端口会附在目标后。
使用 $harbor,重启 Harbor:remote@robot@10.43.30.29:/home/robot/robot_ws:camera,并检查最后 128 行日志。编排并运行流程
AI 可以先发现已有任务,再把重复操作沉淀为 Group:
使用 $harbor,把 camera、perception 和 controller 组成一个 Group。使用 $harbor,修复 teleop Group。操作本地与远端 Harbor
Core API 在本地与远端保持一致。切换 Workspace 或远端主机后,AI 仍然可以使用相同方式读取状态和操作任务:
使用 $harbor,在远端启动 robot_bringup。使用 $harbor,把当前项目加入远端 Workspace。持续观察与排障
AI 可以基于快照和增量日志观察任务,而不是依赖一次性的命令返回值:
使用 $harbor,重启 camera,看看是否正常。使用 $harbor,看看当前有哪些任务失败了。使用 $harbor,解决当前的 UUID 冲突。能力边界
- 明确说出“使用
$harbor”,让 AI 使用 Harbor Skill 而不是只给出通用建议。 - 尽量描述期望结果和验收条件,状态检查、API 调用与日志读取由 AI 完成。
- AI 会读取实时状态,但不会绕过 Harbor 的 UUID、版本和单实例约束。
- 修改正在运行的任务前,AI 应先停止任务,避免配置与真实状态不一致。
- Harbor Core 默认没有鉴权,只应在可信网络中交给 AI 操作。
完整接口见 Web API。