技能介绍

解决什么问题

Fillout 表单的录入、更新和查询大多是重复劳动：运营人员要在不同的表单之间来回搬运数据，批量创建记录时尤其容易出错——手动复制粘贴不仅慢，还可能因字段遗漏或重复提交导致数据不一致。当表单数量增长后，这类操作会占用大量人力，而且很难追踪每一步到底有没有成功。

这个技能的目标就是把这类操作交给程序来完成：让 Agent 通过 Rube MCP 调用 Composio 的 Fillout 工具包（toolkit 文档见 composio.dev/toolkits/fillout_forms），以工具调用的方式读写表单数据，并把多个操作串成自动化工作流。

核心能力与工作方式

技能本身不直接封装 Fillout 的 API，而是建立在 Rube MCP 之上，典型工作流程如下：

工具发现：任何操作开始之前，先调用 RUBE_SEARCH_TOOLS 检索当前可用的 Fillout 工具 slug、输入 schema、推荐执行步骤以及已知的边界情况，避免硬编码可能已经变化的工具名。
连接管理：通过 RUBE_MANAGE_CONNECTIONS 指定 toolkit fillout_forms 建立或检查 Fillout 连接；未激活时按返回的授权链接完成 OAuth 配置，确认状态为 ACTIVE 后才继续。
执行操作：用 RUBE_MULTI_EXECUTE_TOOL 执行发现到的工具 slug，完成单步或组合操作。
多步骤工作流：复杂任务先搜索全部相关工具，按依赖顺序执行（例如先 fetch 再 update），并把上一步的返回数据传给下一步；批量任务交给 RUBE_REMOTE_WORKBENCH，在其内部循环调用 run_composio_tool()，可配合 ThreadPoolExecutor 做并行处理。

几个常见模式值得留意：创建类操作之前先搜索已有资源，避免重复提交；列表类操作支持分页，需要检查返回中的 next_cursor 或 page_token 并一直翻到底；工具返回 error 时先确认连接仍处于 ACTIVE 状态，过期则通过 RUBE_MANAGE_CONNECTIONS 重新授权。

适用边界与注意点

schema 会变化：不要跳过 RUBE_SEARCH_TOOLS 直接写死工具名；当返回 schemaRef 而非 input_schema 时，应改用 RUBE_GET_TOOL_SCHEMAS 拉取完整 schema 再传参。
连接状态敏感：OAuth token 过期会直接导致调用失败，长时间运行的工作流应在每一步前确认连接状态。
频率限制：遇到 rate limit 错误需要降低请求频率并加入退避策略，批量场景尤其要注意。
前置条件：客户端需要配置 Rube MCP 服务端点（https://rube.app/mcp，无需 API key），且 Composio Fillout toolkit 连接已完成授权，否则技能无法工作。