Gemini 3 Pro

[
  {
    "type": "function",
    "function": {
      "name": "get_current_weather",
      "description": "获取给定位置的当前天气",
      "parameters": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "description": "城市和州，例如：San Francisco, CA"
          },
          "unit": {
            "type": "string",
            "enum": ["celsius", "fahrenheit"]
          }
        },
        "required": ["location"]
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_stock_price",
      "description": "获取指定股票代码的当前股价",
      "parameters": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string",
            "description": "股票代码，例如：AAPL"
          }
        },
        "required": ["symbol"]
      }
    }
  }
]

​

函数声明要求

• name（字符串，必需）：函数的唯一名称（例如，get_weather_forecast、send_email）。使用不含空格或特殊字符的描述性名称（使用下划线或驼峰式命名法）。
• description（字符串，可选但推荐）：对函数用途和功能的清晰而详尽的说明。这对于模型了解何时使用函数至关重要。请具体说明，并在必要时提供示例（例如，“根据位置查找影院，还可以选择查找目前正在影院上映的电影。”）。
• parameters（对象，必需）：定义函数预期的输入参数。包含：
  • type（字符串）：指定总体数据类型，必须为 "object"。
  • properties（对象）：列出各个参数，每个参数都具有以下属性：
    • type（字符串）：参数的数据类型，例如 string、integer、boolean、array。
    • description（字符串）：对参数的用途和格式的说明。提供示例和限制条件（例如，“城市和州，例如’加利福尼亚州旧金山’或邮政编码（例如’95616’）。”）。
    • enum（数组，可选）：如果参数值来自固定集，请使用 enum 列出允许的值，而不是仅在说明中描述它们。这有助于提高准确性（例如，"enum": ["daylight", "cool", "warm"]）。
  • required（数组）：一个字符串数组，列出了函数运行所必需的参数名称。

• string：文本值
• number：浮点数
• integer：整数
• boolean：布尔值（true/false）
• object：包含键值对的结构化数据
• array：项目列表
• null：要允许 null 值，请在类型数组中添加 "null"（例如，{"type": ["string", "null"]}）

​

特定类型的属性

• properties：将属性名称映射到其架构定义的对象
• required：必需属性名称数组
• additionalProperties：控制是否允许不在 properties 中列出的属性

• enum：用于分类的特定可能字符串列表
• format：指定字符串语法（例如，date-time、date、time）

• enum：特定可能数值列表
• minimum：包含在内的最小值
• maximum：包含在内的最大值

• items：所有数组元素的架构定义
• prefixItems：前 N 个项的架构列表（类似元组的结构）
• minItems：数组中的最小项数
• maxItems：数组中的最大项数

• 清晰的描述：在架构中使用 description 字段清楚地解释每个属性的含义
• 强类型：尽可能使用特定类型（integer、string、enum）
• 提示工程：在提示中明确说明您希望模型提取或结构化的内容
• 验证：虽然结构化输出确保 JSON 在语法上正确，但请务必在应用程序代码中验证值的语义正确性