SuperAPI AI 工具集

analysis-workspace

通用与其它

查看项目

更新于 10-15 20:09

技能介绍

用途:在 Resources 工作区中管理分析文件,支持大规模、多来源、跨多轮对话的分析任务。临时数据放在 scratch/...(默认在 Resources 视图中隐藏),用户需保留或查看的成果放在 analysis/q2-churn/ 这类描述性目录。

主要能力:run-code 提供 workspaceRead、workspaceWrite、workspaceAppend、workspaceList 等助手,saveToFile 可把 provider-api-request 或 web-request 的完整响应写入工作区文件,单次最多 20 MB;直接写入每次上限 2 MB。workspaceRead 支持 { offset, maxChars } 分页,workspaceList 支持前缀过滤。

典型用法:30 项以上的批量扇出(账户、通话、交易、工单等)按 5–10 项分批,逐项写备忘文件,最后列出并读取全部备忘做综合;超大 API 响应先 saveToFile 落盘再用 run-code 处理;需要广覆盖的检索或分类先构建持久语料再聚合。provider-api-request 可用 fetchAllPages 自动翻页(如 HubSpot 的 paging.next.after / after),并配合 saveToFile 落盘。耗时超过约 30 秒的聚合可用 background: true 异步执行,返回 { executionId, status: "queued" },之后用 run-code { executionId } 轮询结果。

适用场景:跨系统记录关联、供应商范围检索与计数、多步分析、需要可复查覆盖度的结论。

限制与注意:综合前须校验覆盖度,记录已取页数、已查记录、截断标记、中断调用与因缺失关联跳过的记录;覆盖不完整时必须直接说明,不得基于抽样、截断或中断数据断言“未找到”“全部记录”或穷尽性结论。自定义 API 可用 provider-api-register 注册,认证由凭证系统处理。分析后可把确认的 schema 路径、游标字段、身份关联键与分页模式记入 LEARNINGS.md。具体收费、平台支持范围等资料暂未提供。