尧图网站建设 
Composio Excel Toolkit 实战指南二维数组传参、结构化工作簿上传与 Microsoft 认证/Schema 维护【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio导读本指南面向在 Composio 平台上通过 Excel Toolkit 构建 AI Agent 的开发者系统讲解三类高频问题如何向 Excel 工作簿动作传入合法输入、如何基于 SharePoint 备份的工作簿执行读写操作、以及如何让 Microsoft 认证配置与工具 Schema 始终处于最新可用状态。读完本文你将掌握EXCEL_UPDATE_RANGE的二维数组传参规则、worksheet_names/worksheet_data结构化上传用法、EXCEL_GET_RANGE失败时的排查路径以及 Excel 工具包在版本升级与认证配置上的维护要点。本文内容以仓库中的 docs/kb/articles/toolkits-excel.md 为主体骨架并辅以仓库源码与知识库资料进行印证。向 Excel 工作簿动作传入合法输入以二维数组传递范围值EXCEL_UPDATE_RANGEEXCEL_UPDATE_RANGE要求调用方把单元格值组织为二维数组外层列表代表行每一行的内层列表存放该行各单元格的值。即使只更新一个单元格也必须做两层包裹例如{values: [[92]]}这个形状对应 Excel 的 range 语义Excel 的 range 天然是行 × 列的矩阵[[92]]表示 1 行 1 列。如果只传92或[92]工具无法确定该值落在哪一行哪一列就会导致参数校验失败或写入位置错误。据此可以推断Toolkit 在执行更新前会按该二维结构把values映射到目标 range 的每个单元格因此调用方在组装 payload 时应当先确认目标 range 的行列维度与二维数组的外层/内层长度一致。使用结构化工作簿数据完成上传Composio 的 Excel 工具在上传场景采用了重构后的工具形态不再要求调用方或 LLM 直接提供二进制工作簿内容而是通过worksheet_names与worksheet_data两个列表/字典参数传入结构化数据由工具在上传前自动生成.xlsx文件。这意味着 Agent 的编排逻辑可以更贴近业务数据worksheet_names声明要生成的工作表名称列表如[Sheet1, Summary]worksheet_data与工作表一一对应的数据内容每个工作表的数据同样遵循行 × 列的二维结构。仓库知识库源文件 docs/kb/source/toolkits/excel/public.md 对上述两条规则有完全一致的描述可作为排障时的权威依据。上传成功后返回结果中会包含新工作簿的标识如 item ID供后续EXCEL_GET_RANGE、EXCEL_UPDATE_RANGE等动作继续引用。EXCEL_GET_RANGE 失败的常见原因工作表名与 item_id当EXCEL_GET_RANGE看似失败而工具本身工作正常时优先核对两个输入工作表名worksheet name确认工作簿中确实存在你请求的工作表例如默认的Sheet1。传入一个不存在的工作表名如Sheet2会被 Excel API 以找不到对象的错误返回工作簿 item IDitem_id确认传入的item_id是该工作簿正确的文件 ID。在 SharePoint / OneDrive 场景中文件 ID 与站点、路径绑定串用其他文件的 ID 会导致定位到错误对象。排查顺序建议为先确认工具调用本身成功日志无认证或网络错误再对照工作簿实际结构检查工作表名最后核对 item_id 的来源是否正确。面向 SharePoint 备份工作簿的操作与认证使用 Excel Toolkit 动作操作 SharePoint 备份文件对于存储在 SharePoint 上的 Excel 工作簿工作簿级操作应使用 Excel Toolkit 的动作因为它们走的是 Excel API而非通用文件 API。知识库明确识别出以下动作已支持剩余 Excel 用例EXCEL_CLOSE_SESSION关闭工作簿会话EXCEL_DELETE_WORKSHEET删除指定工作表EXCEL_UPDATE_WORKSHEET更新工作表结构/属性EXCEL_UPDATE_RANGE更新单元格范围值。仓库中相关 Microsoft 工具包的说明可进一步印证Excel 与 SharePoint、Outlook、OneDrive 等共同构成 Microsoft 生态工具包族Excel toolkit slug 为excel见 ts/packages/cli/src/generated/toolkit-slugs.ts。关于 SharePoint 侧的操作细节如share_point与sharepoint_graph是两套不同 API 家族、Subsite 路径、客户端凭据证书认证等可参阅同目录下的 docs/kb/articles/toolkits-sharepoint.md那里对 SharePoint REST 与 Graph 的资源作用域差异、/teams/site路径前缀、以及SHARE_POINT_UPLOAD_FILE等上传方式有更完整的说明。Excel 认证复用共享的 Microsoft 认证指南Excel 的认证配置与 SharePoint、Microsoft Teams、Outlook 共用同一套 Microsoft 认证指南即 Outlook 认证页面composio.dev/auth/outlook。也就是说在 Composio 中为 Excel 创建连接时遵循与其他 Microsoft 工具包一致的 Entra 应用注册、权限scope与重定向配置流程同一个认证配置思路可复用于 SharePoint、Microsoft Teams、Outlook 与 Excel减少重复配置成本。需要注意的是虽然认证指南共享但不同 Microsoft 工具包对**资源作用域audience**的要求可能不同。以 SharePoint 为例其知识库文章明确指出 SharePoint REST 需要https://tenant.sharepoint.com/.default这类 SharePoint 资源令牌而 Graph 工具包需要Sites.*、Files.*等 Graph 权限不能把 Graph 作用域塞进 SharePoint REST 的认证配置否则会得到 401详见 docs/kb/articles/toolkits-sharepoint.md。Excel 连接时也应确认所配置的 Entra 应用已授予 Excel/Graph 相关的正确 API 权限。保持 Excel 工具 Schema 与版本处于最新状态升级包含美元符号dollar-sign参数的旧 Schema较旧版本的 Excel Schema 可能暴露包含$符号的顶层参数名这类参数名会被部分模型提供商model provider拒绝导致工具调用在模型侧即失败。当前 Schema 已不再使用这些非法的顶层参数名。处置方式当在某个版本的 Excel Schema 中看到$开头的参数名例如$select、$filter这类 OData 风格参数名出现在顶层时直接升级到最新可用版本升级后重新拉取工具 Schema确认顶层参数名已恢复正常、模型可以正常接收。使用当前版本获取列格式化与换行能力通用**列格式化column formatting与换行wrapping**及相关工作表操作在当前版本 Excel Toolkit 中已经可用。如果在某个动作的 Schema 中找不到这些能力先切换到最新 Toolkit 版本再检查若仍然缺失再考虑是工具版本、连接配置还是目标文件类型如.xls与.xlsx的问题。版本敏感问题的通用排查路径在 SDK 中指定ComposioToolSet的 toolkit 版本参数或通过平台侧的版本选择器切换 Excel Toolkit 版本然后重新拉取动作列表对比 Schema 差异。附录仓库证据与延伸阅读本文主体依据docs/kb/articles/toolkits-excel.md 与知识库源文件 docs/kb/source/toolkits/excel/public.md面向 Agent 的引导页版本docs/content/kb/guide/toolkits-excel.mdx含 keywords、topics、toolkitSlugs 等元数据便于检索系统收录Excel Toolkit slug 定义ts/packages/cli/src/generated/toolkit-slugs.tsMIME 类型映射.xls→application/vnd.ms-excel、.xlsx→application/vnd.openxmlformats-officedocument.spreadsheetml.sheetpython/composio/utils/mimetypes.py可用于理解上传时文件类型判定SharePoint 相关工作簿操作与认证细节docs/kb/articles/toolkits-sharepoint.mdMicrosoft 平台 OAuth 相关知识docs/kb/articles/platform-microsoft-oauth.md。实践要点回顾写values永远用二维数组且单格双层包裹上传工作簿优先用worksheet_names/worksheet_data结构化数据EXCEL_GET_RANGE报错先查工作表名与item_idSharePoint 上的工作簿操作走 Excel API 动作Excel 认证复用 Microsoft 共享指南遇到$参数名或缺失列格式化/换行能力时升级到最新 Toolkit 版本。【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Composio Excel Toolkit 实战指南：二维数组传参、结构化工作簿上传与 Microsoft 认证/Schema 维护
Composio Excel Toolkit 实战指南二维数组传参、结构化工作簿上传与 Microsoft 认证/Schema 维护【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio导读本指南面向在 Composio 平台上通过 Excel Toolkit 构建 AI Agent 的开发者系统讲解三类高频问题如何向 Excel 工作簿动作传入合法输入、如何基于 SharePoint 备份的工作簿执行读写操作、以及如何让 Microsoft 认证配置与工具 Schema 始终处于最新可用状态。读完本文你将掌握EXCEL_UPDATE_RANGE的二维数组传参规则、worksheet_names/worksheet_data结构化上传用法、EXCEL_GET_RANGE失败时的排查路径以及 Excel 工具包在版本升级与认证配置上的维护要点。本文内容以仓库中的 docs/kb/articles/toolkits-excel.md 为主体骨架并辅以仓库源码与知识库资料进行印证。向 Excel 工作簿动作传入合法输入以二维数组传递范围值EXCEL_UPDATE_RANGEEXCEL_UPDATE_RANGE要求调用方把单元格值组织为二维数组外层列表代表行每一行的内层列表存放该行各单元格的值。即使只更新一个单元格也必须做两层包裹例如{values: [[92]]}这个形状对应 Excel 的 range 语义Excel 的 range 天然是行 × 列的矩阵[[92]]表示 1 行 1 列。如果只传92或[92]工具无法确定该值落在哪一行哪一列就会导致参数校验失败或写入位置错误。据此可以推断Toolkit 在执行更新前会按该二维结构把values映射到目标 range 的每个单元格因此调用方在组装 payload 时应当先确认目标 range 的行列维度与二维数组的外层/内层长度一致。使用结构化工作簿数据完成上传Composio 的 Excel 工具在上传场景采用了重构后的工具形态不再要求调用方或 LLM 直接提供二进制工作簿内容而是通过worksheet_names与worksheet_data两个列表/字典参数传入结构化数据由工具在上传前自动生成.xlsx文件。这意味着 Agent 的编排逻辑可以更贴近业务数据worksheet_names声明要生成的工作表名称列表如[Sheet1, Summary]worksheet_data与工作表一一对应的数据内容每个工作表的数据同样遵循行 × 列的二维结构。仓库知识库源文件 docs/kb/source/toolkits/excel/public.md 对上述两条规则有完全一致的描述可作为排障时的权威依据。上传成功后返回结果中会包含新工作簿的标识如 item ID供后续EXCEL_GET_RANGE、EXCEL_UPDATE_RANGE等动作继续引用。EXCEL_GET_RANGE 失败的常见原因工作表名与 item_id当EXCEL_GET_RANGE看似失败而工具本身工作正常时优先核对两个输入工作表名worksheet name确认工作簿中确实存在你请求的工作表例如默认的Sheet1。传入一个不存在的工作表名如Sheet2会被 Excel API 以找不到对象的错误返回工作簿 item IDitem_id确认传入的item_id是该工作簿正确的文件 ID。在 SharePoint / OneDrive 场景中文件 ID 与站点、路径绑定串用其他文件的 ID 会导致定位到错误对象。排查顺序建议为先确认工具调用本身成功日志无认证或网络错误再对照工作簿实际结构检查工作表名最后核对 item_id 的来源是否正确。面向 SharePoint 备份工作簿的操作与认证使用 Excel Toolkit 动作操作 SharePoint 备份文件对于存储在 SharePoint 上的 Excel 工作簿工作簿级操作应使用 Excel Toolkit 的动作因为它们走的是 Excel API而非通用文件 API。知识库明确识别出以下动作已支持剩余 Excel 用例EXCEL_CLOSE_SESSION关闭工作簿会话EXCEL_DELETE_WORKSHEET删除指定工作表EXCEL_UPDATE_WORKSHEET更新工作表结构/属性EXCEL_UPDATE_RANGE更新单元格范围值。仓库中相关 Microsoft 工具包的说明可进一步印证Excel 与 SharePoint、Outlook、OneDrive 等共同构成 Microsoft 生态工具包族Excel toolkit slug 为excel见 ts/packages/cli/src/generated/toolkit-slugs.ts。关于 SharePoint 侧的操作细节如share_point与sharepoint_graph是两套不同 API 家族、Subsite 路径、客户端凭据证书认证等可参阅同目录下的 docs/kb/articles/toolkits-sharepoint.md那里对 SharePoint REST 与 Graph 的资源作用域差异、/teams/site路径前缀、以及SHARE_POINT_UPLOAD_FILE等上传方式有更完整的说明。Excel 认证复用共享的 Microsoft 认证指南Excel 的认证配置与 SharePoint、Microsoft Teams、Outlook 共用同一套 Microsoft 认证指南即 Outlook 认证页面composio.dev/auth/outlook。也就是说在 Composio 中为 Excel 创建连接时遵循与其他 Microsoft 工具包一致的 Entra 应用注册、权限scope与重定向配置流程同一个认证配置思路可复用于 SharePoint、Microsoft Teams、Outlook 与 Excel减少重复配置成本。需要注意的是虽然认证指南共享但不同 Microsoft 工具包对**资源作用域audience**的要求可能不同。以 SharePoint 为例其知识库文章明确指出 SharePoint REST 需要https://tenant.sharepoint.com/.default这类 SharePoint 资源令牌而 Graph 工具包需要Sites.*、Files.*等 Graph 权限不能把 Graph 作用域塞进 SharePoint REST 的认证配置否则会得到 401详见 docs/kb/articles/toolkits-sharepoint.md。Excel 连接时也应确认所配置的 Entra 应用已授予 Excel/Graph 相关的正确 API 权限。保持 Excel 工具 Schema 与版本处于最新状态升级包含美元符号dollar-sign参数的旧 Schema较旧版本的 Excel Schema 可能暴露包含$符号的顶层参数名这类参数名会被部分模型提供商model provider拒绝导致工具调用在模型侧即失败。当前 Schema 已不再使用这些非法的顶层参数名。处置方式当在某个版本的 Excel Schema 中看到$开头的参数名例如$select、$filter这类 OData 风格参数名出现在顶层时直接升级到最新可用版本升级后重新拉取工具 Schema确认顶层参数名已恢复正常、模型可以正常接收。使用当前版本获取列格式化与换行能力通用**列格式化column formatting与换行wrapping**及相关工作表操作在当前版本 Excel Toolkit 中已经可用。如果在某个动作的 Schema 中找不到这些能力先切换到最新 Toolkit 版本再检查若仍然缺失再考虑是工具版本、连接配置还是目标文件类型如.xls与.xlsx的问题。版本敏感问题的通用排查路径在 SDK 中指定ComposioToolSet的 toolkit 版本参数或通过平台侧的版本选择器切换 Excel Toolkit 版本然后重新拉取动作列表对比 Schema 差异。附录仓库证据与延伸阅读本文主体依据docs/kb/articles/toolkits-excel.md 与知识库源文件 docs/kb/source/toolkits/excel/public.md面向 Agent 的引导页版本docs/content/kb/guide/toolkits-excel.mdx含 keywords、topics、toolkitSlugs 等元数据便于检索系统收录Excel Toolkit slug 定义ts/packages/cli/src/generated/toolkit-slugs.tsMIME 类型映射.xls→application/vnd.ms-excel、.xlsx→application/vnd.openxmlformats-officedocument.spreadsheetml.sheetpython/composio/utils/mimetypes.py可用于理解上传时文件类型判定SharePoint 相关工作簿操作与认证细节docs/kb/articles/toolkits-sharepoint.mdMicrosoft 平台 OAuth 相关知识docs/kb/articles/platform-microsoft-oauth.md。实践要点回顾写values永远用二维数组且单格双层包裹上传工作簿优先用worksheet_names/worksheet_data结构化数据EXCEL_GET_RANGE报错先查工作表名与item_idSharePoint 上的工作簿操作走 Excel API 动作Excel 认证复用 Microsoft 共享指南遇到$参数名或缺失列格式化/换行能力时升级到最新 Toolkit 版本。【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考