Composio Webflow 工具包实战指南Collection 草稿/发布管理、工具版本与弃用端点排查【免费下载链接】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 开源仓库中 Webflow 工具包的官方知识库文档docs/kb/source/toolkits/webflow/public.md围绕三个高频实战问题展开如何用is_draft参数创建/更新 Collection 条目、新增页面类工具如WEBFLOW_GET_PAGE为何需要显式指定工具包版本以及 Webflow v1 弃用端点导致的发布站点集成失败如何定位。读完本文你将掌握在 AI Agent 中可靠编排 Webflow CMS 内容、规避版本陷阱并快速定位发布类故障的完整方法。背景Composio 中的 Webflow 工具包概览在 Composio 中Webflow 以独立工具包toolkit的形式暴露给 Agent 调用。根据 docs/public/data/toolkits.json 中的工具包元数据当前仓库记录的 Webflow 工具包具备如下特征工具数量共 60 个工具toolCount: 60覆盖 CMS Collection、站点页面、资源资产、电商订单、Webhook 等领域认证方式同时支持OAUTH2与API_KEY两种模式authSchemes: [OAUTH2, API_KEY]工具包版本仓库数据中记录的版本为20260826_00属于按日期命名的发布版本version: 20260826_00触发事件当前为 0triggerCount: 0。工具包元数据同时给出了完整的认证配置细节OAuth2 模式webflow_oauth必填client_id、client_secret可选oauth_redirect_uri默认指向https://backend.composio.dev/api/v1/auth-apps/add以及scopes默认申请范围包括assets:read,assets:write,authorized_user:read,cms:read,cms:write,custom_code:read,custom_code:write,forms:read,forms:write,pages:read,pages:write,sites:read,sites:write。这些 scope 恰好覆盖下文涉及的 CMS 与 Pages 操作权限API Key 模式webflow_api_key仅需在连接账户初始化时提供generic_api_key该 Key 在 Webflow「Site settings → Apps integrations → API access」中创建按站点维度授权所需 scope且仅在创建时显示一次。从源码结构看官方知识库指南 docs/content/kb/guide/toolkits-webflow.mdx 与知识库文章 docs/kb/articles/toolkits-webflow.md 均由该 source 文档渲染/派生而来主题被归类为errors-and-troubleshooting错误与故障排查与toolkits-and-providers由此可见这份文档的定位是面向实战故障场景的运维级知识。创建或更新 Collection 条目用 is_draft 控制草稿/发布状态Webflow CMS 的内容条目存在草稿draft与已发布live两种状态。官方知识库给出的操作原则非常明确创建条目用WEBFLOW_CREATE_COLLECTION_ITEM更新条目用WEBFLOW_UPDATE_COLLECTION_ITEM_V2并通过is_draft参数决定条目落位。创建条目WEBFLOW_CREATE_COLLECTION_ITEM根据工具包元数据docs/public/data/toolkits.json 中的WEBFLOW_CREATE_COLLECTION_ITEM定义该工具必填参数为collection_id与field_data其中必须包含name和slug可选参数is_draft用于控制新条目是草稿还是直接发布collection_id可以通过WEBFLOW_LIST_COLLECTIONS工具获取关键约束field_data中的键必须使用 Collection schema 中精确的字段 slug而不是显示名称display name。官方建议先调用WEBFLOW_GET_COLLECTION获取完整 schema再据此构造字段键避免因字段名不匹配导致创建失败。更新条目WEBFLOW_UPDATE_COLLECTION_ITEM_V2 与旧版弃用更新已有条目时官方知识库明确要求使用WEBFLOW_UPDATE_COLLECTION_ITEM_V2并警告旧的WEBFLOW_UPDATE_COLLECTION_ITEM已经弃用deprecated。工具包元数据印证了这一版本关系WEBFLOW_UPDATE_COLLECTION_ITEM名称即标注(Deprecated)走的是PATCH /collections/{collection_id}/items端点要求item_id为 24 位十六进制 MongoDB ObjectId且只能更新已存在的条目、不能创建新条目WEBFLOW_UPDATE_COLLECTION_ITEM_V2则使用 single-item PATCH 端点支持更新字段值、draft 状态或 archive 状态需要cms:writescope。因此在新代码中请直接选用_V2版本避免命中已被标记弃用的旧工具。发布语义的边界基础创建/更新 ≠ 单独的发布端点知识库文档特别强调了一个容易混淆的边界如果客户明确需要 Webflow v2 提供的单条目 publish/live专用端点应将其视为独立的发布条目支持能力而不是基础创建/更新流程的一部分。在 Composio 工具包中这类能力由专门的发布类工具承担WEBFLOW_PUBLISH_COLLECTION_ITEMS将一条或多条 staged 条目发布上线支持item_ids简单发布也支持带cms_locale_ids的多语言站点发布WEBFLOW_CREATE_LIVE_COLLECTION_ITEM/WEBFLOW_UPDATE_LIVE_COLLECTION_ITEM直接创建/更新并立即生效到 live 站点的条目WEBFLOW_UNPUBLISH_LIVE_COLLECTION_ITEM及复数版本将已发布条目下线并回置isDrafttrue。建议的编排策略是需要先审阅后上线的内容走draft 创建/更新 → 单独调用发布工具的流程需要即时可见的运营内容如促销信息可直接使用 Live 系列工具。版本陷阱新增页面工具找不到时显式指定工具包版本知识库文档指出的第二个高频问题是工具版本漂移当通过 API 调用一个较新加入的 Webflow 工具例如WEBFLOW_GET_PAGE时可能得到工具不存在的错误。原因在于Composio 的 Webflow 工具包存在一个基础版本00000000_00base version它可能早于某个新工具加入的日期版本若调用时未显式携带工具包/工具版本请求可能回落到旧版本从而找不到新增工具因此对于新加入的工具必须在 API 调用中显式传入 Composio 当前展示的最新 Webflow 工具包版本。仓库数据印证了版本演进的现实工具包元数据中记录的版本是20260826_00而 Webflow 工具数量多达 60 个其中确实包含较新加入的页面类工具。以WEBFLOW_GET_PAGE为例其定义为按page_id检索单个 Webflow 页面的元数据标题、slug、SEO/OpenGraph 设置、草稿/发布状态、本地化与分支信息需要pages:readscope同类新增工具还包括WEBFLOW_LIST_PAGES审计站点结构、构建站点地图与WEBFLOW_UPDATE_PAGE基于 v2 稳定端点更新页面标题、slug、SEO、Open Graph 元数据需要pages:writeOAuth scope。在 SDK/API 层实操时应通过工具包查询接口先获取最新的 Webflow toolkit 版本号例如20260826_00再将该版本随工具调用一起传入而不是依赖默认版本。这一显式版本化做法同样适用于其他快速迭代的工具包。发布失败排查v1 弃用端点与 WEBFLOW_PUBLISH_SITE第三个主题是发布站点publish-site集成失败的典型根因集成方仍在使用 Webflow 已弃用的 v1 端点。当 Webflow 调用因使用了不受支持或已弃用的端点而失败时应按以下顺序排查确认失败动作是否为旧的 v1 Webflow 工具——检查报错动作的 slug若属于老版本 v1 工具则是弃用端点命中切换到当前的WEBFLOW_PUBLISH_SITE动作并搭配当前最新工具包版本重试若失败依旧将失败的 tool-call 日志 IDlog ID提供给 Composio 支持团队以便基于执行链路进一步定位。从 docs/public/data/toolkits.json 中的WEBFLOW_PUBLISH_SITE定义可以补充其行为细节底层调用 Webflow v2 端点POST /v2/sites/{site_id}/publish必填site_id可选指定 custom domain ID 列表或选择发布到默认 Webflow 子域用于将站点内容、设计、结构的全部 staged 变更正式发布上线速率限制每分钟最多 1 次成功发布Rate limit: 1 successful publish per minute在编排批量发布任务时必须考虑该限制否则会触发限流。结合前文版本要点这里存在双重叠加因素既可能是 v1 端点被弃用也可能是旧工具包版本中不存在 v2 的WEBFLOW_PUBLISH_SITE。因此**换最新版本 换当前动作必须同时执行**缺一不可。排查完毕后保留失败的 tool-call 日志 ID 是联系支持时的重要凭据便于复现与定位具体执行链路。附Webflow 故障定位速查清单场景推荐动作需要留意的约束新建 Collection 条目WEBFLOW_CREATE_COLLECTION_ITEM可带is_draftfield_data键必须用 schema 字段 slug先WEBFLOW_GET_COLLECTION确认更新已有条目WEBFLOW_UPDATE_COLLECTION_ITEM_V2旧版WEBFLOW_UPDATE_COLLECTION_ITEM已弃用单条目发布/下线WEBFLOW_PUBLISH_COLLECTION_ITEMS等发布类工具属独立发布能力区别于基础创建/更新调用新增工具报找不到显式传入最新 Webflow 工具包版本基础版本00000000_00可能早于新工具加入时间发布站点失败改用WEBFLOW_PUBLISH_SITE 最新版本v1 端点已弃用发布速率限制为每分钟 1 次问题持续存在提供失败 tool-call 日志 ID 联系 Composio 支持日志 ID 是定位执行链路的关键凭据以上清单所涉及的完整工具定义、认证字段与版本号均可在 docs/public/data/toolkits.json 的 Webflow 工具包条目中逐一核对官方知识库原文见 docs/kb/source/toolkits/webflow/public.md其渲染版本见 docs/content/kb/guide/toolkits-webflow.mdx 与 docs/kb/articles/toolkits-webflow.md。实际接入时请始终以仓库中该工具包当前展示的最新版本号与工具定义为准。【免费下载链接】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），仅供参考