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 秒限制。請縮小範圍後再試。