make-module-configuring

モジュール設定

このスキルでは、Make シナリオ内の個々のモジュールを設定する方法を説明します。シナリオのモジュール構成を決めたら（make-scenario-building を参照）、各モジュールを設定する必要があります。接続を割り当て、パラメーターを入力し、上流のモジュールからデータをマッピングして、特殊なコンポーネント（Webhook、データストア、キー）を接続します。

既知の Make モジュール ID：Make Code モジュールは "module": "code:ExecuteCode" です。

クイックルーティング

現在のタスクに合ったリファレンスファイルを確認してください。

タスク	リファレンス
任意のモジュールを設定する（ここから開始）	一般原則 — 5 段階のワークフロー：インターフェースの確認、コンポーネントの特定、RPC の実行、パラメーター／マッパーの入力、検証
接続を設定または割り当てる	接続 — 認証情報のリクエストフロー、スコープの確認、Blueprint コンポーネントの抽出
Webhook を作成または割り当てる	Webhook — カスタムとブランド付き、データ構造の定義
データストアを作成または割り当てる	データストア — 先にデータ構造が必要
データ構造（スキーマ）を定義する	データ構造 — フィールドの型、ネストされた構造
キーまたは証明書をプロビジョニングする	キー — 認証情報のリクエストによる SSH、PEM/PFX
IML 式を記述する	IML 式 — 関数、変数、演算子、バッククォートのルール
モジュール間でデータをマッピングする	マッピング — モジュール ID の参照、出力スキーマの検出
フィルター条件を追加する	フィルタリング — 演算子、AND/OR のグループ化、配置ルール
アグリゲーターを設定する	アグリゲーター — フィーダー／ターゲット、バリエーション、設定順序の例外
AI エージェントモジュールを設定する	AI エージェント — ツール配列、AI が決定するフィールド、メタデータの復元

基本ルール

これらはすべてのモジュール設定に適用されます。いずれかに違反すると、シナリオが壊れることがよくあります。

1. まずインターフェースを確認してください。 モジュールを設定する前に、outputFormat: "instructions" を指定して app-module_get を呼び出してください。パラメーター名、型、構造を決して推測しないでください。

2. すべてのモジュールを検証してください。 各モジュールの設定を組み立てた後に、validate_module_configuration を呼び出してください。検証でエラーが返された場合は、例外なく先に進まないでください。

3. コンポーネントを作成する順序。 データ構造、Webhook、接続、キー、データストアの順です（依存関係は左から右に進みます）。接続とキーには認証情報のリクエストが必要です（ユーザーが認証を完了します）。Webhook、データストア、データ構造は MCP 経由で直接作成できます。

4. 左から右に設定してください。 マッピングに使用する出力スキーマを利用できるよう、上流から下流へと作業します。例外： 配列アグリゲーターでは、先にターゲットモジュールを設定する必要があります。アグリゲーターを参照してください。

5. 接続の選択は対話形式で行います。 一致する接続をすべて必ずユーザーに提示し、選択してもらってください。一致する接続が 1 つしかない場合でも、自動選択しないでください。接続を参照してください。

6. 更新時は、書き換えないフィールドを省略してください。 更新、アップサート、パッチの各モジュールでは、そのままにするフィールドを mapper から省略してください。空文字列 "" として含めてはいけません。空文字列のマッピングは対象レコードの既存値を上書きし、ビジュアルエディターでは「マッピングなし」と見分けがつかず、validate_module_configuration でも検出されません。マッピング → 更新およびアップサート時のフィールド省略を参照してください。

公式ドキュメント

• モジュールの設定
• モジュールの種類

関連スキル

• make-scenario-building — 使用するモジュールと、それらをフローに組み込む方法（ルーティング、分岐、フィルタリング、反復、集約、エラー処理）
• make-mcp-reference — MCP サーバーの設定、スコープ、アクセス制御