跳到主要内容

artifact sdk 怎么用 生成可编辑 Excel 的最小示例与文件下载

作者:速优AI架构师 最近更新:2026-11-20 17:22:48 阅读数:1 关键词:artifact sdk 怎么用 生成可编辑 Excel 的最小示例与文件下载

Artifact SDK 用于以代码创建和编辑可继续修改的办公文件。下面用报价表演示:输入两种商品的数量与单价,导出保留公式的Excel,并提供生成文件下载。这个例子已在本地预装的@oai/artifact-tool运行;它不代表本次已调用Agents API云端会话。

先下载实际生成的 Excel

下载报价表Excel示例。内容是2盏台灯,每盏19.50美元,以及3根线缆,每根5美元;总额54美元。商品及价格为演示数据,不是正式报价。

单元格内容应得到的结果
D2=B2*C239
D3=B3*C315
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");

怎样确认文件可编辑?

  1. 用Excel、WPS或兼容软件打开,确认商品行与总额,而不是只看截图。
  2. 点选D2和D4,核对它们保留公式;若只剩39和54常量,结果虽然看起来一样,却不能跟着数据更新。
  3. 把台灯数量从2改为3,重算后D2应为58.5、总额应为73.5,再另存文件。
  4. 继续增加商品行时扩展公式范围,避免SUM漏掉新行。

本次文件已完成公式与缓存计算值检查。上面的手工改单元格步骤是读者复核方法,不冒称在所有办公软件中都做了界面测试。

放进 Agents API 后怎样下载?

官方文件说明要求输出保存到/workspace/outputs,任务完成后按会话、turn和路径定位对应artifact再下载。相同文件名在不同turn可能是不同版本,要核对任务与路径,不能拿任意临时沙箱链接充当长期下载。本文下载链接则是本站保存的独立示例文件。

预热沙箱解决什么?

预热用于减少环境准备等待,不会自动保证公式正确。先让最小文件在既定环境生成、导出并回读,再优化启动耗时。若SDK导出失败,检查环境和版本;若文件金额错误,检查数据和公式,两类问题不要混为一谈。

继续阅读

AI Agent 怎么评测?任务成功率、误报率与评估表模板

资料与更新说明

资料核验于2026年10月22日。下列演示输入、费用算例和任务拆分由本文设计;未标明实测的外部模型调用不代表本次已运行。产品开放范围与费用以官方当前页面及账号为准。

速优AI(PerfCloud)产品与服务

从当前业务问题开始,了解对应服务。项目合作先付费咨询,再确认解决方案、报价与交付;远单标准产品按其官网套餐使用。

相关标签

最新资讯

相关资讯