Sheets AI

AI Sheet Formulas

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

AI Sheet Formulas 将插件的 AI 工作流直接带入表格网格中。您不需要为每个任务都打开侧边栏，只需输入类似 =AIASK(...) 的自定义公式，就能把 AI 生成的结果直接返回到工作表中。

仅限 Google Sheets: AI Sheet Formulas 当前仅适用于 Google Sheets™。

开始之前

先打开一次插件侧边栏，并在同一个账号或浏览器配置中完成登录。
确认您的订阅和 AI 使用权限处于有效状态。
如果您想手动强制重新计算，可使用 $Z$1 之类的复选框单元格作为可选 [refresh] 参数。
请使用 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
`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 个输入单元格	返回 1 行 4 列结果
`AIDRAFT`	50 行	每行返回一个生成结果
`AITABLE`	提示加可选上下文范围	返回完整的 2D 表格和表头
`AIREVERSECALC`	50 个源单元格	返回按优先级排序的候选表格

重要限制

公式名称使用不带点号的 AI...，例如 AIASK，而不是 AI.ASK。
自定义公式函数仅适用于 Google Sheets™。
公式输出仅为纯文本。如果生成后还需要格式处理，请使用 AI Agents。
Google Apps Script 自定义函数有严格的 30 秒执行上限。
AITABLE 和 AISPLIT 可能会大范围溢出。请先清空整个输出区域，以避免 #REF!。
AIREVERSECALC 需要文本形式的 A1 引用，例如 "E10" 和 "A2:C10"。
不要把 AIASK 或类似公式拖拽到 50 个单独行中。请使用一个范围公式。

最佳实践

在 $Z$1 放置一个复选框，并将其作为所有 AI 公式的 [refresh] 参数，这样就能一键强制重新生成。
AIPATTERN 的示例对要小而有代表性。通常 4 到 6 个示例就足够。
在运行 AISPLIT、AITABLE 或 AIVOCAB 前，请预留足够的空白区域。
让 AIREVERSECALC 聚焦于较小的数字源范围。
如果公式超时，请先缩小范围再重试。

故障排查

`Error: Not authorized. Open the add-on sidebar and sign in.`

打开侧边栏，重新登录，然后重新计算工作表。

`Error: AI usage limit reached.`

您的 AI 配额已用尽。请等待额度重置或升级套餐后再试。

`Error: Range too large. Select fewer rows.`

输入超过了该公式的批量限制。请拆分为更小的范围。

`Error: AI call failed. Try again later.`

请用更少的行重试。如果仍然失败，请检查插件或后端状态。

`#REF!`

溢出路径中已有数据。请先清空输出区域。

`#ERROR!`

该函数可能触发了 Apps Script 的 30 秒限制。请缩小范围后重试。