Files
dify-docs/ja-jp/guides/workflow/node/llm.mdx
2025-11-17 12:15:41 +08:00

473 lines
28 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: LLM
version: '日本語'
---
### 定義
大規模言語モデルを活用して質問に回答したり、自然言語を処理したりします。
<Frame caption="LLMード">
<img src="https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/node/75a0eee463e2fd34e41010b55b47d504.png" alt="LLM 节点" />
</Frame>
***
### シナリオ
LLM は チャットフロー/ワークフロー の中心的なノードであり、大規模言語モデルの会話/生成/分類/処理などの能力を活用して、多様なタスクを提示されたプロンプトに基づいて処理し、ワークフローのさまざまな段階で使用することができます。
* **意図識別**:カスタマーサービスの対話シナリオにおいて、ユーザーの質問を意図識別および分類し、異なるフローに誘導します。
* **テキスト生成**:記事生成シナリオにおいて、テーマやキーワードに基づいて適切なテキスト内容を生成するノードとして機能します。
* **内容分類**:メールのバッチ処理シナリオにおいて、メールの種類を自動的に分類します(例:問い合わせ/苦情/スパム)。
* **テキスト変換**:テキスト翻訳シナリオにおいて、ユーザーが提供したテキスト内容を指定された言語に翻訳します。
* **コード生成**:プログラミング支援シナリオにおいて、ユーザーの要求に基づいて指定のビジネスコードやテストケースを生成します。
* **RAG**:ナレッジベースの質問応答シナリオにおいて、検索した関連知識とユーザーの質問を再構成して回答します。
* **画像理解**:ビジョン能力を持つマルチモーダルモデルを使用し、画像内の情報を理解して質問に回答します。
適切なモデルを選択し、プロンプトを記述することで、チャットフロー/ワークフロー で強力で信頼性の高いソリューションを構築できます。
***
### 設定方法
エディットページで、前のノードの末尾を右クリックするか、+ボタンを軽くタップして新しいードを追加し、LLM大規模言語モデルを選択します。
<Frame caption="LLM ノード設定 - モデル選択">
<img src="https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/node/883c0e6facbe4b9a845c331797ef8feb.png" alt="LLM ノード設定 - モデル選択" />
</Frame>
**設定手順:**
1. **モデルの選択**Difyでは、OpenAIのGPTシリーズ、AnthropicのClaudeシリーズ、GoogleのGeminiシリーズなど、世界中で広く使用されているさまざまなモデルを[サポート](/ja-jp/getting-started/readme/model-providers)しています。モデルの選択は、推論能力、コスト、応答速度、コンテキストウィンドウのサイズなどの要因に基づいて行います。使用するシーンやタスクの種類に応じて、適切なモデルを選ぶことが重要です。
<Note>
Difyを初めて使用する場合は、LLMードでモデルを選択する前に、**システム設定 - モデルプロバイダ**で[モデルの設定](/ja-jp/guides/model-configuration/readme)を事前に行う必要があります。
</Note>
2. **モデルパラメータの設定**モデルパラメータは、生成される結果を調整するために使用されます。これには、温度、TopP、最大トークン数、応答形式などが含まれます。選択肢を簡素化するために、3つの事前設定されたパラメータクリエイティブ、バランス、精密が用意されています。これらのパラメータに不慣れな場合は、デフォルト設定を選択することをお勧めします。画像解析機能を利用したい場合は、視覚能力を持つモデルを選んでください。
3. **コンテキストの入力(オプション)**コンテキストとは、LLMに提供される背景情報のことを指します。通常は、[知識検索](./knowledge-retrieval)の出力変数を記入するために使用されます。
4. **プロンプトの作成**LLMードには使いやすいプロンプト編集ページがあり、チャットモデルまたはコンプリートモデルを選択することで異なるプロンプト編集構造が表示されます。チャットモデルChat modelを選択した場合、システムプロンプトSYSTEM、ユーザーUSER、アシスタントASSISTANTの3つのセクションをカスタマイズできます。
<Frame caption="プロンプトの作成">
<img src="https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/node/0033bc271052d1b299ca876d912010c9.png" alt="编写提示词" width="352" />
</Frame>
システムプロンプトSYSTEMを作成する際にアイデアが浮かばない場合は、プロンプトジェネレーター機能を使用して、実際のビジネスシナリオに適したプロンプトを迅速に生成することができます。
<Frame caption="プロンプトジェネレーター">
<img src="https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/node/e11a18409212c4112c582a2385b3ca60.png" alt="プロンプトジェネレーター" />
</Frame>
プロンプトエディターでは、**“/”** を入力することで **変数挿入メニュー** を呼び出し、**特殊変数ブロック**や **上流ノードの変数**をプロンプトに挿入してコンテキスト内容として使用できます。
<Frame caption="変数挿入メニューを呼び出す">
<img src="https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/node/2170b741801cc8e03f0b4574d2345950.png" alt="呼出变量插入菜单" width="366" />
</Frame>
5. **上級的な設定**メモリ機能をオンにしたり、メモリウィンドウを設定したり、ビジョン機能を有効にしたり、Jinja-2テンプレート言語を使ってより複雑なプロンプトを作成したりできます。
***
### **特殊変数の説明**
**コンテキスト変数**
コンテキスト変数とは、言語モデルLLMに背景情報を提供するための特別な変数の一種で、特に知識検索のシナリオでよく利用されます。詳細については、[知識検索ノード](/ja-jp/guides/workflow/nodes/knowledge-retrieval)を参照してください。
**画像ファイル変数**
視覚機能を備えた言語モデルLLMは、アプリケーションユーザーがアップロードした画像をこの変数を通じて読み取ることができます。VISION機能を有効にした後、画像ファイルの出力変数を選択して設定を完了させてください。
<Frame caption="ビジョンアップロード機能">
{/* <img src="https://assets-docs.dify.ai/2024/11/05b3d4a78038bc7afbb157078e3b2b26.png" alt="ビジョンアップロード機能" /> */}
![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F3244742310-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FBl3K6n12AeCkG3icHwfh%252Fuploads%252Fgit-blob-782166177f09bc9c035cc63349758bcc1856c26f%252Fjp-llm-with-histories.png%3Falt%3Dmedia&width=768&dpr=2&quality=100&sign=18c08ac7&sv=1)
</Frame>
**会話履歴**
テキスト補完モデルgpt-3.5-turbo-Instruct内でチャット型アプリケーションの対話記憶を実現するために、Dify は元の[プロンプト専門モード(廃止)](/zh-hans/learn-more/extended-reading/prompt-engineering)内で会話履歴変数を設計しました。この変数はチャットフローのLLMード内でも使用され、プロンプト内に AI とユーザーの対話履歴を挿入して、LLM が対話の文脈を理解するのを助けます。
<Note>
会話履歴変数の使用は広範ではなく、チャットフロー内でテキスト補完モデルを選択した場合にのみ使用できます。
</Note>
<Frame caption="会話履歴変数の挿入">
<img src="https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/node/fd1707d32cf62f3e707cce70c83d08a1.png" alt="会話履歴変数の挿入" />
</Frame>
**モデルパラメーター**
モデルのパラメータはモデルの出力に影響を与えます。異なるモデルには異なるパラメータがあります。以下の図は`gpt-4`のパラメータリストです。
<Frame caption="モデルパラメータリスト">
<img src="https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/node/ddeb4bcd71b57c62a12a4cf35107f0b6.png" alt="模型参数列表" width="368" />
</Frame>
主要なパラメータ用語は以下のように説明されています:
* **Temperature(温度)**: 通常は0-1の値で、ランダム性を制御します。温度が0に近いほど、結果はより確定的で繰り返しになり、温度が1に近いほど、結果はよりランダムになります。
* **Top P**: 結果の多様性を制御します。モデルは確率に基づいて候補語から選択し、累積確率が設定された閾値Pを超えないようにします。
* **Presence Penalty(存在ペナルティ)**: 既に生成された内容にペナルティを課すことにより、同じエンティティや情報の繰り返し生成を減少させるために使用されます。パラメータ値が増加するにつれて、既に生成された内容に対して後続の生成でより大きなペナルティが課され、内容の繰り返しの可能性が低くなります。
* **Frequency Penalty(頻度ペナルティ)**: 頻繁に出現する単語やフレーズにペナルティを課し、これらの単語の生成確率を低下させます。パラメータ値が増加すると、頻繁に出現する単語やフレーズにより大きなペナルティが課されます。パラメータ値が高いほど、これらの単語の出現頻度が減少し、テキストの語彙の多様性が増加します。
これらのパラメータが何であるか理解できない場合は、プリセットを読み込んで、「クリエイティブ」、「バランス」、「正確」の3つのプリセットから選択することができます。
<Frame caption="加载预设参数">
<img src="https://assets-docs.dify.ai/dify-enterprise-mintlify/jp/guides/workflow/node/8e145cb795bc71172e32348678b1551c.png" alt="加载预设参数" width="367" />
</Frame>
***
### 高級機能
**記憶**記憶をオンにすると、問題分類器の各入力に対話履歴が含まれ、LLM が文脈を理解しやすくなり、対話の理解能力が向上します。
**記憶ウィンドウ**:記憶ウィンドウが閉じている場合、システムはモデルのコンテキストウィンドウに基づいて対話履歴の伝達数を動的にフィルタリングします。開いている場合、ユーザーは対話履歴の伝達数を正確に制御できます(対数)。
**対話役割名の設定**モデルのトレーニング段階の違いにより、異なるモデルは役割名のプロンプト遵守度が異なりますHuman/Assistant、Human/AI、人間/助手など)。複数のモデルに対応するために、システムは対話役割名の設定を提供しており、対話役割名を変更すると会話履歴の役割プレフィックスも変更されます。
**Jinja-2 テンプレート**LLM のプロンプトエディター内で Jinja-2 テンプレート言語をサポートしており、Jinja2 の強力な Python テンプレート言語を使用して軽量なデータ変換やロジック処理を実現できます。詳細は[公式ドキュメント](https://jinja.palletsprojects.com/en/3.1.x/templates/)を参照してください。
**失敗後の再試行**:ノードで起きる例外的な状況の中には、そのノードをもう一度試すだけで対応できるものがあります。エラーが発生した際に自動的に再試行をする機能が有効になっていれば、事前に設定された方針に従って再試行が行われます。再試行の最大回数や再試行間の時間を調整することで、再試行の方針を設定することが可能です。
- 再試行は最大で10回まで可能です
- 再試行の間隔は最長で5秒まで設定できます
![機能の概念図](https://assets-docs.dify.ai/2024/12/dfb43c1cbbf02cdd36f7d20973a5529b.png)
**エラー処理**:異なるエラー対応戦略を提供し、現在のノードが失敗してもメインプロセスを止めずにエラー通知を行うか、バックアップ経路を使ってタスクを継続できるようにします。詳細は、[エラー処理](../error-handling/README)をご覧ください。
**構造化された出力**: LLM が返すデータ形式の可用性、安定性、予測可能性を高め、エラー処理や形式変換の手間を削減します。
<Accordion title="JSONスキーマエディタ">
LLMードのJSONスキーマエディタを使用すると、LLM が返すデータ構造を定義し、出力の解析性、再利用性、制御性を保証できます。ビジュアル編集モードによる直感的な編集、コード編集モードによる詳細な調整により、様々な複雑度のニーズに対応できます。
<Info>
ードレベルの機能であるJSONスキーマは、すべてのモデルの構造化出力の定義と制約に利用できます。
- 構造化出力をネイティブでサポートするモデル: JSONスキーマを使用して構造化変数を直接定義できます。
- 構造化出力をサポートしていないモデル: システムはJSONスキーマをプロンプトとして使用します。構造に基づいたコンテンツ生成をモデルに促せますが、出力の正しい解析は保証されません。
</Info>
**JSONスキーマエディタの開き方**
LLMードの出力変数をクリックし、構造化スイッチの設定を開くと、JSONスキーマエディタが表示されます。JSONスキーマエディタはビジュアル編集ウィンドウとコード編集ウィンドウを備え、シームレスに切り替えられます。
![JSON Schema Editor](https://assets-docs.dify.ai/2025/04/646805384efa3cd85869d23a4d9735ad.png)
***ビジュアル編集***
**使用シーン**
- ネスト構造を含まない、いくつかの単純なフィールドを定義する場合。
- JSONスキーマの構文に慣れていない場合、コードを書かずに、直感的なインターフェースでドラッグアンドドロップしてフィールドを追加できます。
- フィールド構造を素早く繰り返し変更したい場合。JSONコードを毎回変更する必要はありません。
![Visual Editor](https://assets-docs.dify.ai/2025/04/a9d6a34a7903f81e4d57c7f1d8d0712b.png)
**フィールドの追加**
構造化出力枠内でフィールドを追加ボタンをクリックし、フィールドのパラメータを設定します。
- *(必須)*フィールド名
- *(必須)*フィールドタイプ: string、number、object、arrayなどのフィールドタイプをサポートしています。
> オブジェクトまたは配列フィールドには、子フィールドを追加できます。
- 説明: LLMがフィールドの意味を理解し、出力精度を向上させます。
- 必須: オンにすると、LLMはこのフィールド値を必ず返します。
- 列挙型: フィールド値の選択範囲を制限するために使用します。モデルは、あらかじめ設定された列挙値のみを返します。たとえば、`red`、`green`、`blue` のみを許可する場合は、次のようになります。
```json
{
"type": "string",
"enum": ["red", "green", "blue"]
}
```
> このルールでは、入力値は `red`、`green`、`blue` のいずれかでなければなりません。
**フィールドの編集・削除**
- フィールドの編集:フィールドカードにマウスオーバーして、「編集」アイコンをクリックし、フィールドのタイプ、説明、デフォルト値などの項目を変更します。
- フィールドの削除:フィールドカードにマウスオーバーして、「削除」アイコンをクリックすると、フィールドがリストから削除されます。
> オブジェクトまたは配列フィールドを削除すると、そのすべての子フィールドも削除されます。
**JSONデータのインポート**
1. 「JSONをインポート」ボタンをクリックし、表示されるダイアログボックスにJSONデータを貼り付けるか、アップロードします。例JSONデータ
```json
{
"comment": "This is great!",
"rating": 5
}
```
2. 「送信」ボタンをクリックすると、システムがJSONデータを自動的に解析し、JSONスキーマに変換します。
**AIでJSONスキーマを生成する**
1. 「AI生成」アイコンをクリックし、モデルGPT-4などを選択します。入力ボックスにJSONスキーマの説明を入力します。例
> 「ユーザー名、年齢、および趣味を含むJSONスキーマが必要です。」
2. 「生成」をクリックすると、システムが自動的にJSONスキーマを生成します。
```json
{
"type": "object",
"properties": {
"username": {
"type": "string"
},
"age": {
"type": "number"
},
"interests": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"username",
"age",
"interests"
]
}
```
***コードエディタ***
**使用シーン**
- 複雑なデータ構造で、ネストされたオブジェクトや配列をサポートする必要がある場合(例:注文詳細、商品一覧など)。
- 既存のJSONスキーマまたは API レスポンス例)を直接貼り付けて手動で調整したい場合。
- `pattern`(正規表現)や `oneOf`(複数タイプ)などの高度なスキーマ機能を使用したい場合。
- LLMで作成したスキーマを元に、フィールドのタイプや構造をビジネスニーズに合わせて変更したい場合。
![JSON Schema](https://assets-docs.dify.ai/2025/04/669af808dd9d0d8521a36e14db731cec.png)
**フィールドの追加**
1. コードエディタを開きます。
2. 「フィールドを追加」をクリックし、フィールドを入力します。例:
```json
{
"name": "username",
"type": "string",
"description": "user's name",
"required": true
}
```
3. 「保存」をクリックすると、システムがJSONスキーマを自動的に検証し、保存します。
**フィールドの編集・削除**JSONコードボックスで、フィールドのタイプ、説明、デフォルト値などの項目を直接編集・削除し、「保存」をクリックします。
**JSONデータのインポート**
1. 「JSONをインポート」ボタンをクリックし、表示されるダイアログボックスにJSONデータを貼り付けるか、アップロードします。例JSONデータ
```json
{
"comment": "This is great!",
"rating": 5
}
```
2. 「送信」ボタンをクリックすると、システムがJSONデータを自動的に解析し、JSONスキーマに変換します。
**AIでJSONスキーマを生成する**
1. 「AI生成」アイコンをクリックし、モデルGPT-4などを選択します。入力ボックスにJSONスキーマの説明を入力します。例
> 「ユーザー名、年齢、および趣味を含むJSONスキーマが必要です。」
2. 「生成」をクリックすると、システムが自動的にJSONスキーマを生成します。
```json
{
"type": "object",
"properties": {
"username": {
"type": "string"
},
"age": {
"type": "number"
},
"interests": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"username",
"age",
"interests"
]
}
```
</Accordion>
***
### 活用事例
* **ナレッジベースの内容を検索する**
ワークフローアプリケーションが[「ナレッジベース」](../../knowledge-base/)の内容を検索できるようにしたい場合、例えばインテリジェントカスタマーサービスアプリケーションを構築する場合は、以下の手順を参考にしてください。
1. LLMードの上流に知識検索ードを追加します
2. 知識検索ノードの **出力変数** `result` をLLMードの **コンテキスト変数** に入力します;
3. **コンテキスト変数** をアプリケーションのプロンプトに挿入し、LLMがナレッジベース内のテキスト内容を読み取れるようにします。
![コンテキスト変数](../../../../en/.gitbook/assets/image (135).png)
[知識検索ノード](/ja-jp/guides/workflow/node/knowledge-retrieval) の出力変数 `result` には引用情報も含まれており、[**引用と帰属**](/ja-jp/guides/application-orchestrate/app-toolkits/README#引用と帰属) 機能を使用して情報の出所を確認できます。
<Info>
通常のノードの変数もコンテキスト変数に入力可能ですが、例えば開始ノードの文字列型変数など、**引用と帰属** 機能は機能しません。
</Info>
* **ドキュメントファイルの取り込み**
ワークフローアプリケーションでドキュメントの内容を取り込むことを可能にする場合、例えばChatPDFアプリケーションを開発する際には、以下の手順を踏んでください
* 「スタート」ノードへファイル変数を設定する;
* LLMードの前段階にドキュメント抽出ードを設置し、ファイル変数を入力として利用する
* 抽出ノードからの**出力変数** `text` をLLMードへの入力プロンプトとして設定する。
さらなる情報は、[ファイルアップロード](../file-upload)を参照してください。
* **エラー処理**
情報処理中に、LLMードでは入力テキストがトークンの制限を超えたり、必要なパラメータが欠けているなどのエラーに遭遇することがあります。開発者は以下の手順に従い、エラー処理の枝を設定してードエラーが発生した際の対処方針を構築することで、フローの中断を避けることができます
1. LLMードで「エラー処理」を有効化する
2. エラー処理戦略を選択して設定する
![エラー処理](https://assets-docs.dify.ai/2024/12/f7109ce5e87c0e0a81248bb2672c7667.png)
エラー処理の詳細は、[エラー処理](https://docs.dify.ai/guides/workflow/error-handling)をご覧ください。
* **構造化出力**
以下の動画を通じて、構造化出力機能を使用して顧客情報を収集する方法を理解することができます:
<iframe
width="560"
height="315"
src="https://www.youtube.com/embed/u8NQFxrsaW0"
title="Customer Information Intake Form Demo"
frameborder="0"
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
allowfullscreen
></iframe>
## プロンプト最適化
この機能は、満足のいかない出力に基づいてプロンプトを反復的に改善することを可能にします。この機能により、ユーザーは前回の実行結果を直接参照しながら指示を洗練でき、プロンプトの作成、モデルの出力、フィードバックの間に閉ループを実現します。
### 目的
以前、LLMードは**ステートレス**でした。プロンプトの効果が期待ほどではないの場合、ユーザーは試行錯誤で改善方法を見つける必要がありました。本機能により、以下が可能になります:
- コンテキスト変数を使用して前回の出力を参照
- 比較用のために、“理想的な出力”を定義
- プロンプトジェネレーターUIを使用して最適化されたプロンプトを再生成
---
### 仕組み
LLMードでプロンプトを実行後
- システムは“オリジナルプロンプト”とその“最後の出力”を取得
- これらはコンテキスト変数として提供されます:
- `{{current_prompt}}`:このノード内の現在のプロンプト
- `{{last_run}}`:このノードの前回の入力と出力
これらの変数は、反復的な改善のためにモデルに文脈を提供するため、プロンプトエディタに / や {} を使用して直接挿入できます。
---
### 設定手順
1. プロンプトジェネレーターを開く
最適化アイコンをクリックしてプロンプトジェネレーターを起動します。これにより、以下のような修正指示が自動的に入力されます:
`このプロンプトの出力は期待通りではありません:{{last_run}}。理想的な出力に基づいてプロンプトを編集してください。`
![Llm PN](/images/llm.PNG)
2. 指示をカスタマイズする
左側のプロンプトエディタで指示を編集し、変更・改善点(例: トーン、構造など)を反映させます。
3. 理想的な出力ボックスの使用
理想的な出力領域を展開し、サンプルや期待される出力形式を記述します。これはプロンプト再生成中にモデルの参考として使用されます。
注意:理想的な出力ボックスには変数を挿入することはできません。これは静的な例のためのものです。
例えば、タスクがモデルにニュース記事の簡潔な要約を正確に3つの箇条書きで出力するようにプロンプトを書き直すことであれば、理想的な出力は以下のようになります
![Llm PN](/images/llm2.PNG)
4. 最適化されたプロンプトを生成する
生成をクリックすると、システムがユーザーの指示と参照出力に基づいてプロンプトを書き換えます。新しいバージョンをすぐにテストできます。
---
### バージョン管理
プロンプト再生成は、新しいバージョンとしてそれぞれ保存されます:
- 出力エリアには「バージョン1」、「バージョン2」などのラベルの付いたドロップダウンが含まれています。
- 結果を比較するためにバージョン間で切り替えて比較できます。
- バージョンが1つだけ存在する場合、ドロップダウンは隠れます。
---
### メモ
- `last_run`には、このLLMード特有の前回の入力/出力が含まれます。
- これは、コードノードの`current_code`や`error_message`とは異なります。
- この機能は、ワークフローの連続性を損なうことなく、プロンプトの反復を改善します。
プロンプト最適化は、開発者やローコードユーザーが文脈に基づいてプロンプトを微調整する手助けをし、推測を減らしてガイド付きの反復を通じて成果を向上させます。
{/*
Contributing Section
DO NOT edit this section!
It will be automatically generated by the script.
*/}
---
[このページを編集する](https://github.com/langgenius/dify-docs/edit/main/ja-jp/guides/workflow/node/llm.mdx) | [問題を報告する](https://github.com/langgenius/dify-docs/issues/new?template=docs.yml)