Agentic Research

JSON

又稱:json 格式 · json 檔案 · json file · javascript object notation

一種用純文字寫成、人和程式都讀得懂的輕量資料格式 —— AI 工具世界的通用語。

你會在什麼時候遇到它

你發給 LLM API 的請求本體是 JSON、回傳是 JSON、模型發出的工具呼叫還是 JSON,多數 AI 工具的設定檔也是 JSON。它的規則很少但完全不講情面:少一個引號、結尾多一個逗號,整個請求就被拒收,而錯誤訊息常常只給你一個行號和欄號,要你自己去找。

打個比方

像一張填空表單:欄位(鍵)和內容(值)一一配對,格式固定,收表的人不必認識你就能處理。JSON 是程式世界最流行的表單範本 —— 因為它簡單到連語言模型都能穩定填對。

最小範例

echo '{ "model": "demo", "temperature": 0.7, "tags": ["a", "b"] }' | python3 -m json.tool

python3 -m json.tool 是 JSON 的驗屍官:格式對就美化印出,格式錯就告訴你第幾行第幾欄。改完 AI 工具的設定檔、或懷疑 API 送出的東西不對,先過一次它,比用眼睛找快得多。

最常搞錯的地方

  • 用單引號、在最後一項後面加逗號、或寫註解 —— 這些在 JavaScript 裡稀鬆平常,在 JSON 裡全部違法。「差一點像 JSON」的設定檔是新手錯誤的高發區。
  • 以為副檔名叫 .json,內容就一定是合法 JSON。手改過的檔案可能混進看不見的字元;有些工具的「JSON」其實允許註解(JSONC)。懷疑時用工具驗證,別用眼睛。

相關詞條

下一步