Difyでエージェントを作る｜エージェントアプリとエージェントノードの違い

Difyでのエージェントの作り方は、2026年10月時点で少し複雑です。以前からあるエージェントの機能に加えて、ベータ版の新しい Agent が出ているためです。この記事では両方を整理します。

この記事の内容は、2026年10月2日に Dify の公式ドキュメントで確かめたものです。新しい Agent はベータ版のため、仕様が変わることがあります。使う前に、末尾の出典で最新の内容を確かめてください。

Difyでエージェントを作る2つの方法

Difyのエージェントは、モデルが自分で考え、次に何をするかを決め、必要なときにツールを使う仕組みです。使い方は2つに分かれます。

• 単独で動かす：チャット形式のアプリとして公開し、利用者と直接やり取りする
• ワークフローの中で動かす：Workflow や Chatflow にエージェントノードを置き、処理の1ステップを任せる

それぞれに、以前からある形とベータ版の形があります。以前からある Agent アプリは、公式ドキュメントで Legacy Agent app と呼ばれています。ベータ版の新しい Agent は、Agents の画面で一度作れば、単独のアプリとしてもワークフローの中でも使えます。

Anthropic は、エージェントを作るときは、まずいちばん単純な方法を探し、必要なときだけ複雑にするよう勧めています。エージェント型の仕組みは、性能と引き換えに、応答の遅さや費用が増えやすいとも説明しています。決まった手順で済む処理なら、ワークフローで組む方法も検討します。

エージェントアプリの作り方

以前からある Agent アプリ

Studio でアプリを作るときに、種類で Agent を選びます。設定するのは、プロンプト、ツール、ナレッジです。1つの会話で保つ履歴は、500件のメッセージか2,000トークンまでです。

• プロンプト：役割、出力の形、制約に加え、どのツールをいつ使うかを名前で書く
• ツール：Dify のツールを追加する。認証が要るツールは、資格情報を選ぶか作る
• Maximum Iterations：考える、ツールを呼ぶ、結果を処理する、の繰り返しの上限。上げると時間とトークンの費用が増える
• ナレッジ：モデルがナレッジの説明文を読み、検索するかを自分で決める。説明文は詳しく書く

ベータ版の新しい Agent

Agents の画面で Create から Create from Blank を選び、名前を付けます。作成と管理には、Editor 以上の権限が要ります。Configure で、モデル、プロンプト、スキル、ファイル、ツールを設定します。

新しい Agent は、自分専用のサンドボックスの中で動きます。容量は20GBです。コマンドを実行し、プログラムを入れ、ファイルを読み書きします。設定した道具を呼ぶだけでなく、決まりきらない作業も任せられます。やってほしいことを会話で伝えて、エージェント自身に設定を作らせる Build mode もあります。

サンドボックスはクラウドで動くため、社内ネットワークのページやファイルには届きません。社内の資料を使わせたいときは、エージェントの Files に追加します。

エージェントノードの使い方

エージェントノードは、ワークフローの中でエージェントを1ステップとして動かすノードです。これにも2つの形があります。

以前からあるエージェントノード

Workflow と Chatflow で使えます。エージェントの考え方（Agent Strategy）、モデル、ツール、指示、Query を設定します。指示の中では、前のノードの変数を Jinja2 の書き方で使えます。Query には、エージェントに取り組ませる入力を入れます。

Max Iterations は、無限に繰り返さないための上限です。公式ドキュメントの目安では、単純な作業は3〜5回、複雑な調べものは10〜15回です。

Memory では、前のメッセージをどれだけ覚えておくかを決めます。多くするほど文脈は増えますが、トークンの費用も増えます。出力には、最終的な答えのほか、ツールの結果、考えた手順、繰り返した回数、成功したかどうかが含まれます。

ベータ版の新しいエージェントノード

新しいエージェントノードは、Workflow のアプリだけで使えます。公開済みのエージェントを招くか、そのノードだけで使うエージェントをその場で作ります。招いたエージェントは、Agents の画面で更新を公開すると、使っているすべてのワークフローに反映されます。

ノードでは Agent task に、このステップでしてほしいことだけを書きます。前のノードから渡す変数は文字として届き、2,000文字で切られます。長い内容は、ファイルとして渡します。出力は標準では text の1つです。必要なら、名前と型を決めた出力を追加できます。

ツールの追加：組み込みツールとカスタムツール

ツールは Integrations の Tools でまとめて管理します。種類は4つです。

• Tool Plugin：Dify やコミュニティが用意したツール。Current Time のようにすぐ使えるものと、Marketplace から入れるものがある。Google や GitHub などは先に認証が要る
• Swagger API：OpenAPI（Swagger）の仕様を読み込むと、ツールの入口を自動で作る。プラグインのないサービスをつなぐときに使う
• Workflow：User Input から始まる Workflow をツールにする。Chatflow はツールにできない
• MCP：MCPサーバーをつなぎ、そのツールを取り込む。HTTP で通信するサーバーだけに対応する

エージェントノードでは、ツールごとに説明を書きます。エージェントは、この説明を読んでツールを使うかどうかを決めます。どの場面で使うかまで書いておくと、迷いにくくなります。MCPの仕組みはAIエージェントとMCPで説明しています。

Function CallingとReActの違い

エージェントがツールを呼ぶ方法は2つあります。Agent アプリでは、使うモデルに合わせて、どちらかが Agent Settings に自動で表示されます。エージェントノードでは、Agent Strategy として選びます。

公式ドキュメントは、考える力が強く、ツール呼び出しにもともと対応しているモデルを選ぶよう勧めています。いつツールを使うか、どのツールが合うか、結果をどう読むかを、モデルが判断するためです。ReAct は考えた手順がはっきり残るため、動きを追いたいときにも使えます。

動作確認とログの見方

Agent アプリでは、画面右のプレビューで試します。Debug as Multiple Models を使うと、最大4つのモデルの答えを並べて比べられます。ワークフローでは、テスト実行の後に Run History で確かめます。

• Run History：結果、入力と出力、ノードごとの実行の順番と時間を見られる。ノードの Last run で、そのノードの直近の入出力も見られる
• Logs：公開後の実際の使われ方を見る。Agent アプリでは、ツールを呼んだ繰り返しの中身まで開ける。トークンの量と応答時間も分かる
• 注釈：質問と、直した答えを組にして登録できる

Sandbox プランでは、ログは30日で消えます。後から見返したいやり取りは、早めに確かめます。Chatflow と Workflow の作業画面での試し実行は、Logs には残りません。

Dify の基本はDifyの使い方で、ワークフローの2つの種類はDifyのチャットフローとワークフローの違いで説明しています。

作ったエージェントを Employee Store に出品する

Employee Store は、開発者が作ったAIエージェントを、会社が買い切りや月額で導入できるマーケットプレイスです。形式は問いません。Dify で作ったエージェントも掲載できます。掲載料と初期費用はかかりません。手数料は成約金額の20%で、成約したときだけ発生します。詳しくは出品者向けの案内をご覧ください。