SuperAPI AI 工具集

aml-jsx

通用与其它

查看项目

更新于 10-16 06:44

技能介绍

用途:AML 把 JSX 作为智能体工作流的异步运行时,JSX 树是可执行的编排数据,不是 React UI。适合在 TypeScript 中构建、解释、测试和调试智能体工作流。

安装与配置:执行 npm install @aml-jsx/sdk,并在 tsconfig 中设置 "jsx": "react-jsx" 与 "jsxImportSource": "@aml-jsx/sdk"。含 AML 标记的文件使用 .tsx,不要引入 React。

主要能力:以 runtime.evaluate(tree) 启动根工作流;evaluate(tree) 仅用于已求值的 AML 函数组件内部。AML 自叶向根求值并保持书写顺序,嵌套 Agent 先于父 Agent 解析,其文本按书写位置进入父提示。兄弟 JSX 不表示并发,需用 Promise.all() 与 evaluate() 显式并行。可用 defineTool() 与 <Tool use={tool} /> 定义并授予工具,用 defineMcpServer() 与 <Mcp use={server} /> 配置 MCP,用 <Skill> 添加可复用指令,用 <Sandbox> 与 <Workspace> 划分临时执行策略与持久文件,用 <Agent provider={...}> 注入提供方。公共入口导出 codexAgent、opencodeAgent、piAgent、modalSandbox 等工厂。

限制与注意:AML 仍在积极开发,Context 与 Loop 视为草稿。能力是词法授予而非全局注册,某个 Agent 的 Tool 或 MCP 不会对兄弟可见。省略 permissions 默认乐观开启。提供方选择应放在可复用组件之外,vendor 凭据保留在工厂中。所选的本地或 Sandbox 环境须含兼容的 ACP Agent 可执行文件,AML 不隐式安装。校验时优先使用确定性提供方,仅在确需凭据与外部服务时运行实时集成测试。编辑现有项目前应读取 package.json、TS 配置、现有组件与锁文件,并核对已安装 sdk 类型;以 README.md、SPEC.md 与 examples/src/ 为准,不要臆造组件、属性、提供方方法或导入路径。