跳至主要內容
指南
Sheets AIGoogle Workspace 外掛程式Google Sheets

AI Sheet Formulas

直接在 Google Sheets 儲存格中使用 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 Sheets: AI Sheet Formulas 目前僅適用於 Google Sheets™。

開始之前#

  • 先開啟一次外掛程式側邊欄,並在同一個帳戶或瀏覽器設定檔中完成登入。
  • 在 Settings 中將 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、AIMERGE200 列每列輸入回傳一個輸出
AIPATTERN200 列目標列,最多 10 組範例配對每列目標列回傳一個轉換後的輸出
AISPLIT200 列回傳結構化的多欄輸出
AIVOCAB200 個輸入儲存格回傳一列 4 欄的結果
AIDRAFT50 列每列回傳一個產生的輸出
AITABLE最多 200 個內容儲存格和 12,000 個字元回傳含表頭的完整二維表格
AIREVERSECALC50 個來源儲存格,1 至 20 個候選項目(預設為 5)回傳排序後的候選表格

重要限制#

  • 公式名稱為不含句點的 AI...,例如 AIASK,而不是 AI.ASK。
  • 自訂公式函式僅適用於 Google Sheets™。
  • 公式輸出僅為純文字。如果需要在產生結果後設定格式,請使用 AI Agents。
  • Google Apps Script 自訂函式有 30 秒的執行時間硬性上限。
  • AITABLE 和 AISPLIT 的結果可能展開得很廣。請先清空整個輸出區域,以免出現 #REF!。
  • AIREVERSECALC 需要以文字形式輸入 A1 表示法的參照,例如 "E10" 和 "A2:C10"。目標儲存格必須包含數字,建議的公式只會使用 +、-、* 和 /。
  • AIPATTERN 的範例範圍必須恰好有兩欄:輸入和預期輸出。
  • 以列為單位的公式,輸入內容總共最多接受 24,000 個字元。
  • 空白的輸入列會被略過,並以空白儲存格回傳。
  • 請勿將 AIASK 或類似公式往下拖曳到 50 個獨立的列。每份複本都是一次獨立的 AI 請求,也各自有 30 秒的執行時間。請改用單一範圍公式。

最佳做法#

  • 選用的 [refresh] 參數(例如 $Z$1 中的核取方塊)會讓 Sheets 重新計算公式。它不會繞過 6 小時的快取:若要取得不同的答案,請修改指示或輸入內容。
  • 讓 AIPATTERN 的範例配對保持精簡且具代表性。通常四到六組範例就夠了。
  • 執行 AISPLIT、AITABLE 或 AIVOCAB 前,請先騰出足夠的空間。
  • 讓 AIREVERSECALC 專注於較小的數值來源範圍。
  • 如果公式逾時,請先縮小範圍再重試。

疑難排解#

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

開啟 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 秒上限。請縮小範圍後重試。

相關指南#

  • AI Agents - 使用由側邊欄驅動的 AI 工作流程來清理工作表、設定格式、加入公式和送出後續提示。
  • Settings - 檢視影響 AI 功能的 AI 權限和其他設定。