Contents
注意点と更新方針
Dify アカウント作成とスタジオへのアクセス
Dify の AI エージェントを実務に組み込む第一歩は、公式サイトでアカウントを取得し、スタジオ画面へ遷移することです。ここではサインアップ手順と、ログイン後に最初に目にするメニュー構成を解説します。日本語サイト利用者向けに「Start Free Trial」ボタンの日本語表示例（「無料トライアル開始」）も併記しています。
アカウント登録手順
以下の流れでアカウントを作成できます。各ステップは画面上部に常に案内が表示されるので、迷うことはありません。
- 公式サイト dify.ai にアクセスし、右上の 「無料トライアル開始」（英語表記は Start Free Trial）ボタンをクリック。
- 氏名・メールアドレス・希望パスワードを入力し 「Sign Up」 を実行。
- 受信した認証メールに記載されたリンクを開き、パスワード設定画面で再度同じパスワードを入力して完了。
スタジオ画面の概要
ログイン後は上部メニューに 「Studio」 タブが出現し、左側パネルに主要機能が配置されます。初回アクセス時に表示される 3 つのセクションの役割を簡潔にまとめました。
-
Create
新規エージェントや RAG（Retrieval‑Augmented Generation）パイプラインを作成する入口です。ここから全ての開発が始まります。 -
Templates
用意されたテンプレート一覧が表示されます。カスタマーサポート・FAQ ボットなど、業務シーンに合わせたベースをすぐに選択できます。 -
Settings
アカウント情報や API キー管理、モデルプロバイダー設定など、環境全体の構成を行う領域です。
モデル API の設定（クラウド版・ローカルセルフホスト）
AI エージェントが利用する生成モデルは 「クラウド版」 と 「ローカルセルフホスト」 の二つに大別されます。どちらを選択すべきかはコスト、データプライバシー、運用リソースの観点で判断します。本節では両者の設定手順と注意点をまとめました。
クラウド版モデルプロバイダー登録
クラウドプランでは外部ベンダー（OpenAI、Anthropic など）の API キーを登録するだけで利用できます。手順は次の通りです。
- Studio → Settings → Model Providers を開く。
- 「Add Provider」ボタンをクリックし、目的のベンダー（例：OpenAI）を選択。
- 発行済み API キーと使用したいモデル名（例：
gpt‑4o）を入力し 「Save」 を実行。
登録が完了すると、エージェント作成画面のモデル選択プルダウンに対象モデルが自動的に表示されます。
ローカル環境でのセルフホスト手順
ローカルで Dify を走らせる場合は Docker Compose によりサービスを起動し、独自エンドポイントを「Custom」プロバイダーとして登録します。要点だけ抜粋すると以下のようになります。
Docker Compose 設定例
|
1 2 3 4 5 6 7 8 |
services: dify: image: langgenius/dify:latest ports: - "3000:3000" environment: - MODELS__LOCAL__ENDPOINT=http://host.docker.internal:8000/v1 |
モデルエンドポイント登録手順
- Studio → Settings → Model Providers に移動。
- 「Add Provider」から 「Custom」（または 「Local」）を選択。
- エンドポイント URL（例：
http://localhost:8000/v1）と認証トークンを入力し 「Save」。
ローカル版はインフラ管理が必要ですが、月額費用がかからずデータ完全自社保管が実現できます。詳細な手順は Zenn 記事（こちら）をご参照ください。
エージェント作成 UI フローと基本設定
エージェントの開発は「Create」タブから始まります。ここでは「最初から作成」→「エージェント選択」の具体的な操作手順と、テンプレート活用時のポイントを解説します。
「最初から作成」→「エージェント選択」の操作手順
- Studio の左メニュー で 「Create」 をクリックし、「Create from scratch」 ボタンを選択。
- 表示された App Type カードの中から 「Agent」 をクリック。
- Template Gallery が開くので、業務に近いテンプレート（例：Customer Support）を選ぶ。
- エージェント名・アイコン・簡単な説明文を入力し 「Create」 を確定。
この操作でエージェント編集画面が表示され、システムプロンプトやツール連携の設定へと進めます。
テンプレート活用のポイント
- ベースはあくまで出発点：テンプレートは構成要素（変数・ツール）を自動配置しますが、業務固有のプロンプトは必ず上書きしてください。
- 不要な要素は削除：使わないツールやデフォルト変数は画面右上の「Remove」から削除し、シンプル化することで応答速度が向上します。
- バージョン管理：テンプレートベースで作成したエージェントでも、設定変更履歴を Git 等にエクスポートしておくと、チーム間での共有が容易です。
システムプロンプト設計・変数・ツール活用
エージェントの「行動指針」を決めるシステムプロンプトは、成功の鍵となります。ここでは代表的なケース別プロンプト例と、変数・外部ツールを組み合わせた実装手順を示します。
プロンプト例と設計指針
| 目的 | 推奨プロンプト例 |
|---|---|
| 顧客サポート | 「あなたは製品Aのカスタマーサポートエージェントです。ユーザーからの問い合わせに対し、正確かつ丁寧に回答してください。個人情報は絶対に保存・共有しないこと。」 |
| データ集計 | 「社内データベースから直近30日間の売上情報を取得し、月次レポートを作成します。金額は千円単位で四捨五入し、合計と平均を算出してください。」 |
| レポート自動化 | 「毎週金曜日にプロジェクト進捗をPDFで生成し、Slack の #report チャンネルへ投稿します。テンプレートは事前定義されたものを使用し、ファイル名は『Weekly_Report_{{date}}』としてください。」 |
設計のポイント
- 目的の明示：エージェントが何をすべきかを一文で宣言するだけで、意図がブレにくくなります。
- 行動ルール：守るべき制約（例：個人情報は保存しない）を具体的に記載します。
- トーン指定：敬語・フレンドリーなど、業務シーンに合わせた口調を明示すると、ユーザー体験が統一されます。
変数設定のベストプラクティス
- スコープ選択 – セッション単位か永続（DB 保存）かを用途に応じて決定。
- デフォルト値の設定 – 未入力時のフォールバックとして必ず用意し、エラー回避を図ります。
- 型指定とバリデーション – 文字列・数値・日付など適切な型で宣言すると、Dify が自動的に入力チェックを行います。
変数は {{variable_name}} の形でプロンプトやツール呼び出しに埋め込めます。例：{{customer_name}} さん、こんにちは！
外部ツール（Tool）連携手順
- Studio → Tools → Add Tool を開く。
- Tool Name に任意の名前（例：
FetchSalesData）を入力。 - Method と Endpoint URL（ローカルは
http://localhost:8000/api/sales、クラウド版はベンダー提供のエンドポイント）を設定。 - 必要に応じて Headers/Body に認証トークンやパラメータを
{{variable}}で埋め込み、Save をクリック。
設定後はシステムプロンプト中で {{tool:FetchSalesData}} と記述するだけで、指定した HTTP リクエストが自動実行されます。外部ツール活用の具体例は Liber‑craft コラム（こちら）でも紹介されています。
エージェントのテスト・デバッグと公開設定
本番環境へ投入する前に必ず対話シミュレーションとログ解析で動作確認を行いましょう。ここではテスト手順、デバッグフロー、そして公開時の留意点をまとめます。
会話シミュレーションでのテスト方法
- Studio の左メニュー から 「Chat」 タブを選択し、エージェントとの対話画面を開く。
- テストケースとして典型的なユーザー発言（例：「注文番号 12345 の配送状況は？」）を入力。
- 期待結果が得られたか確認する。特に 変数抽出（
{{order_id}}）や 外部 API 呼び出し が成功しているかをチェック。
テスト中に不自然な応答やエラーが出た場合は、画面右側の Logs パネルで詳細情報を確認できます。
ログ活用によるデバッグフロー
- Error Log：HTTP ステータスコードや例外メッセージが表示され、API キーやエンドポイントミスを即座に特定可能。
- Trace Log：変数展開過程やツール呼び出し順序を時系列で追跡でき、プロンプトのロジック抜け漏れを発見しやすくなります。
問題が解決したら画面右上の 「Publish」 ボタンでエージェントを公開します。
公開設定と運用上の留意点
| 項目 | クラウド版 | ローカル版 |
|---|---|---|
| コスト | 月額サブスクリプション（無料トライアルあり） | インフラ運用費のみ |
| スケーリング | 自動水平スケール・ロードバランシング標準装備 | 手動でコンテナ数を増減 |
| データ保護 | Dify が提供するリージョン別ストレージ | 完全自社管理（オンプレミス対応） |
| アップデート | 常に最新バージョンが利用可能 | 自己更新が必要（Docker イメージ再ビルド） |
公開時のオプション
- Public URL：外部からアクセスできるエンドポイントを自動生成。
- Access Control：チームメンバー限定、社内全員利用、または外部公開のいずれかをロールベースで設定可能。
- 監査ログ有効化：操作履歴やアクセス状況を保存し、コンプライアンス要件に備える。
まとめと今後のメンテナンス
本ガイドは Dify の基本的な利用フロー（アカウント取得 → スタジオ設定 → エージェント作成 → テスト・公開）を網羅しています。実際の業務導入にあたっては、UI 改版や外部サービスのバージョン変化に合わせて定期的に手順を見直すことが重要です。また、外部リンク先の情報が古くなった場合は公式ドキュメントと照らし合わせて最新化してください。
Tip
変更点が頻繁にある機能（例：モデルプロバイダー設定）は、社内 Wiki に「更新チェックリスト」を作成しておくと、チーム全体で情報のズレを防げます。
この記事は2026年版をベースに執筆しましたが、Dify のリリースサイクルに合わせて随時内容を刷新してください。