make-module-configuring

Make 模块配置

此技能介绍如何配置 Make 场景中的各个模块。确定场景的模块组成后（参见 make-scenario-building），必须配置每个模块：分配连接、填写参数、映射上游模块的数据，并连接特殊组件（Webhook、数据存储、密钥）。

已知 Make 模块 ID：Make Code 模块的 "module": "code:ExecuteCode"。

快速导航

阅读与当前任务相匹配的参考文件：

任务	参考
配置任意模块（从这里开始）	General Principles — 5 阶段工作流：读取接口、解析组件、运行 RPC、填写参数/映射器、验证
设置或分配连接	Connections — 凭据请求流程、范围检查、提取蓝图组件
创建或分配 Webhook	Webhooks — 自定义与品牌 Webhook、数据结构定义
创建或分配数据存储	Data Stores — 需要先创建数据结构
定义数据结构（架构）	Data Structures — 字段类型、嵌套结构
配置密钥或证书	Keys — 通过凭据请求配置 SSH、PEM/PFX
编写 IML 表达式	IML Expressions — 函数、变量、运算符、反引号规则
在模块间映射数据	Mapping — 模块 ID 引用、输出架构发现
添加筛选条件	Filtering — 运算符、AND/OR 分组、放置规则
配置聚合器	Aggregators — feeder/target、变体、配置顺序例外
配置 AI Agent 模块	AI Agents — 工具数组、由 AI 决定的字段、恢复元数据

核心规则

以下规则适用于每个模块配置。违反其中任何一条都是导致场景出错的最常见原因。

1. 先读取接口。 配置任何模块前，先调用 app-module_get 并设置 outputFormat: "instructions"。切勿猜测参数名称、类型或结构。

2. 验证每个模块。 组装好每个模块的配置后，调用 validate_module_configuration。如果验证返回错误，请勿继续——没有例外。

3. 组件创建顺序。 依次创建数据结构、Webhook、连接、密钥、数据存储（依赖关系从左向右）。连接和密钥需要凭据请求（由用户完成身份验证）；Webhook、数据存储和数据结构可直接通过 MCP 创建。

4. 从左向右配置。 从上游开始，向下游推进，以便映射时可以使用输出架构。**例外：**数组聚合器需要先配置目标模块——参见 Aggregators。

5. 交互式选择连接。 始终向用户展示所有匹配的连接，并让用户选择。即使只有一个匹配项，也切勿自动选择。参见 Connections。

6. 更新时省略未写入的字段。 对于更新、upsert 和 patch 模块，应从 mapper 中省略所有需要保持不变的字段——切勿使用空字符串 ""。空字符串映射会覆盖目标记录中的现有值，在可视化编辑器中看起来与“未映射”相同，而且 validate_module_configuration 不会检测到这一问题。参见 Mapping → 更新和 Upsert 中的字段省略。

官方文档

• 模块设置
• 模块类型

相关技能

• make-scenario-building — 选择要使用的模块，并了解如何将其组合成流程（路由、分支、筛选、迭代、聚合、错误处理）
• make-mcp-reference — MCP 服务配置、范围、访问控制