SuperAPI AI 工具集

code-pipeline

编程与开发

查看项目

更新于 10-16 07:09

技能介绍

用途

code-pipeline 面向需要按顺序进行多次工具调用的任务,例如「抓取 → 解析 → 再抓取 → 存储」这类流程。它的核心思路是:当工作流可以用过程式代码表达,且各步骤是确定性的,就把它们合并到一次 code.execute 调用中执行,从而减少逐步往返的多次智能体轮次。

主要能力

通过 code.execute(language, code, allowedTools) 在沙箱中运行代码。沙箱内的全局 tools 对象以 RPC 方式暴露宿主工具注册表的访问能力,例如调用 tools['web.fetch'] 抓取网页、调用 tools['web.search'] 执行搜索,并可从代码中返回结构化结果。资料示例演示了抓取、解析、再搜索并返回组合结果的写法。

使用方式

  • 用 code.execute 传入语言、代码与 allowedTools,并始终声明最小的允许工具集合。
  • 沙箱仅支持 JS/TS。
  • 名称带点的工具(如 web.fetch)必须通过括号访问调用:tools'web.fetch';同时也提供了便于书写标识符的别名,例如 tools.web_fetch。
  • 建议在步骤确定时优先使用单次 code.execute,而不是多轮顺序的智能体交互。
  • 从代码中返回值可以呈现结构化结果;否则智能体只能看到 stdout。

安全与限制

  • 每一次宿主调用仍会经过插件、硬性黑名单、脱敏以及审批关卡;无法通过把调用包进 code.execute 来绕过安全策略。
  • 默认策略:30 秒挂钟超时、每次运行最多 50 次宿主工具调用、stdout 与 stderr 合计上限 100 KB。
  • 标记为 destructive 的工具(清单安全等级为 'destructive')会被阻止,除非操作者已显式启用 allowDangerous。
  • console.log 的输出会被捕获进 stdout,异常进入 stderr,二者都会作为结果的一部分返回给调用方智能体。

适用场景

适合可以过程化表达、步骤确定且需要连续多次宿主工具调用的流程;具体平台、价格与更多集成细节资料未提供。