SuperAPI AI 工具集

make-automation

智能体与模型

查看项目

更新于 10-15 10:22

技能介绍

用途

该技能用于通过 Rube MCP(Composio)自动化 Make(原 Integromat)的相关操作。它把 Make 的部分能力封装为可通过 MCP 调用的工具,适合在智能体或自动化流程中查询 Make 的操作数据、语言枚举与时区枚举。

主要能力

当前 Make 工具集包含以下工具:

  • MAKE_GET_OPERATIONS:获取操作记录,可用于检索 Make 场景的操作日志或用量数据。
  • MAKE_LIST_ENUMS_LANGUAGES:列出所有支持的语言代码。
  • MAKE_LIST_ENUMS_TIMEZONES:列出所有支持的时区标识符。

使用方式

前置条件

  • Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用)。
  • 通过 RUBE_MANAGE_CONNECTIONS 建立 toolkit 为 make 的 Make 连接,且状态为 ACTIVE。
  • 每次调用前应先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

设置步骤

  1. 获取 Rube MCP:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥,添加端点即可使用。
  2. 确认 RUBE_SEARCH_TOOLS 有响应,以验证 Rube MCP 可用。
  3. 调用 RUBE_MANAGE_CONNECTIONS,toolkit 使用 make。
  4. 若连接不是 ACTIVE,按返回的授权链接完成 Make 认证。
  5. 确认连接状态为 ACTIVE 后再运行任何工作流。

核心工作流

  1. 获取操作数据

    • 适用场景:用户希望从 Make 场景中检索操作日志或用量数据。
    • 工具序列:MAKE_GET_OPERATIONS(必需)。
    • 关键参数:通过 RUBE_SEARCH_TOOLS 查看当前 schema 以了解可用过滤器;可能包含日期范围、场景 ID 或状态过滤器。
    • 注意事项:操作数据可能分页,需检查分页令牌;日期过滤器必须符合 schema 要求的格式;结果集较大时应按日期范围或场景过滤。
  2. 列出可用语言

    • 适用场景:用户希望查看 Make 场景或界面支持的语言。
    • 工具序列:MAKE_LIST_ENUMS_LANGUAGES(必需)。
    • 关键参数:无必需参数,返回完整语言列表。
    • 注意事项:语言代码遵循标准 locale 格式(如 'en'、'fr'、'de');列表为静态且很少变化,可缓存结果。
  3. 列出可用时区

    • 适用场景:用户希望查看用于调度 Make 场景的受支持时区。
    • 工具序列:MAKE_LIST_ENUMS_TIMEZONES(必需)。
    • 关键参数:无必需参数,返回完整时区列表。
    • 注意事项:时区标识符使用 IANA 格式(如 'America/New_York'、'Europe/London');列表为静态且很少变化,可缓存结果;配置场景调度时应使用这些确切的时区字符串。
  4. 场景配置查找

    • 适用场景:用户需要使用正确的语言和时区值配置场景。
    • 工具序列:MAKE_LIST_ENUMS_LANGUAGES(必需)、MAKE_LIST_ENUMS_TIMEZONES(必需)。
    • 关键参数:两次调用均无需参数。
    • 注意事项:在配置中使用语言和时区值前,务必对照这些枚举进行验证;使用无效值会导致场景配置出错。

常见模式

  • 枚举验证:在配置任何接受语言或时区的 Make 场景属性前,先调用 MAKE_LIST_ENUMS_LANGUAGES 或 MAKE_LIST_ENUMS_TIMEZONES,验证目标值存在于返回列表中,并使用枚举列表中的确切字符串值。
  • 操作监控:调用 MAKE_GET_OPERATIONS 并带日期范围过滤,分析操作数量、状态和错误率,识别失败操作以便排查。
  • 枚举缓存策略:语言和时区列表为静态,可在工作流开始时调用一次 MAKE_LIST_ENUMS_LANGUAGES,将结果存入内存或本地缓存,用缓存值验证用户输入,仅在开始新会话时刷新缓存。
  • 操作分析工作流:调用 MAKE_GET_OPERATIONS 并带近期日期范围,按场景 ID 分组操作,计算每个场景的成功/失败比例,识别错误率高的场景,并向用户或通知渠道报告结果。
  • 与其他工具集集成:Make 工作流常连接其他应用。可组合多工具工作流:调用 RUBE_SEARCH_TOOLS 查找目标应用的工具,通过 RUBE_MANAGE_CONNECTIONS 连接所需工具集,使用 Make 操作数据理解工作流执行模式,再通过各应用工具集直接执行等效工作流。

适用场景

  • 查询 Make 场景的操作日志与用量数据。
  • 在配置 Make 场景前校验语言与时区取值。
  • 对 Make 场景进行健康监控与错误率分析。
  • 将 Make 操作数据与其他应用工具集组合,构建多工具自动化流程。

限制与注意事项

  • 工具集有限:Composio 中的 Make 工具集目前工具较少(操作、语言、时区)。完整的场景管理(创建、编辑、运行场景)需考虑使用 Make 原生 API。应始终调用 RUBE_SEARCH_TOOLS 检查是否有新工具,工具集可能随时间扩展,需定期复查。
  • 操作数据:活跃账户的操作记录量可能很大,应始终按日期范围过滤以避免获取过多数据;操作计数与 Make 的定价层级和配额使用相关;失败操作应排查,可能表明场景配置问题。
  • 响应解析:响应数据可能嵌套在 data 键下;枚举列表返回包含 code 和 label 字段的对象数组;操作数据包含场景执行的嵌套元数据;解析时应做防御性处理,为可选字段提供回退。
  • 速率限制:Make API 对每个 API 令牌有速率限制;避免对同一端点快速重复调用;枚举结果(语言、时区)很少变化,应缓存;操作查询应使用有针对性的日期范围。
  • 认证:Make API 使用基于令牌的认证;令牌可能有不同的权限范围;部分操作数据可能因令牌范围受限;需确认已认证用户有权访问目标组织。

快速参考

任务 工具 Slug 关键参数
获取操作 MAKE_GET_OPERATIONS 查看 schema 了解过滤器
列出语言 MAKE_LIST_ENUMS_LANGUAGES 无
列出时区 MAKE_LIST_ENUMS_TIMEZONES 无

替代方案

由于 Make 工具集工具有限,常见 Make 用例可考虑以下替代方式:

Make 用例 替代方式
触发场景 直接使用 Make 原生 webhook 或 API 端点
创建场景 直接使用 Make 的场景管理 API
调度执行 使用 RUBE_MANAGE_RECIPE_SCHEDULE 组合工作流
多应用工作流 通过 RUBE_MULTI_EXECUTE_TOOL 组合各工具集工具
数据转换 使用 RUBE_REMOTE_WORKBENCH 进行复杂处理

组合等效工作流:不必仅依赖 Make 工具集,可直接构建等效自动化:识别 Make 场景涉及的应用;通过 RUBE_SEARCH_TOOLS 搜索每个应用的工具;连接所有所需工具集;使用各应用工具逐步构建工作流;通过 RUBE_CREATE_UPDATE_RECIPE 保存为 recipe 以便复用。