# 従来の LLM インターフェース

Source: https://openflow.run/ja/docs/nodes/llm/
Language: ja
Product version: 0.1.0-beta.77

既存の LLM 定義のメッセージ、入力、結果の仕様です。ノード追加パネルの選択肢には含まれません。

ノード追加パネルには、独立した LLM の選択肢はありません。このページは既存の LLM 定義と CLI/MCP インターフェースの参照用です。新しいモデルタスクには、パネルの AI Agent またはアプリカタログに実際にあるモデル操作を選んでください。

LLM インターフェースは、明示的なメッセージ群でモデルを呼び出します。

## メッセージとモデル

モデルとテンプレートのデフォルト値を設定します。テンプレートは `{{input}}` などの名前付き入力を展開します。`messages` で渡す履歴はテンプレートの前に配置され、履歴自体は展開しません。

```json
{
  "op": "node.add", "as": "summary", "type": "llm", "name": "Summarize a ticket",
  "config": {
    "model": { "model": "deepseek-v4-flash" },
    "template": [{ "role": "user", "content": "Summarize in one sentence: {{input}}" }]
  },
  "inputs": { "input": { "kind": "value", "value": "The customer cannot complete checkout." } }
}
```

モデルは、設定済みのモデルサービスから利用できる必要があります。リクエストに必要なデータだけをバインドしてください。

LLM が Start の入力をメッセージテンプレートに展開し、テキストを 1 つ返します。

**入力**
{"text":"The customer cannot complete checkout."}

**想定される結果**
1 文の要約を生成します。具体的な文言はモデルによって異なります。

**実行前の準備**
実行前にモデルサービスを設定し、デプロイ先で利用できるモデルを選択してください。

[ワークフローをダウンロード](https://openflow.run/docs/examples/summarize-text.openflow.json)

## デフォルトと上書き

設定内の `model`、`template`、`messages` は保存済みのデフォルト値です。同名の入力バインドが優先されます。デフォルトを編集しても、既存バインドは維持されます。

`default` 入力元で継承を戻し、`unset` でデフォルトを明示的に無効にします。どちらも JSON の null とは異なります。

## 結果

結果ポートは公開編集インターフェースが管理します。デフォルトはテキストで、`config.resultSchema` は構造化結果を要求します。タスク結果のコミット前に、サービスが仕様に対して出力を検証します。

スキーマが制約するのは形であり、事実の正しさではありません。タスクの要件に照らして内容を確認してください。具体的な文言はモデル次第で、オフラインプレビューからは分かりません。

## 失敗

LLM は通常の[再試行とエラー処理](https://openflow.run/ja/docs/concepts/errors-and-retries/index.md)に対応します。再試行は同じ入力でモデルタスクを繰り返すため、内容が変わったり、モデルの使用量が増えたりする場合があります。

## 参照元

*   [docs/authoring/node-authoring.md](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/docs/authoring/node-authoring.md)
*   [docs/control/contracts/control-api.md](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/docs/control/contracts/control-api.md#node-configuration-semantics)
*   [packages/open-flow/src/workbench/browser/runtime/editor/addNodeOptions.ts](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/packages/open-flow/src/workbench/browser/runtime/editor/addNodeOptions.ts)
