コード

データ処理のためのカスタム Python または JavaScript の実行

このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。

コードノードは、カスタム Python または JavaScript を実行して、ワークフロー内で複雑なデータ変換、計算、ロジックを処理します。事前設定されたノードが特定の処理ニーズに十分でない場合に使用してください。

コードノード設定インターフェース

コード実行ノードを使うには、SANDBOX_ENABLE_NETWORK が true（デフォルト）である必要があります。false の場合、すべてのコード実行ノードが network is disabled, please enable it in the configuration というエラーで失敗します。

​

設定

入力変数 を定義してワークフロー内の他のノードからデータにアクセスし、これらの変数をコード内で参照します。関数は、宣言した出力変数 を含む辞書を返す必要があります。

def main(input_variable: str) -> dict:
    # 入力を処理
    result = input_variable.upper()
    return {
        'output_variable': result
    }

​

言語サポート

ニーズと習熟度に基づいて、Python と JavaScript から選択できます。どちらの言語も、データ処理用の一般的なライブラリにアクセス可能な安全なサンドボックス内で実行されます。

Python

Python にはjson、math、datetime、reなどの標準ライブラリが含まれています。データ分析、数学的演算、テキスト処理に最適です。

def main(data: list) -> dict:
    import json
    import math
    
    average = sum(data) / len(data)
    return {'result': math.ceil(average)}

JavaScript

JavaScript は標準の組み込みオブジェクトとメソッドを提供します。JSON 操作と文字列演算に適しています。

function main(data) {
    const processed = data.map(item => item.toUpperCase());
    return { result: processed };
}

​

エラーハンドリングと再試行

失敗したコード実行に対する自動再試行動作を設定し、コードがエラーに遭遇した場合のフォールバック戦略を定義します。

エラーハンドリング設定オプション

失敗時再試行 では、最大 10 回まで自動で再試行できます。再試行の間隔は最大 5000ms まで設定できます。一時的な処理の問題に対処するには、これを有効にしてください。

エラーハンドリング では、コード実行が失敗した場合のフォールバックパスを定義でき、コードが問題に遭遇してもワークフローの実行を継続できます。

再試行設定インターフェース

​

出力制限

出力が次のいずれかの制限を超えると、ノードは失敗します。

出力	デフォルトの制限	変数
文字列の長さ	400,000 文字	CODE_MAX_STRING_LENGTH
数値	±9,223,372,036,854,775,807。これより大きな数値（非常に長い ID など）は文字列として返してください。	CODE_MAX_NUMBER、CODE_MIN_NUMBER
小数点以下の桁数	20	CODE_MAX_PRECISION
オブジェクトのネストの深さ	5 階層	CODE_MAX_DEPTH
array[string] 出力の要素数	30	CODE_MAX_STRING_ARRAY_LENGTH
array[object] 出力の要素数	30	CODE_MAX_OBJECT_ARRAY_LENGTH
array[number] 出力の要素数	1,000	CODE_MAX_NUMBER_ARRAY_LENGTH

デフォルトでは、object 型の出力の中に、さらに 3 階層までオブジェクトをネストできます。ノードの出力そのものが 1 階層目に数えられ、配列は階層に含まれません。

結果が制限を超えた場合は、出力を減らすか、制限を引き上げて ください。

​

セキュリティ上の考慮事項

サンドボックス内のコードからも、Dify デプロイ内の他のサービスには接続できます。そのため、信頼できるコードだけを実行してください。信頼できないコードを実行する場合は、デプロイの管理者に依頼して、先に サンドボックスのネットワークを隔離 してもらってください。

​

依存関係サポート

コードノードは、Python と JavaScript 両方の外部依存関係をサポートします：

# Python: numpy、pandas、requests などをインポート
import numpy as np
import pandas as pd

def main(data: list) -> dict:
    df = pd.DataFrame(data)
    return {'mean': float(np.mean(df['values']))}

// JavaScript: lodash、moment などをインポート
const _ = require('lodash');

function main(data) {
    return { unique: _.uniq(data) };
}

依存関係はサンドボックス環境に事前インストールされています。Dify インストールで利用可能なパッケージリストを確認してください。