すべてのプロダクト
Search
ドキュメントセンター

Microservices Engine:XXL-JOB を使用した Dify ワークフローのスケジュール

最終更新日:Jun 07, 2025

このトピックでは、XXL-JOB が提供する Dify ワークフローをスケジュールするための主要な機能と、詳細な手順について説明します。

背景情報

Dify ワークフローは、時間ベースのスケジューリングが必要な幅広いビジネスシナリオに適しています。サンプルシナリオ:

  • リスク監視:リスクデータを毎分スキャンし、大規模言語モデル(LLM)を使用して潜在的なリスクイベントを分析し、タイムリーにアラートをトリガーします。

  • データ分析:財務データを毎日取得し、LLM を使用してデータを分析し、投資家に投資アイデアを提供します。

  • コンテンツ生成:毎日の作業内容を自動的に要約し、日報を生成します。

重要

Dify ワークフローは、ネイティブでは時間ベースのスケジューリングをサポートしていません。ワークフローのスケジューリングとステータス監視には、XXL-JOB を使用できます。

主要機能

XXL-JOB は、Dify ワークフローをスケジュールするために、次の主要機能を提供します。

  • Dify ワークフロー:インターネット経由のセルフマネージド Dify ワークフローと、仮想プライベートクラウド(VPC)経由の Alibaba Cloud Dify ワークフローがサポートされています。

  • 柔軟な時間設定:cronapifixed_ratefixed_delayone_time 時間タイプ、カスタムタイムゾーン、カスタムカレンダーがサポートされています。

  • エンタープライズレベルのアラートと監視

    • 柔軟なアラートポリシー:ジョブレベルの障害アラート、タイムアウトアラート、成功通知、インスタンスレベルおよびアプリケーションレベルでのしきい値トリガーアラートがサポートされています。

    • 複数のメッセージ通知方法:テキストメッセージ、電話、Webhook、メールがサポートされています。

  • エンタープライズレベルの可観測性

    • スケジューリングダッシュボード:スケジューリング、成功、失敗の曲線を含む、インスタンスレベルおよびアプリケーションレベルのスケジューリングステータスが表示されます。

    • 実行履歴:ステータス、基本情報、入力と出力、消費時間、トークン消費量を含む、Dify ワークフローの実行履歴が記録されます。

    • スケジューリングイベント:ワークフロー関連およびノード関連のイベントを含む、各 Dify ワークフローのスケジューリングイベントが記録されます。

    • ノードトラッキング:すべてのノードの実行結果を含む、Dify ワークフローの 1 回の実行に関する情報が記録されます。ループノード、反復ノード、および条件付き分岐ノードのドリルダウンがサポートされています。

前提条件

手順

1. (オプション)Dify サービスの API サーバーの内部エンドポイントを構成する

  1. Container Service for Kubernetes(ACK)コンソール にログインします。

  2. [クラスター] ページの左側のナビゲーションウィンドウで、クラスター名をクリックして、Dify サービスがデプロイされているクラスターにアクセスします。

  3. 左側のナビゲーションウィンドウで、[ネットワーク] > [サービス] を選択します。次に、[作成] をクリックします。

  4. サービスの作成ダイアログボックスで、[サービスの種類][SLB] を選択し、[アクセス方法] ドロップダウンリストから [内部アクセス] を選択し、[バックエンド]componentproxy を入力します(次の図を参照)。次に、他のパラメーターを構成し、[OK] をクリックします。

    image

    image

  5. API サーバーの内部エンドポイントが生成されていることを確認します。

    image

2. Dify ワークフローを作成する

  1. Dify コンソールにログインし、右上隅にある [Studio] をクリックし、[テンプレートから作成] を選択してワークフローを作成します。

  2. MSE コンソール にログインし、上部のナビゲーションバーでリージョンを選択します。

  3. 左側のナビゲーションウィンドウで、[タスクスケジューリング] > [XXL-JOB バージョン] を選択します。

  4. 目的のインスタンスの ID をクリックします。左側のナビゲーションウィンドウで、[タスク管理] をクリックします。表示されるページで、[タスクの作成] をクリックします。「タスクの作成」パネルで、[ジョブの種類][Dify ワークフロー] を選択します。ジョブの作成方法の詳細については、「ジョブ管理」をご参照ください。

    image

    1. [エンドポイント]:このパラメーターを、Dify ワークフローに対応する API サーバーのエンドポイントに設定します。[API サーバーのエンドポイント] は、Dify コンソールにログインした後、[API アクセス] ページの右上隅から取得できます。Alibaba Cloud セルフマネージド Dify ワークフローを使用する場合は、「1. (オプション)Dify サービスの API サーバーの内部エンドポイントを構成する」の説明に従って、パラメーター値を内部エンドポイントに変更することをお勧めします。

    2. [API キー]:このパラメーターを、Dify ワークフローの API キーに設定します。ワークフローごとにキーが異なります。[API アクセス] ページの右上隅にある [API キー]ヒント: をクリックして取得できます。

    3. [入力]:ワークフローの入力を JSON 形式で入力します。入力は、Body 内の inputs の値と同じです。

      image

      次のコードは、inputs パラメーター値の例を示しています。

      {"input_text": "what is your name"}

3. 結果を確認する

  1. 作成したジョブを見つけ、[操作] 列の [1 回実行] をクリックして、手動でテストを実行します。

    image

  2. 作成したジョブの [操作] 列の [詳細] をクリックします。表示されるリストで、[スケジューリングレコード] を選択して、ジョブ実行レコードを表示します。

    image

  3. ジョブの [操作] 列の [詳細] をクリックして、[基本情報][入力と出力][追跡] タブでワークフロー情報を表示します。

    • 基本情報タブ

      image

    • 入力と出力タブ

      image

    • 追跡タブ。反復ノード、ループノード、および分岐ノードが関係している場合は、ドリルダウンがサポートされています。

      image

      image