コード - Dify Docs

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

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

設定

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

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

言語サポート

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

Python
JavaScript

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

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

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

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

再試行設定 では、設定可能な間隔（最大 5000ms）で最大 10 回の自動再試行が可能です。一時的な処理問題の対処にこれを有効にしてください。 エラーハンドリング では、コード実行が失敗した場合のフォールバックパスを定義でき、コードが問題に遭遇してもワークフローの実行を継続できます。

出力検証と制限

コード出力は厳格な制限で自動的に検証されます：

文字列：最大長 80,000 文字、null バイトは削除されます
数値：-999999999 から 999999999 の範囲、浮動小数点数は小数点以下 10 桁に制限
オブジェクト/配列：複雑なネスト構造を防ぐため最大深度 5 レベル

これらの制限により、パフォーマンスが確保され、ワークフローでのメモリー問題が防止されます。

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

ファイルシステムへのアクセス、ネットワークリクエスト、システムコマンドを防ぐ厳格なサンドボックス内で実行されます。これにより、プログラミングの柔軟性を提供しながらセキュリティが維持されます。セキュリティ上の理由から、一部の操作は自動的にブロックされます。システムファイルへのアクセスや潜在的に危険な操作の実行を試みることは避けてください：

コードが保存されない場合は、ブラウザのネットワークタブを確認してください - セキュリティフィルタが潜在的に危険な操作をブロックしている可能性があります。

依存関係サポート

コードノードは、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) };
}

サンドボックス環境には標準的なパッケージ一式が事前インストールされています。その範囲外のインポートは実行時に失敗します。

​設定

​言語サポート

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

​出力検証と制限

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

​依存関係サポート

設定

言語サポート

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

出力検証と制限

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

依存関係サポート