JSON / YAML#

LLM 应用里，JSON 和 YAML 出现得非常频繁：API 请求、模型结构化输出、配置文件、评测数据、工具定义都会用到它们。

JSON 适合什么#

JSON 适合程序交换数据：

1
{
2
  "model": "demo-model",
3
  "temperature": 0.3,
4
  "messages": [
5
    {
6
      "role": "user",
7
      "content": "解释 RAG"
8
    }
9
  ]
10
}

Python 读取：

1
import json
2

3
data = json.loads('{"name": "LLM"}')
4
print(data["name"])

YAML 适合什么#

YAML 更适合人写配置：

1
model:
2
  name: demo-model
3
  temperature: 0.3
4
rag:
5
  top_k: 3
6
  chunk_size: 500

读取 YAML 需要安装依赖：

1
pip install pyyaml

1
import yaml
2

3
with open("config.yaml", "r", encoding="utf-8") as file:
4
    config = yaml.safe_load(file)

在 LLM 项目中的用途#

格式	常见用途
JSON	API 请求、结构化输出、工具参数
YAML	项目配置、模型配置、实验参数

注意事项#

JSON 字符串必须用双引号。
YAML 对缩进敏感。
不要用 YAML 保存密钥，密钥放 .env 更好。
模型输出 JSON 后，程序要校验格式。

最小练习#

写一个 config.yaml，包含模型名称、temperature、top_k。用 Python 读取后打印出来。

JSON / YAML

https://llmhello.com/posts/2026_07/json-yaml/

作者

Happy Zhuang

发布于

2026-07-09

许可协议

CC BY-NC-SA 4.0

JSON Schema

消息结构