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 功能的權限與其他設定。