指南
结构化输出
结构化输出是一种产品模式，而不是某个专用的 AnyInt 端点。确切机制取决于你选择的兼容性家族和模型。
结构化输出是一种产品模式，而不是某个专用的 AnyInt 端点。确切机制取决于你选择的兼容性家族和模型。
推荐方法
- 先定义你需要的 schema
- 明确告诉模型要返回哪些键和类型
- 在你的应用中验证返回的 JSON
- 为格式错误的输出保留修复或重试路径
适用场景
- 信息提取流水线
- 工作流编排
- 代理状态交接
- 表单或 UI 生成
跨家族指导
| 家族 | 推荐模式 |
|---|---|
| 兼容 OpenAI | 要求严格的 JSON 对象，并在服务器端进行验证 |
| 兼容 Anthropic | 以文本块形式返回 JSON，并在解析后进行验证 |
| 兼容 Gemini | 保持 contents[].parts[] 简单，并要求仅返回 JSON 的答案 |
示例提示模式
{
"task": "extract_invoice",
"fields": {
"invoice_number": "string",
"currency": "string",
"total": "number"
}
}使用一个明确说明以下内容的提示：
- 仅返回有效的 JSON
- 不要添加 Markdown 代码围栏
- 不要添加解释性文本
重要说明
对严格 JSON 控制的支持可能因模型而异。请用你计划在生产环境中运行的具体模型 ID 确认其行为，然后在你这边强制执行 schema 验证。