Skip to main content

Gemini 结构化输出示例

以下示例展示如何使用Gemini API的结构化输出功能,通过 response_schema 参数确保输出符合指定的JSON Schema格式。

快速开始

只需要替换 <API-KEY> 为你的实际API密钥即可运行。

Gemini结构化输出的特点

1. 原生支持JSON Schema

Gemini通过 responseSchema 参数原生支持JSON Schema验证:
  • 严格遵循: 输出严格遵循指定的schema结构
  • 类型验证: 自动验证数据类型和格式
  • 必填字段: 确保required字段不会缺失

2. 配置参数

3. Schema支持的特性

  • 基本类型: string, number, integer, boolean, array, object
  • 约束条件: minimum, maximum, enum, items等
  • 嵌套结构: 支持复杂的嵌套对象和数组
  • 必填验证: required字段自动验证

结果示例

200

高级Schema示例

1. 复杂嵌套结构

2. 枚举值约束

应用场景

数据提取和整理

  • 文档解析: 从非结构化文档中提取结构化信息
  • 表单填充: 自动填充复杂的结构化表单
  • 数据标准化: 将不同格式的数据统一为标准结构

分析和评估

  • 情感分析: 提供量化的情感分析结果
  • 产品评价: 结构化分析用户反馈和评价
  • 市场调研: 从调研数据中提取结构化洞察

业务应用

  • CRM系统: 从客户沟通中提取关键信息
  • 报告生成: 自动生成结构化的业务报告
  • 质量控制: 确保AI输出符合业务规范

最佳实践

1. Schema设计原则

  • 简洁明确: 避免过于复杂的嵌套结构
  • 类型明确: 为每个字段指定准确的类型
  • 约束合理: 设置合理的取值范围和枚举值
  • 描述清晰: 为每个字段提供清晰的描述

2. 性能优化

  • 低温度: 使用较低的temperature (0.1-0.3) 确保结构稳定
  • 合理长度: 避免过长的输出,合理设置maxOutputTokens
  • 字段验证: 在客户端验证返回的JSON结构

3. 错误处理

  • JSON解析: 妥善处理JSON解析异常
  • Schema验证: 验证返回数据是否符合预期schema
  • 降级处理: 提供schema验证失败时的降级策略

注意事项

  1. Schema复杂度: 过于复杂的schema可能影响生成质量
  2. 必填字段: required字段过多可能导致生成困难
  3. 数据类型: 确保schema中的类型定义准确
  4. 约束条件: 约束条件要合理,避免无法满足的限制
  5. 温度设置: 建议使用低温度以确保结构化输出的稳定性
  6. Token限制: 复杂结构可能需要更多token,注意设置合理的限制