構造化出力

構造化出力は、指定したJSONスキーマに従った形式でAIの出力を得る機能です。後続処理でデータを利用したい場合や、ループノードでデータをループ処理したい場合に活用できます。

対応ノード

構造化出力は以下のノードで使用できます。

ノード	備考
LLM ノード	すべてのモデルで利用可能です
エージェントノード	ディープリサーチを除くエージェントで利用可能です

構造化出力を有効にする

ノードの設定パネルにある「構造化出力」セクションのスイッチをオンにすると、構造化出力が有効になります。

スイッチをオンにした後、「編集」アイコンをクリックすると、スキーマ編集ダイアログが開きます。

スキーマの設定方法

スキーマ編集ダイアログでは、3つの方法でスキーマを作成・編集できます。

ビジュアルエディター

GUIでプロパティを追加・編集できるエディターです。プロパティ名、型、説明を入力してスキーマを組み立てます。

• 「+」ボタンでプロパティを追加
• 型を選択（string / number / boolean / array / object）
• object型やarray型ではネストしたプロパティを定義可能

JSON エディター

JSON Schemaを直接編集できるエディターです。構文ハイライトやバリデーション機能が付いているため、記述ミスをすぐに確認できます。

AI で生成

何から始めたらいいかわからない場合

AI生成がおすすめです。欲しい出力を自然言語で伝えるだけで、スキーマを自動生成できます。

チャット形式で「こんな出力が欲しい」と指示するだけで、AIがスキーマを自動生成します。生成されたスキーマはそのまま利用することも、ビジュアルエディターやJSONエディターで微調整することもできます。

注意

AIによるスキーマ生成にはクレジットが消費されます。

ノート

3つのエディターはすべて同じスキーマを編集しています。どのエディターで変更しても、他のエディターに反映されます。

対応する型

スキーマのプロパティには以下の型を指定できます。

型	説明	例
string	文字列	"東京都"
number	数値	42, 3.14
boolean	真偽値	true, false
array	配列（リスト）	["A", "B", "C"]
object	オブジェクト（ネスト構造）	{"name": "太郎", "age": 30}

後続ノードで構造化出力を利用する

構造化出力を設定したノードの各フィールドは、後続ノードで変数として参照できます。

後続ノードのプロンプト入力欄で / を入力すると変数ピッカーが表示され、前のノードの structured_output 配下に定義したフィールドが一覧されます。

構造化出力の活用例

構造化出力の変数は、さまざまなノードの入力として活用できます。

• ループノード — 配列型のフィールドを反復データとしてそのまま利用できます。詳しくはループノードを参照してください。
• 条件分岐ノード — フィールドの値をもとに条件式を組み立て、ワークフローの流れを分岐できます。詳しくは条件分岐ノードを参照してください。
• 自動判定ノード — フィールドの値を判定対象に指定し、AIが内容に応じて自動で分岐先を選択できます。詳しくは自動判定ノードを参照してください。

ベストプラクティス

より良い出力を得るために

• プロンプトでJSON出力を意識する: 構造化出力はAIの最終的な出力をJSON形式で返す機能です。そのため、プロンプト（指示）の内容がスキーマに合った出力を生成できるものでなければ、期待どおりの結果が得られません。例えば、スキーマに 候補者リスト というプロパティがあるなら、「候補者の一覧を出力して」のようにそれに対応する指示をプロンプトに含めましょう。
• description を活用する: 各プロパティに description（説明）を設定すると、モデルがプロパティの意図を理解しやすくなり、出力の精度が向上します。