Google 表格

AI 操作表格的工具——读取、写入、格式、筛选、图表和保护——让结果落在团队审核的地方。

一句话

亚马逊和 noon 工具本身从不写入表格。当你在 Google 表格里工作时,AI 用这些工具把结果记录到表格中,包括表头、格式、筛选和下拉菜单。你在表格里审核、修改,然后说“把我改过的行提交”。

AI 如何使用表格

读取已有内容

list_sheet_tabs 和 get_sheet_metadata 显示工作簿结构;read_sheet 读取一个区域,get_sheet_cell 读取单个单元格及其下拉菜单和批注,get_sheet_notes 读取标签页的批注。

写入结果

write_sheet 写入一块数据,append_sheet_rows 在末尾追加行,write_sheet_formula 写入公式,import_sheet_tsv 导入整份报表。setup_sheet 和 add_sheet_tab 新建标签页。

让它易读

format_sheet_range、set_sheet_number_format、freeze_sheet_panes、autofit_sheet_columns 和 apply_sheet_table_style 负责格式;add_sheet_conditional_format、add_sheet_chart 和 insert_sheet_sparkline 添加可视化。

变成工作台

add_sheet_dropdown 把亚马逊的取值放进下拉菜单,create_sheet_filter 和 sort_sheet_range 排列行,protect_sheet_range 锁定不该编辑的区域。其他需求用 sheet_batch_update 兜底。

可以这样问

“读取我 Sales 表格里的数据。”

“把 listings 表的表头行加上格式、冻结,并加筛选。”

读取区域的两种调用方式

同一个工具、同样的参数——通过 AI 客户端,或者从你自己的代码。

MCP——你说:“我的 Sales 标签页 A1:F20 里是什么?” AI 调用 read_sheet。

在 AI 客户端中(MCP)

tools/call
{
  "name": "read_sheet",
  "arguments": {
    "spreadsheet_id": "<your spreadsheet id>",
    "range_": "Sales!A1:F20"
  }
}

在代码中(Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/read_sheet \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"spreadsheet_id":"<your spreadsheet id>","range_":"Sales!A1:F20"}'
抢先体验 — 如需 Tool API 访问,请 联系我们.

这些工具会改动你的表格

写入和格式工具改动的是你指定的工作簿——不会改动你的亚马逊账户。表格必须是你的 Google 账号能打开的。

本页用到的工具

构建时从工具目录读取,每个工具带有自己的权限标签。

工具权限作用(英文)
add_sheet_chartwriteInsert a native Google Sheets chart over a range of data.
add_sheet_conditional_formatwriteAdd a conditional formatting rule to a range: a boolean rule (the default) that formats the cells meeting a condition, or a 2- or 3-stop colour gradient.
add_sheet_dropdownwriteSet, replace or remove the dropdown on a range — the one dropdown tool.
add_sheet_named_rangewriteAdd a new named range.
add_sheet_tabwriteAdd a new tab to the spreadsheet.
append_sheet_rowswriteAppend rows below the last non-empty row of the columns in range_.
apply_sheet_table_stylewriteStyle an already-written range as a table: a bold, coloured, centred header row, alternating row bands, thin grey borders and a frozen header.
autofit_sheet_columnswriteAuto-resize columns to fit their content — wraps Sheets `autoResizeDimensions`.
clear_sheet_rangedestructiveClear the values in a range.
collapse_sheet_groupwriteCollapse (collapsed=True) or expand the row or column groups that lie inside range_.
copy_sheet_formatwriteCopy formatting only (no values) from source range to target range.
copy_sheet_tabwriteCopy a tab, with all its formatting, into another spreadsheet (or the same one).
create_sheet_filterwriteCreate a filter view on a range: a named, saved filter anyone can open from Data > Filter views without touching the tab's one basic filter (set_sheet_basic_filter sets that).
delete_sheet_named_rangedestructiveDelete a named range.
delete_sheet_tabdestructiveDelete a tab from the spreadsheet.
find_replace_in_sheetdestructiveFind and replace text in a sheet.
format_sheet_rangewriteSet the fill colour, font colour, bold and font size of a range.
freeze_sheet_paneswriteFreeze rows and/or columns in a sheet.
get_sheet_cellreadRead everything about a cell or a small range in one call: value, formula, format, note, hyperlink and dropdown.
get_sheet_linksreadGet hyperlinks from a range.
get_sheet_metadatareadGet the spreadsheet's metadata: title, locale, time zone and every tab's properties.
get_sheet_named_rangereadGet a specific named range.
get_sheet_notesreadGet notes from a range.
group_sheet_rows_colswriteGroup rows or columns (creates a collapsible [+] toggle in the sheet).
hide_sheet_rowswriteHide rows in a sheet, or show hidden rows again.
import_sheet_tsvdestructiveServer-side parse + write of TSV (tab-separated) text.
insert_sheet_rows_colswriteInsert rows or columns in a sheet.
insert_sheet_sparklinewriteInsert an in-cell SPARKLINE chart by writing the formula for you.
list_sheet_named_rangesreadList all named ranges in the spreadsheet.
list_sheet_tabsreadList all tabs in the spreadsheet.
merge_sheet_cellsdestructiveMerge cells in a range.
paste_sheet_with_formatdestructiveWrite values AND apply uniform format to the same range — saves a round-trip vs calling write_sheet then format_sheet_range.
protect_sheet_rangewriteProtect a range from editing.
read_sheetreadRead cell values from a range.
read_sheet_formatreadRead cell formatting from a range.
rename_sheet_tabwriteRename an existing tab.
resize_sheet_columnswriteResize columns in a sheet.
resize_sheet_rowswriteResize rows in a sheet.
set_sheet_basic_filterwriteSet a basic filter (column dropdown arrows) on a header row range.
set_sheet_borderswriteAdd cell borders to a range.
set_sheet_number_formatwriteSet number format for a range.
setup_sheetwriteCreate a tab if it is missing, write a key row and a label row, and format them.
sheet_batch_updatedestructiveApply several raw Sheets API v4 requests (spreadsheets.batchUpdate) in one call.
sort_sheet_rangedestructiveSort a range by specified columns.
ungroup_sheet_rows_colswriteRemove a row/column group (ungroup).
unmerge_sheet_cellswriteUnmerge cells in a range.
unprotect_sheet_rangewriteRemove protection from a range.
update_sheet_notewriteUpdate note on a cell or range.
write_sheetdestructiveWrite a 2D block of values to a range; every cell is parsed as if typed (USER_ENTERED).
write_sheet_formuladestructiveFill one formula into a cell — or across EVERY cell of a range.

常见问题

有教 AI 做好表格的技能吗?

有——sellersheet-sheets(建表、格式、实时数据)和 sellersheet-dashboard(多标签页看板)。见安装技能。

Google 表格插件呢?

插件的按钮在表格内运行各自的流程——见插件按钮。Docs 和 Drive 有各自的页面:Google 文档、Google 云盘。

本页内容

操作

查看 Markdown

询问助手

问 ChatGPT问 Claude