Sheets AIGoogle Workspace 插件Google Sheets

AI Sheet Formulas

直接在 Google 表格单元格中使用 AIASK、AITAG、AITRANSLATE、AIVOCAB、AIPATTERN、AIDRAFT、AIMERGE、AISPLIT、AITABLE 和 AIREVERSECALC。

AI Sheet Formulas 将插件的 AI 工作流直接带入电子表格网格。您不必每次都打开侧边栏，只需输入 =AIASK(...) 这样的自定义公式，AI 生成的结果就会溢出到表格中。

如需查看每个公式的可复制示例，请打开 Extensions → Text To Table Converter → ✨ AI Sheet Formulas。

仅限 Google 表格：AI Sheet Formulas 目前仅在 Google 表格™ 中提供。

开始之前#

打开一次插件侧边栏，并在同一账号/浏览器配置文件中完成登录。
在设置中将 AI Permission 设为 Allow。公式无法在单元格内请求权限。
每次调用公式并实际访问 AI 都算作一次 AI 请求，与其区域包含多少行无关。免费方案每 30 天包含 25 次 AI 请求；Pro 不限次数。
结果会缓存 6 小时。使用相同指令和输入重新计算公式时，会返回缓存的答案，不会计为新的请求。
请使用 A2:A50 这样基于区域的公式，而不要把单个单元格的公式向下拖动填充。

可用公式#

=AIASK(instruction, [input_range], [refresh])
=AITAG(value, tags, [refresh])
=AITRANSLATE(input_range, target_language, [refresh])
=AIVOCAB(text_range, language, [refresh])
=AIPATTERN(example_range, target_range, [refresh])
=AIDRAFT(prompt, context_range, [refresh])
=AIMERGE(instruction, input_range, [refresh])
=AISPLIT(input_range, split_instruction, [refresh])
=AITABLE(prompt, [context_range], [refresh])
=AIREVERSECALC(target_ref, input_range_ref, [max_candidates], [tolerance], [refresh])

各公式的作用#

AIASK：对一个区域批量提取、清理或回答问题
AITAG：使用允许的标签列表为每个值打标签
AITRANSLATE：将每个值翻译成目标语言
AIVOCAB：读取整个区域，并以 Term | Pronunciation | Meaning | Example sentence 的形式返回一个关键词汇条目（language 参数用于设定释义和例句的语言）
AIPATTERN：从输入与输出的示例对中学习转换规律，然后应用到目标区域
AIDRAFT：为每一行生成一份草稿输出
AIMERGE：将每一行合并为一个由 AI 撰写的摘要或输出单元格
AISPLIT：将每个输入行拆分为结构化的多个部分，并溢出到多列
AITABLE：生成带表头的完整文本表格，并溢出到多行多列
AIREVERSECALC：给出候选公式，可根据源区域重新得出目标值

常见示例#

txt

=AIASK("Extract the primary domain from this email address", A2:A50, $Z$1)

txt

=AITAG(A2:A200, "van life, freedom, outdoors", $Z$1)

txt

=AITRANSLATE(A2:A200, "German", $Z$1)

txt

=AIVOCAB(A2:A50, "English", $Z$1)

txt

=AIPATTERN(A2:B5, A6:A100, $Z$1)

txt

=AIDRAFT("Write a 2-sentence polite rejection email citing this reason:", C2:C20, $Z$1)

txt

=AIMERGE("Summarize each row in one sentence", A2:C50, $Z$1)

txt

=AISPLIT(A2:A50, "Split into Name, City, Issue", $Z$1)

txt

=AITABLE("List the top 5 US cities by population with columns for State, Mayor, and Population", , $Z$1)

txt

=AIREVERSECALC("E10", "A2:C10", 5, 0.01, $Z$1)

批处理限制与输出说明#

公式	常见限制	输出方式
`AIASK`, `AITAG`, `AITRANSLATE`, `AIMERGE`	200 行	每个输入行返回一个输出
`AIPATTERN`	200 个目标行，最多 10 组示例对	每个目标行返回一个转换后的输出
`AISPLIT`	200 行	返回结构化的多列输出
`AIVOCAB`	200 个输入单元格	返回一行 4 列
`AIDRAFT`	50 行	每行返回一个生成的输出
`AITABLE`	最多 200 个上下文单元格和 12,000 个字符	返回带表头的完整二维表格
`AIREVERSECALC`	50 个源单元格，1 到 20 个候选（默认 5 个）	返回按排名排列的候选表格

重要限制#

公式名称使用不带点号的 AI...，例如 AIASK，而不是 AI.ASK。
自定义公式函数仅在 Google 表格™ 中可用。
公式输出仅为纯文本。如果需要在生成后设置格式，请使用 AI Agents。
Google Apps Script 自定义函数有 30 秒的硬性执行时间限制。
AITABLE 和 AISPLIT 可能溢出到很大的范围。请先清空整个输出区域，以免出现 #REF!。
AIREVERSECALC 需要以文本形式提供 A1 样式的引用，例如 "E10" 和 "A2:C10"。目标单元格必须包含数字，且给出的公式只使用 +、-、* 和 /。
AIPATTERN 的示例区域必须恰好为两列：输入和期望输出。
基于行的公式总共最多接受 24,000 个字符的输入。
空白输入行会被跳过，并返回空白单元格。
不要把 AIASK 或类似公式向下拖动填充 50 个单独的行。每个副本都是一次单独的 AI 请求和一次单独的 30 秒运行。请改用一个区域公式。

最佳实践#

可选的 [refresh] 参数（例如 $Z$1 中的复选框）会让表格重新计算公式。它不会绕过 6 小时缓存：若要得到不同的答案，请修改指令或输入。
让 AIPATTERN 的示例对保持精简且有代表性。通常四到六个示例就足够了。
运行 AISPLIT、AITABLE 或 AIVOCAB 之前，请先腾出足够的空间。
让 AIREVERSECALC 只处理较小的数值源区域。
如果公式超时，请先缩小区域再重试。

故障排除#

Error: AI permission must be set to Allow in add-on Settings.

打开设置，将 AI Permission 设为 Allow，然后重新计算表格。

Error: AI usage limit reached.

您的 AI 配额已用完。请等待重置或升级，然后重试。

Error: AIASK supports up to 200 rows. Use fewer rows.（其他公式也会显示同样的消息）

输入超出了该公式的批处理限制。请将其拆分为更小的区域。

Error: AIASK input too large. Reduce text length or rows.

合并后的文本超出了字符限制。请减少行数或使用更短的单元格内容。

Error: no result (try fewer rows)

AI 的响应在到达这些行之前就被截断了。请在较小的区域上运行公式。

Error: AI response malformed. Try again.

AI 返回了插件无法读取的内容。请重新计算，或略微修改指令。

Error: AI call failed. Try again later.

请减少行数后重试。如果持续失败，请检查插件或后端的状态。

#REF!

溢出路径中的单元格已包含数据。请先清空输出区域。

#ERROR!

函数很可能触及了 Apps Script 的 30 秒限制。请缩小区域后重试。