Artifact SDK 用于以代码创建和编辑可继续修改的办公文件。下面用报价表演示:输入两种商品的数量与单价,导出保留公式的Excel,并提供生成文件下载。这个例子已在本地预装的@oai/artifact-tool运行;它不代表本次已调用Agents API云端会话。
先下载实际生成的 Excel
下载报价表Excel示例。内容是2盏台灯,每盏19.50美元,以及3根线缆,每根5美元;总额54美元。商品及价格为演示数据,不是正式报价。
| 单元格 | 内容 | 应得到的结果 |
|---|---|---|
| D2 | =B2*C2 | 39 |
| D3 | =B3*C3 | 15 |
| D4 | =SUM(D2:D3) | 54 |
最小代码示例
此示例面向已预装对应SDK的执行环境,不假设每台电脑都能从公共npm直接安装同名包。包名、导出和版本应以运行环境文档为准。
import { Workbook, SpreadsheetFile } from "@oai/artifact-tool";
const workbook = Workbook.create();
const sheet = workbook.worksheets.add("Quote");
sheet.getRange("A1:D4").values = [
["Item","Qty","Unit Price USD","Amount USD"],
["Desk lamp",2,19.5,null], ["USB cable",3,5,null],
["Total",null,null,null]
];
sheet.getRange("D2:D4").formulas = [
["=B2*C2"],["=B3*C3"],["=SUM(D2:D3)"]
];
workbook.recalculate();
const file = await SpreadsheetFile.exportXlsx(workbook);
await file.save("quote-example.xlsx");怎样确认文件可编辑?
- 用Excel、WPS或兼容软件打开,确认商品行与总额,而不是只看截图。
- 点选D2和D4,核对它们保留公式;若只剩39和54常量,结果虽然看起来一样,却不能跟着数据更新。
- 把台灯数量从2改为3,重算后D2应为58.5、总额应为73.5,再另存文件。
- 继续增加商品行时扩展公式范围,避免SUM漏掉新行。
本次文件已完成公式与缓存计算值检查。上面的手工改单元格步骤是读者复核方法,不冒称在所有办公软件中都做了界面测试。
放进 Agents API 后怎样下载?
官方文件说明要求输出保存到/workspace/outputs,任务完成后按会话、turn和路径定位对应artifact再下载。相同文件名在不同turn可能是不同版本,要核对任务与路径,不能拿任意临时沙箱链接充当长期下载。本文下载链接则是本站保存的独立示例文件。
预热沙箱解决什么?
预热用于减少环境准备等待,不会自动保证公式正确。先让最小文件在既定环境生成、导出并回读,再优化启动耗时。若SDK导出失败,检查环境和版本;若文件金额错误,检查数据和公式,两类问题不要混为一谈。
继续阅读
资料与更新说明
资料核验于2026年10月22日。下列演示输入、费用算例和任务拆分由本文设计;未标明实测的外部模型调用不代表本次已运行。产品开放范围与费用以官方当前页面及账号为准。