このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。
新しい Agent は Community Edition のベータ機能です。ランタイムは Docker Compose デプロイに同梱され、デフォルトで有効です。本番環境では、
DIFY_AGENT_SERVER_SECRET_KEY と DIFY_AGENT_API_TOKEN を独自のランダムな値に置き換えてください。Agent の作成
Agents ページで 作成 > 最初から作成 をクリックし、Agent に名前を付けます。必要に応じて、「リサーチアシスタント」のようなロールや説明も入力します。残りはすべて 設定 で形づくります。 共有された DSL ファイルから Agent を作成する場合は、代わりに DSL ファイルをインポート を選択します。DSL ファイルにスキルとファイルは含まれません。Agent の作成と管理には、エディター以上のロールが必要です。
能力の設定
各能力を手動で設定することも、ビルドモード で実現したいことをチャットで伝えながら構築することもできます。 設定 で指定した内容はすべて Agent の能力として保存され、以後のあらゆるタスクで使われます。これとは別に、Agent は専用の「サンドボックス」の中で動作し、作業を進めながらコマンドの実行やファイルの操作を行います。 Agent の能力を変更できるのはここだけです。公開済みの Agent にエンドユーザーがプロンプト、スキル、ツールの変更を求めても、Agent は応じません。モデル
Agent の実行に使うチャットモデルを選びます。推論に強く、ツール呼び出しをネイティブにサポートするモデルがおすすめです。Agent は、いつ行動するか、どのツールが適しているか、結果をどう読み取るかを自分で判断する必要があるためです。Agent の出来はモデルしだいで大きく変わります。できるだけ新しいモデルを選んでください。古いモデルはサンドボックスを使いこなせないことが多く、必要な場面でもコマンド実行やツールのインストールを行わないのが典型的な症状です。
プロンプト
プロンプトでは、Agent のロールと仕事の進め方を定めます。どのように推論するか、いつツールやナレッジに頼るか、何を避けるかを具体的に書いてください。 押さえておきたい項目：- ペルソナと目標：Agent が演じる役割と、達成を目指すゴール。
- 進め方：典型的なタスクで期待する手順や順序。
- ツールとファイルの使い方：それぞれを使う場面（名前を挙げて明示）。
- 出力：望む形式、長さ、トーン。
-
プロンプト内で参照する：
/で参照を挿入すると、使ってほしいまさにその箇所で、Agent をその対象へ直接導けます。特定のステップが特定の対象に依存する場合に向いています。 - セクションに追加するだけ：いつ使うかは Agent 自身に判断させます。一手一手を指示するより、Agent の判断を信頼したい場合に向いています。
スキル
「スキル」は、Agent 向けにパッケージ化する自己完結型の手順書です。1 つの専門タスクのための指示、参考資料、スクリプトをひとまとめにし、一度定義すれば繰り返し使えます。 プロンプトが Agent の全体的なロールを定めるのに対し、スキルは特定のタスクで必要になったときだけ取り出す作業手順、いわば有能な人材に渡す SOP です。Agent 側は汎用的な能力を、スキル側はその仕事専用の手順、資料、ツールを持ち寄ることで、期待どおりの成果につながります。 たとえばmarketing-copy というスキルにスタイルガイド、ブランド素材、チェックリストをまとめておけば、毎回説明し直す必要がなくなります。
スキルパッケージは、50 MB 以内の .zip または .skill ファイルで、SKILL.md が入っている必要があります。フォーマットの詳細や作成方法は、Agent Skills を参照してください。ビルドモード で Agent にスキルを作成させることもできます。
ファイル
ファイルは、仕様書、テンプレート、ガイドラインなど、Agent が作業中に参照できるドキュメントです。スキルと違い、実行する手順ではなく、読むための資料です。 ファイルは、Agent に全文を読ませて忠実に従わせたい少数のドキュメントに向いています。大量の資料から検索させたい場合は、ナレッジベース を接続してください。 サイズ上限はファイルタイプごとに異なり、いずれもデフォルト値を 環境変数 で調整できます。ここで追加したファイルは、Agent の能力の一部として保存されます。一方、Agent がサンドボックス内に作成したファイルは、タスクが終わると消去されます。
ツール
Dify ツール を持たせると、Agent はチャットの外でも行動できるようになります。ワークスペースにあるプラグイン、カスタム API、ワークフロー、MCP サーバーを利用できます。一部のツールは使用前に認証が必要です。ナレッジ検索
Agent が作業中に検索できる ナレッジベース を接続します。 検索ではクエリに関連する内容だけを取り込むため、ファイル には収まらない大量の資料にも対応できます。ナレッジベースはワークスペース共有の資産でもあり、他のアプリから使えるほか、データソースと同期させておくこともできます。 ナレッジベースごとにクエリの方法を設定します：- エージェントが決定：Agent が会話から自分で検索クエリを作成します。 質問が多岐にわたり、何を調べるかを Agent に判断させたい場合に最適です。ユーザーが尋ねた内容を何でも検索するドキュメントアシスタントなどが典型です。
- カスタムクエリ：毎回実行する固定クエリを指定します。 ソースを常に同じ方法で検索させたい場合に最適です。質問の言い回しによらず必ず返品ポリシーを参照する、返品対応アシスタントなどが典型です。
-
Rerank：リランクモデルで結果を関連度順に並べ替えます。または、意味の一致とキーワード一致のバランスを取る ウェイト設定 を使うこともできます。
ウェイト設定が表示されるのは、接続したすべてのナレッジベースが高品質インデックスを使い、同じ埋め込みモデルを共有し、外部ナレッジベースを含まない場合だけです。経済的インデックスや外部ナレッジベース、別の埋め込みモデルが 1 つでもあると、このオプションは表示されません。
- トップ K：リランク後に残す結果の最大数です。
- スコア閾値：結果の採用に必要な最小の類似度です。高くするほど厳しく絞り込み、低くするほど幅広く拾います。
詳細設定
環境変数 は、実行中の Agent が読み取れるキーと値のペアです。ツールが必要とするエンドポイントや API キーなどに使います。 環境変数は Agent のサンドボックス内に保持されます。そのため、プロンプトに書かずに、コマンドラインツールやスキルへシークレットを渡す手段になります。値を Secret に指定するとマスク表示のまま保てます。.env ファイルをインポートすれば、複数の変数を一度に追加できます。
ビルドモード で Agent に設定させることもできます。
チャットによるビルド
すべてを手動で設定する代わりに、Agent にさせたいことを言葉で伝えて構築できます。チャットを進めると、Agent が自らスキル、ファイル、環境変数を設定していきます。 たとえば、最初のメッセージは次のように書けます。破棄 で戻るのは設定だけです。Agent がサンドボックス内ですでに行った操作（プログラムのインストールなど）は元に戻りません。
ビルドノート
Agent は作業しながら、設定した内容を「ビルドノート」（build_note.md）に記録します。このファイルは、最初に 適用 した時点で ファイル に表示されます。
作業中のファイルと異なり、ビルドノートは Agent のセットアップと一緒に保存されます。Agent は新しい会話を始めるたびにこのノートを読み込み、プロンプト と組み合わせて自らの指示とします。
適用したら、ビルドノートを開いて Agent が記録した内容を確認してください。
- 望んだ内容が揃っていれば、それで完了です。
-
記載を変えたい場合は、ビルドモードで Agent に修正させます。
Agent が更新するのは、自動生成されたビルドノートだけです。ダウンロードして再アップロードした複製はただのファイルとして扱われ、次のビルドチャットでは新しいノートが別途生成されます。
- 足りない内容があれば、プロンプト に追記します。
- 記録をいちからやり直したい場合は、ファイル でノートを削除します。
公開
編集内容はドラフトとして自動保存されます。Agent の準備ができたら公開して、そのバージョンを本番にします。バージョン履歴はいつでも開けるので、以前のバージョンの確認や復元もできます。バージョンを復元しても、巻き戻るのは Agent の設定だけです。サンドボックス環境にはバージョン管理がなく、インストールしたツールなどの環境への変更はそのまま残ります。
Agent の API はストリーミングにのみ対応しています。API アクセスのオン・オフを切り替えられるのは、ワークスペースのオーナーと管理者だけです。