SuperAPI AI 工具集

progress

智能体与模型

查看项目

更新于 10-16 08:33

技能介绍

用途:progress 是 agent-native 框架中用于回答“智能体现在在做什么”的原语。智能体在长任务开始时启动一个 run,随进展更新,最后以终态结束;UI 在顶栏组件中以百分比条、当前步骤和加载/对勾/叉号图标展示活动中的 run。

与通知的区别:通知是一次性事件(“X 发生了”),显示在铃铛和 toast 中,可标记已读未读;progress 是持续状态(“X 完成了 45%”),显示在 runs tray 中,生命周期为 running → 终态(succeeded/failed/cancelled)。常见做法是任务完成时再发一条 notify(),让未盯着托盘的用户也能看到结果。

主要能力与用法:所有操作通过单个 manage-progress 工具的 action 参数完成。start 标记长任务开始并返回 runId;update 更新百分比和/或当前步骤,需频繁调用;complete 标记终态;list 列出最近 runs(可加 --active=true)。典型流程:manage-progress --action=start --title "Triage 128 unread emails" --step "Fetching inbox",随后多次 update,最后 manage-progress --action=complete --runId=abc --status=succeeded。

Runs API 由 core-routes-plugin 挂载在 /_agent-native/runs/*,HTTP 只读:GET /_agent-native/runs?active=true&limit=50、GET /_agent-native/runs/:id、DELETE /_agent-native/runs/:id;写入只能通过 agent 工具。

UI 组件:<RunsTray /> 来自 @agent-native/core/client/progress,可挂在顶栏通知铃铛旁,有活动 run 时显示图标和数量徽标,点击展开实时百分比条,无活动时隐藏;以 pollMs(默认 3s)轮询 active=true。

事件总线:run.progress.started({ runId, title, step? })与 run.progress.updated({ runId, percent, step, status }),可用于自动化,例如“run 超过 5 分钟就通知我”。

最佳实践:超过约 5 秒的任务都应启动 run;在自然检查点更新而非每次迭代,每 5–10% 更新一次通常足够;结束必须调用 complete,包括错误路径,避免遗留 running 行;完成时配合 notify;可用 metadataJson 在 start 时传入产物链接(线程 id、文档路径)以便从托盘深链。

限制:资料未提供具体安装方式、收费、价格与平台支持信息,暂未提供。