IronClaw 中 Google Sheets `delete_sheet` 工具能力深度解析：从 Capability ID 到 batchUpdate 的完整调用链-北京尧图网络

人工智能AI 应用交互助手AI Agent【免费下载链接】ironclawIronClaw is an Agent OS focused on privacy, security and extensibility项目地址https://gitcode.com/gh_mirrors/iro/ironclaw点击查看免费下载导读本文围绕 IronClaw一个以隐私、安全与可扩展性为核心的 Agent OS中 Google Sheets 扩展包的google-sheets.delete_sheet工具展开完整解读该能力在 delete_sheet.md 中定义的行为契约、其输入 Schema 约束、以及底层 WASM 访客端如何通过宿主 HTTP 能力调用 Google Sheets API v4 的batchUpdate删除工作表标签页。读完本文你将掌握该工具的完整参数语义、调用规则capability id 选择机制与禁止携带 action 字段约束、权限与凭据模型以及一套可复制到其他表格管理类操作如 add_sheet、rename_sheet的源码级排查思路。一、工具定位11 个 Google Sheets 工具中的删除操作delete_sheet是 IronClawgoogle-sheets扩展包extension id 为google-sheets暴露的 11 个工具之一用于删除电子表格中的一个 sheet 标签页tab。扩展包 README 将其定位为data-only package不包含独立 crate可移植的工具半部以 WASM 访客guest形式随包分发源码位于wasm-src/预编译产物提交在wasm/google_sheets_tool.wasm。参见 google-sheets/README.md。该扩展包完整覆盖电子表格生命周期创建类create_spreadsheet、add_sheet读取类get_spreadsheet、read_values、batch_read_values写入类write_values、append_values、clear_values管理类delete_sheet删除标签页、rename_sheet重命名标签页格式化类format_cells。delete_sheet与add_sheet、rename_sheet共享同一套结构管理代码路径——三者最终都走batchUpdate区别仅在于请求体中的 request 类型deleteSheet/addSheet/updateSheetProperties这一点从 api.rs 中三个函数的实现可以互相印证。二、行为契约prompt 文档定义的调用规则原文档 delete_sheet.md 定义了该工具给模型model阅读的两条核心契约行为定义Delete a sheet tab.删除一个工作表标签页。调用规则The host selects this operation from the capability id. Provide only the parameters described by the input schema; do not include an action field.宿主从 capability id 选择该操作。只提供输入 Schema 描述的参数不要包含 action 字段。这两条规则分别对应两套源码机制宿主按 capability id 选择操作delete_sheet的完整能力标识为google-sheets.delete_sheet见 manifest.toml。WASM 访客端通过action_from_context将 capability id 映射为内部 action 名google-sheets.delete_sheet Ok(delete_sheet)见 lib.rs。禁止携带 action 字段访客端在params_with_action中先解析调用参数若对象中已存在action键则直接拒绝返回invalid_parameters随后再把从 capability id 推导出的 action 注入参数对象。对应单元测试params_with_action_rejects_caller_supplied_action专门验证了调用方自带 action 会被拒绝这一安全边界见 lib.rs。也就是说模型侧看到的是一个无 action 的纯参数 JSON动作语义由宿主在调用时根据 capability id 绑定避免模型伪造/串改动作。三、输入参数 Schema两个必填字段delete_sheet的输入由 delete_sheet.input.v1.json 定义JSON Schema draft-07完整内容如下{ $schema: http://json-schema.org/draft-07/schema#, title: Google Sheets delete_sheet, description: Delete a sheet tab., type: object, required: [spreadsheet_id, sheet_id], properties: { spreadsheet_id: { type: string, description: The spreadsheet ID. }, sheet_id: { type: integer, description: Numeric sheet ID. } }, additionalProperties: false }参数语义与获取方式参数类型必填说明spreadsheet_idstring是电子表格 ID与 Google Drive 文件 ID 相同sheet_idinteger是工作表标签页的数字 ID注意不是标签名两个关键注意事项sheet_id是数字而非名称。WASM 源码库文档明确提示Sheet IDs (numeric) are different from sheet names. Get them via get_spreadsheet.——即应通过google-sheets.get_spreadsheet先获取元数据含各标签页的sheetId、title、index、行列数再拿数字 ID 来删除见 lib.rs 与 api.rs 的 parse_sheet_info。additionalProperties: false。Schema 禁止传入未声明的字段配合禁止 action 字段规则共同构成对模型输出的严格约束。典型调用参数示例{ spreadsheet_id: 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms, sheet_id: 123456789 }四、底层实现一条请求走到batchUpdate4.1 WASM 访客端入口删除动作由GoogleSheetsAction::DeleteSheet变体承载types.rs 中以#[serde(tag action, rename_all snake_case)]声明在execute_inner的分发逻辑中调用api::delete_sheet(spreadsheet_id, sheet_id)见 lib.rs。4.2 核心实现构造deleteSheet请求api.rs 中delete_sheet的实现非常精简/// Delete a sheet (tab) from the spreadsheet. pub fn delete_sheet( spreadsheet_id: str, sheet_id: i64, ) - ResultSheetOperationResult, GuestFailure { let requests vec![serde_json::json!({ deleteSheet: { sheetId: sheet_id } })]; batch_update(spreadsheet_id, requests)?; Ok(SheetOperationResult { spreadsheet_id: spreadsheet_id.to_string(), success: true, }) }对应 Google Sheets API v4 的spreadsheets.batchUpdate请求体{ requests: [ { deleteSheet: { sheetId: 123456789 } } ] }4.3batchUpdate转发层api.rs 中的batch_update将请求 POST 到https://sheets.googleapis.com/v4/spreadsheets/{spreadsheet_id}:batchUpdatebase URL 定义于 api.rs 第 11 行并统一封装错误非 2xx 状态码会映射为api_status_{status}的 Client 类失败401 会映射为google_api_error_status_401AuthRequired 类提示凭据过期/缺失。4.4 返回结果类型删除成功后的返回结构由 types.rs 的SheetOperationResult定义与rename_sheet共用/// Result from delete_sheet or rename_sheet. #[derive(Debug, Serialize)] pub struct SheetOperationResult { pub spreadsheet_id: String, pub success: bool, }返回示例{ spreadsheet_id: 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms, success: true }五、安全与权限模型删除操作是高危写入delete_sheet属于外部写入型破坏性操作manifest 中的登记信息充分体现了 IronClaw 的安全设计见 manifest.toml[[tools]] origin_gate_matrix { loop_run gated_unless_granted, product forbidden, automation forbidden } id google-sheets.delete_sheet description Delete a sheet tab. effects [network, use_secret, external_write] default_permission ask visibility model input_schema_ref schemas/google-sheets/delete_sheet.input.v1.json prompt_doc_ref prompts/google-sheets/delete_sheet.md [[tools.credentials]] handle google_runtime_token vendor google scopes [https://www.googleapis.com/auth/spreadsheets] audience { scheme https, host sheets.googleapis.com } injection { type header, name authorization, prefix Bearer }解读effects [network, use_secret, external_write]声明该工具会发起网络请求、使用密钥、对外部系统产生写入权限系统据此进行能力评估与提示。default_permission ask默认需要用户确认ask不会静默执行破坏性操作。origin_gate_matrixloop_run场景下为gated_unless_granted未获授权则被门禁拦截product与automation场景直接forbidden——即产品界面上不暴露该能力、自动化流程禁止调用从源头限制危险操作面。visibility model该工具对模型可见。凭据注入使用google厂商的google_runtime_tokenOAuth scope 为https://www.googleapis.com/auth/spreadsheets读写权限以Authorization: Bearer token请求头方式注入。关键设计在于WASM 访客端永远看不到真实 token所有 API 调用都经由宿主的 HTTP 能力完成由宿主负责凭据注入与限流见 api.rs 模块注释。六、常见失败路径与排查要点结合源码中的错误处理api.rs 的 api_call 与 api_status_errordelete_sheet可能出现的典型失败场景表现处理建议参数中混入action字段invalid_parametersInput 类只传 Schema 规定的两个字段sheet_id是标签名而非数字 IDGoogle API 返回 4xx映射为api_status_400等先用get_spreadsheet获取数字sheetIdtoken 过期或 scope 不足google_api_error_status_401AuthRequired 类重新走[auth.google]oauth2_code流程授权删除不存在的 sheetId / 删除唯一剩余标签页API 报错映射为api_status_{status}先get_spreadsheet核对sheetId与标签页数量网络被拒绝NetworkDenied检查宿主对sheets.googleapis.com的 HTTP 能力放行guest 声明的能力要求为sheets.googleapis.com/v4/spreadsheets*七、相关文件速查围绕delete_sheet可直接深入阅读的仓库资源行为契约文档delete_sheet.md输入 Schemadelete_sheet.input.v1.json工具登记与安全属性manifest.toml核心实现delete_sheet/batch_updateapi.rs、api.rscapability id 分发与 action 注入lib.rs返回类型定义types.rs扩展包总览google-sheets/README.md结语google-sheets.delete_sheet虽只是一个两行 prompt 文档定义的小工具但其背后是 IronClaw 一整套契约驱动 WASM 隔离宿主能力托管的扩展机制prompt 文档与 JSON Schema 约束模型行为capability id 绑定动作语义WASM 访客端在沙箱内构造deleteSheet请求宿主统一完成凭据注入、限流与错误映射权限矩阵对破坏性操作默认 ask、并在自动化场景直接禁止。理解这一条链路也就掌握了 IronClaw 中所有外部工具能力尤其是同类表格结构操作add_sheet、rename_sheet的通用工作范式。赞分享人工智能AI 应用交互助手AI Agent【免费下载链接】ironclawIronClaw is an Agent OS focused on privacy, security and extensibility项目地址https://gitcode.com/gh_mirrors/iro/ironclaw点击查看免费下载相关推荐IronClaw 谷歌表格扩展 add_sheet 工具从 Capability 提示文档到 Sheets API 的完整调用链IronClaw 谷歌表格扩展 add_sheet 工具从 Capability 提示文档到 Sheets API 的完整调用链导读本文以 IronCla人工智能AI 应用交互助手AI AgentIronClaw Google Sheets read_values 能力深度解析A1 范围读取的调用链、参数契约与权限模型IronClaw Google Sheets read_values 能力深度解析A1 范围读取的调用链、参数契约与权限模型本文以 IronClaw 扩展包人工智能AI 应用交互助手AI AgentIronClaw Google Sheets 扩展 create_spreadsheet 能力全解析参数契约、WASM 调用链与安全模型IronClaw Google Sheets 扩展 create_spreadsheet 能力全解析参数契约、WASM 调用链与安全模型 IronClaw 是人工智能AI 应用交互助手AI Agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

IronClaw 中 Google Sheets `delete_sheet` 工具能力深度解析：从 Capability ID 到 batchUpdate 的完整调用链

相关推荐

变频电源如何解决工厂供电不稳？AC-DC-AC原理与选型维护实战

【awinic inside】艾为第六代高压线性马达驱动助力OPPO Find X10系列新体验

ESP32脑电波控制红外家电：从信号采集到红外发射的完整实现

更多资讯

【JAVA毕设源码分享】基于spring boot的智慧医疗平台设计与实现(程序+文档+代码讲解+一条龙定制)

ARM学习笔记（8）

ESP8266与KiwisIoT实现低成本远程水位监测与告警系统

服装供应链SCM系统架构解析：库存周转的 MRP 运算与数据同源链路

Tinkercad电路仿真实战：从点亮LED到Arduino闪烁与555定时器

办公文档格式互转，多款文档转换工具能力客观记录

今日更新

Play Framework 迁移指南：移除 GlobalSettings，全面转向依赖注入（Scala 与 Java）

Numba 类型推断机制详解：从 Numba IR 到编译期类型重建的完整原理与实践

企业级项目dragonballz_e159-1的技术架构与实现方案

本周精选

深入解析Transformer多头注意力机制与工程优化

OpenClaw 的 Skills 跑学习任务，模型通道改到 TaoToken 通道行不行？

ChatGPT报错Oops, an error occurred! 全链路排查指南

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？