快速开始
AI 工具
使用 AI SDK 工具让 AI 代理生成 Office 文档
office-open 包提供了 AI SDK 工具，允许 AI 代理（Claude、GPT 等）使用 Vercel AI SDK 生成 .docx、.pptx 和 .xlsx 文件。
安装
pnpm add office-open ai
需要 Vercel AI SDK（ai 包）v6+。
工具
提供三个工具，分别对应三种文档类型：
| 工具 | 说明 |
|---|---|
generate-docx | 生成 .docx Word 文档 |
generate-pptx | 生成 .pptx 演示文稿 |
generate-xlsx | 生成 .xlsx 电子表格 |
每个工具在生成前使用 Zod schema 验证输入，当 AI 生成无效结构时会给出明确的错误信息。
用法
import { generateText } from "ai";
import { officeOpenTools } from "office-open/ai";
const result = await generateText({
model,
prompt: "创建一份季度报告文档",
tools: officeOpenTools,
});
工具输入
每个工具直接接受文档选项（无需包裹 — 直接传入文档结构）：
generate-docx
{
"sections": [
{
"children": [
{ "paragraph": { "children": [{ "text": "你好，世界！", "bold": true }] } }
]
}
]
}
generate-pptx
{
"title": "我的演示文稿",
"slides": [
{
"children": [
{
"shape": {
"x": 100, "y": 100, "width": 760, "height": 340,
"textBody": { "children": [{ "text": "你好，世界！", "fontSize": 32 }] }
}
}
]
}
]
}
generate-xlsx
{
"worksheets": [
{
"name": "Sheet1",
"rows": [
{ "cells": [{ "value": "姓名" }, { "value": "分数" }] },
{ "cells": [{ "value": "张三" }, { "value": 95 }] }
]
}
]
}
工具输出
每个工具返回 base64 编码的文件：
{
"base64": "...",
"mimeType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
}
Zod Schemas
验证所用的 schema 也可导出供自定义使用：
import { docxSchema, pptxSchema, xlsxSchema, validateDocumentInput } from "office-open/schemas";