AI Sheet Formulas

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：为目标值生成候选公式，尝试用源范围重建结果

常见示例

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

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

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

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

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

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

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

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

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

=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 秒限制。请缩小范围后重试。

相关指南

AI Agents 使用侧边栏中的 AI 工作流执行清理、格式化、公式处理和后续提示。

Language & Settings 查看会影响 AI 功能的权限和其他设置。