n8n Structured Output Parser 節點教學 - AI 輸出格式化 | Darrell TW

前言

用 n8n 串接 AI 模型時，最難的地方就是控制輸出的格式。
以往我們都會靠 prompt 加上：
請幫我輸出以下的 json 格式

可是往往會拿到下面這種惱人的格式

\```
{
  "name": "John Doe",
  "age": 30,
  "email": "john.doe@example.com"
}
\```

然後後面就要加上一個 code 節點
請 ChatGPT 來幫忙產生一段程式碼把這些字串改為 JSON 格式
其實在 n8n 中早就有一個節點可以簡簡單單解決這件事情
那就是本篇文章的主角 Structured Output Parser !

如何新增 Structured Output Parser 節點

如果你單獨新增一個 Structured Output parser 節點
你會發現無法直接連到現有的 AI Agent 節點中

n8n-structured_output_parser-can_not_link

其實他的啟用方式比較特別，要先在 AI 節點中找到一個選項：

勾選後，就可以在 AI 節點中新增 Structured Output parser 節點

這樣就算是成功的新增節點了

設定教學

基礎設定

節點的設定非常簡單
只需要貼上你預期的輸出格式即可

進階設定 : Auto-Fix Format

Auto-Fix Format 會在第一次 Parse 失敗時，
調用 AI 模型來幫忙修正

例如你預期的格式是

{
  "name": "John Doe",
  "age": 30,
  "email": "john.doe@example.com"
}

但 AI 給的格式是

{
  "name": {"first_name": "John", "last_name": "Doe"},
  "age": 30,
  "email": "john.doe@example.com"
}

由於 key 不同，第一次的 parse 便會失敗
這時他會把 AI 給的格式丟給 AI 模型來修正

實戰使用過程

假設我們今天要在 n8n 做一個 新聞摘要 的 workflow

我們會先在 ChatGPT 請他幫我們產生一個 prompt

1. 產生 prompt

你是一個摘要助手：
我會提供一篇或多篇文章給你，
請你為每篇文章做出**快速摘要**，並以 JSON Array 格式回傳。

輸出格式範例：
[
  {
    "title": "文章標題",
    "summary": "這篇文章的重點摘要"
  }
]

規則：
- 不要額外輸出文字，僅回傳 JSON 陣列
- 每篇文章一個物件
- `title` 使用文章的標題或可辨識名稱（如果有）
- `summary` 使用簡短句子或條列重點