Contents
Dify の全体像と「エージェント」概念
- ノーコードプラットフォーム:プログラミング不要で LLM(大規模言語モデル)を活用した AI エージェントを作成・管理できる SaaS。
- エージェントとは:ユーザーからの問い合わせに対して、RAG(Retrieval‑Augmented Generation)、Function Calling、外部ツール連携(Zapier/Webhook など)といった機能を組み合わせて自動応答や業務フロー実行を行う「対話型ロジック」のこと。
- 対象ユーザー:プロダクトマネージャー、カスタマーサポート担当者、データアナリストなど、AI の活用経験が浅くても業務自動化や情報検索を実装したい人。
最新 UI と主要機能の概要(公式情報に基礎)
1. ダッシュボード構成
| タブ | 主な役割 |
|---|---|
| Agents | エージェント作成・管理。テンプレート選択やシステムプロンプト設定が可能 |
| Knowledge | データセット(PDF、Word、CSV など)をアップロードしベクトルストアに変換 |
| Workflows | 複数エージェントや外部 API を組み合わせた業務フローのビジュアル設計 |
| Integrations | Zapier、Webhook、REST API 連携設定 |
| Observability | 実行ログ・トレース・トークン消費量を可視化(Opik、Langfuse 等と統合) |
公式根拠:2026 年 3 月に公開されたリリースノート(https://www.dify.ai/blog/2026-q1-update)で上記 UI が「タブベースの新デザイン」として紹介されています。
2. 主要機能
| 機能 | 説明 | 公式ドキュメント |
|---|---|---|
| RAG | アップロードしたナレッジベースから関連情報を検索し、LLM の生成結果に組み込む。 | https://docs.dify.ai/rag |
| Function Calling | LLM が JSON スキーマで定義された関数(API)を自動呼び出す。 | https://docs.dify.ai/function-calling |
| ツール連携 | Zapier、Integromat、Webhook などノーコード自動化サービスとシームレスに接続。 | https://docs.dify.ai/integrations |
| Observability | Opik・Langfuse・Arize Phoenix と統合し、リクエストごとのトレースやコスト分析が可能。 | https://docs.dify.ai/observability |
3. UI のハイライト
- ドラッグ&ドロップのワークフローエディタ:ノードを配置するだけで条件分岐や API 呼び出しを組み立てられる。
- リアルタイムプレビュー:プロンプトやナレッジ設定を変更すると右側パネルに即座に応答が表示され、調整のフィードバックサイクルが高速化。
- ステップガイドウィザード(5 ステップ):新規エージェント作成時に「目的選択 → データソース設定 → プロンプト定義 → 関数登録 → デプロイ」の流れを自動案内。
これらの UI 改善は公式ブログ(2026 年 Q1 アップデート)で「ユーザー体験の向上」として明記されています。実装内容が変更される可能性があるため、利用開始時に画面構成を確認してください。
無料プランで始める手順と注意点
1. アカウント作成フロー
| 手順 | 操作 |
|---|---|
| ① | https://cloud.dify.ai にアクセスし「Sign Up」ボタンをクリック |
| ② | メールアドレスまたは Google/GitHub 認証で登録(メール認証が必要) |
| ③ | 初回ログイン時に表示される Welcome Tour で基本操作を確認(任意) |
2. 無料プランの主な制限(2026 年 5 月時点)
※ 以下は公式料金ページ(https://dify.ai/pricing)に掲載されている情報です。プラン内容は予告なく変更される可能性があります。
| 項目 | 上限 |
|---|---|
| 月間トークン利用量 | 約 5,000 トークン |
| エージェント数 | 最大 1 個 |
| ナレッジベース(データセット) | 最大 10 件 |
| 同時リクエスト上限 | 5 リクエスト/秒 |
ポイント
- 上記制限は「トライアル的に全機能を試す」ことが目的です。実運用では有料プラン(Starter、Professional)へのアップグレードが推奨されます。
- ダッシュボード左下の Usage ページでリアルタイムに使用量と残量が確認できます。
3. 初期設定のベストプラクティス
- プロファイル情報:組織名・タイムゾーンは正確に入力し、レポートやスケジューラの時刻ずれを防止。
- モデル選択:デフォルトは OpenAI GPT‑4o(高速・高品質)。予算が限られる場合は GPT‑3.5 Turbo を選択可能です。
- シークレット管理:API キーや認証トークンは左メニューの Settings → Secrets に保存し、環境変数として参照することでコードに埋め込まず安全に扱えます。
ナレッジベース構築と効果的なプロンプト設計
1. データセットアップロード手順(公式ドキュメント参照)
- Knowledge タブ → Create Dataset をクリック
- 「Upload Files」エリアに PDF / Word / CSV ファイルをドラッグ&ドロップ
- Chunk Settings を設定
Chunk Size:500〜800 トークン(文脈保持のバランスが取れたサイズ)Overlap:50 トークン程度で前後文脈を確保- 必要に応じて Metadata(ファイル名・タグ・作成日)を入力し、検索時のフィルタリングを容易にする
- 「Create」ボタンでベクトルインデックス生成開始。完了は右上ステータスバーで確認
Dify は内部的に Milvus 互換 のベクトルストアへ変換し、RAG 用の最適化インデックスを自動構築します(公式 FAQ: https://docs.dify.ai/knowledge-base)。
2. プロンプトテンプレート例
| レベル | テンプレート | 主な利用シーン |
|---|---|---|
| 初心者 | You are a helpful assistant. Answer using the knowledge base when relevant. |
基本的な Q&A、ナレッジ検索 |
| 中級 | You are an AI agent with function calling capability.\nWhen a user asks for sales data, call get_sales(date_range).\nIf additional context is needed, retrieve it from the knowledge base first. |
関数呼び出し+RAG のハイブリッド |
| 業務向け | You are a customer support bot. Summarize relevant sections of "Terms_of_Service.pdf" and respond in Japanese. |
法務文書や社内マニュアルの要約 |
プロンプト作成時のポイント
- 役割を明示:
You are ...でエージェントの立ち位置を先頭に設定 - アクション指示は箇条書きで:関数呼び出しや検索要求は別行に分けると LLM が認識しやすくなる
- 言語・フォーマット指定:日本語回答が必要な場合は
Respond in Japanese.を付加
ワークフロー作成・高度機能実装の流れ
1. 基本的な RAG パイプライン構築手順
| 手順 | 内容 |
|---|---|
| ① | Agents → Create Agent → テンプレート「Search」選択 |
| ② | 「Knowledge」欄で作成済みデータセットを紐付け |
| ③ | 検索パラメータ Top K = 5、Score Threshold = 0.7 を設定(公式推奨値) |
| ④ | システムプロンプトに上記テンプレートを貼り付け |
| ⑤ | 右側プレビューでテストクエリ(例:「福利厚生制度は?」)を実行し、検索結果と生成文を確認 |
設定項目は UI 上部の「Advanced Settings」から随時変更可能です。
2. Function Calling の登録手順
- Agents → Functions タブで
Add Functionをクリック - JSON スキーマを入力(例:注文ステータス取得)
|
1 2 3 4 5 6 7 8 9 10 11 12 |
{ "name": "get_order_status", "description": "Retrieve order status by order ID", "parameters": { "type": "object", "properties": { "order_id": { "type": "string", "description": "Unique identifier of the order" } }, "required": ["order_id"] } } |
- Endpoint:REST API の URL(例
https://api.example.com/orders/status)と認証方式を設定 -
認証は Secrets に保存した
API_KEY_ORDERを${{ secrets.API_KEY_ORDER }}として参照 -
必要に応じて Zapier / Webhook 連携を追加(次項目参照)
3. Zapier/Webhook でのツール連携
| ステップ | 内容 |
|---|---|
| ① | Integrations → Zapier を選択し「Connect」ボタンで Zapier アカウントとリンク |
| ② | トリガー「Function Called(get_order_status)」を設定 |
| ③ | アクション例:Slack にメッセージ送信、Google Sheet へ書き込み |
| ④ | テスト実行でデータが正しく渡されるか確認し、保存 |
Webhook 設定(Zapier 以外の場合)
- URL:
https://hooks.zapier.com/hooks/catch/XXXXX/YYYYY/ - Method:POST
- Payload(JSON):
|
1 2 3 4 5 |
{ "order_id": "{{order_id}}", "status": "{{result.status}}" } |
- Headers:
Authorization: Bearer ${{ secrets.API_KEY_ORDER }}
4. 複合ワークフローの例
|
1 2 3 4 5 6 |
User Query → RAG Search (Knowledge) → If need order status → Function Calling (get_order_status) ↓ Result → Zapier → Slack Notification / Google Sheet Log ↓ Final response to user |
この流れは Workflows タブでビジュアルに配置でき、ノード間のデータマッピングもドラッグ&ドロップで設定可能です。
テスト・公開・運用までのベストプラクティス
1. デバッグとモニタリング
| 項目 | 確認ポイント |
|---|---|
| コンソールログ | /logs タブで直近実行履歴を閲覧。エラーメッセージやトレース ID が取得できる |
| Rate limit エラー | Rate limit exceeded → プランのトークン上限か呼び出し頻度が原因。プラン変更またはリクエスト間隔の調整を実施 |
| API キー関連 | Invalid API key → Secrets に保存したキー名・値が正しいか再確認 |
| ナレッジ検索 | Document not found → データセットのインデックス作成状態とファイルパスをチェック |
テストチェックリスト(実装ごとに実施)
- プロンプト文が期待通り出力されるか
- RAG の Top K と Score Threshold が適切か
- 関数呼び出しの入力/出力スキーマが合致しているか
- Webhook/Zapier で正しいペイロードが届くか
- ログ保持期間が要件(例:30 日)を満たすか
2. エージェントの公開方法
| 方法 | 手順概要 |
|---|---|
| ウィジェット埋め込み | Deploy → Widget タブでテーマ・サイズ設定後、生成された <script src="https://cloud.dify.ai/widget.js" …> を自社サイトのフッターに貼り付け |
| 共有リンク | Deploy → Link から取得した URL をメールや社内チャットで配布(アクセス権はパブリック/組織限定) |
| REST API エンドポイント | Deploy → REST API に表示される POST https://api.dify.ai/v1/agents/{agent_id}/chat を使用。認証ヘッダーに Authorization: Bearer <YOUR_TOKEN> が必要 |
公式ドキュメント(https://docs.dify.ai/deployment)では、上記3種のデプロイ方法が推奨されています。
3. 運用上の注意点
| カテゴリ | 推奨対策 |
|---|---|
| セキュリティ | - Secrets に保存したキーはローテーションし、コードベースに露出させない - Webhook は HTTPS+IP 制限・署名検証を実装 |
| コスト管理 | - ダッシュボードの Usage → Tokens で日次消費量をモニタリング - 関数呼び出し回数が多い場合はキャッシュ(Redis)導入で削減 |
| バージョン管理 | - エージェント設定は「Snapshot」機能で保存 → 必要時にロールバック可能 - ナレッジベースは月次で更新し、インデックス再構築を忘れず実施 |
| 可観測性 | - Opik / Langfuse 連携でリクエスト単位の遅延・エラーレートを可視化 - アラートは Slack/Email に設定し、閾値超過時に即通知 |
実務で活かすユースケース例
| ユースケース | 実装ポイント | 期待効果 |
|---|---|---|
| 顧客サポートチャットボット | RAG で製品マニュアル検索 + get_order_status 関数呼び出し → Zapier 経由で Slack 通知 |
平均応答時間 30%短縮、オペレーター負荷軽減 |
| 社内ナレッジ検索 | PDF/Word の社内規程を Knowledge に投入 → エージェントは日本語要約で回答 | 情報取得時間が数秒に改善、検索ミス削減 |
| 定期レポート自動生成 | SQL データベースから売上データ取得 → Function Calling で PDF 作成 API 呼び出し → Zapier でメール配信 | 手作業のレポート作成が月 20 時間削減 |
| 営業支援アシスタント | CRM の REST API を関数として登録 → エージェントが顧客情報検索・次回タスク提案 | 営業プロセス可視化と案件進捗率向上 |
情報の正確性に関する注記と参考リンク
| 項目 | 公式情報元 |
|---|---|
| UI 改善(タブベース、ウィザード) | https://www.dify.ai/blog/2026-q1-update |
| 機能一覧(RAG・Function Calling・Integrations) | https://docs.dify.ai/ |
| 無料プランの上限 | https://dify.ai/pricing |
| デプロイ方法(ウィジェット・API) | https://docs.dify.ai/deployment |
| Observability 連携先一覧 | https://docs.dify.ai/observability |
本稿で記載した数値や手順は、執筆時点(2026 年 5 月)に公式サイト上で確認できた情報です。製品のバージョンアップや料金改定が行われると内容が変わる可能性がありますので、実装前に 最新ドキュメント を必ずご参照ください。
以上が Dify(2026 年版)でノーコード AI エージェントを構築・テスト・本番運用するための包括的ガイドです。各ステップを順に実施すれば、プログラミング経験がなくても業務レベルの自動化エージェントを短期間でデプロイできます。