结构化输出（Structured Output）

🧠 为什么需要结构化输出？

自由文本虽然灵活，但机器难以可靠解析：

// ❌ 自由文本输出（难以解析）
"搜索结果：找到了3篇文章，第一篇是关于AI的，发表于2026年..."

// ✅ 结构化输出（机器可读）
{
  "results": [
    {"title": "AI发展报告", "date": "2026-06-17", "score": 0.95},
    {"title": "Agent技术趋势", "date": "2026-06-16", "score": 0.87}
  ],
  "total": 2
}

🔧 JSON Mode vs Schema约束

JSON Mode

最基本的结构化输出，只保证输出是合法JSON：

// API调用
{
  "model": "gpt-4o",
  "response_format": { "type": "json_object" }
}

Schema约束（Structured Outputs）

更严格的约束，输出必须符合指定的Schema：

// 定义Schema
{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "number", "minimum": 0 },
    "skills": { "type": "array", "items": { "type": "string" } }
  },
  "required": ["name", "age"]
}

// 模型输出保证符合这个Schema

🔧 OpenClaw 中的结构化输出

OpenClaw 在多个场景使用结构化输出：

• Tool Calling：工具参数必须是结构化JSON
• 任务规划：解析任务步骤为结构化列表
• 数据提取：从文本中提取结构化信息
• API响应：生成可被前端直接使用的JSON

⚠️ 实现技巧

🎯 最佳实践

// 好的Schema设计
{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": ["search", "create", "update", "delete"],
      "description": "要执行的操作类型"
    },
    "target": {
      "type": "string",
      "description": "操作的目标对象"
    },
    "params": {
      "type": "object",
      "description": "操作参数",
      "additionalProperties": true
    }
  },
  "required": ["action", "target"]
}

← 返回术语百科首页