函数调用

开发中

POST

v1beta/models/gemini-3-flash-preview:generateContent

官方文档：https://ai.google.dev/gemini-api/docs/function-calling?hl=zh-cn&example=meeting#how-it-works
借助函数调用，您可以将模型连接到外部工具和 API。模型不会生成文本回答，而是会确定何时调用特定函数，并提供执行实际操作所需的参数。这使得模型能够充当自然语言与现实世界中的行动和数据之间的桥梁。函数调用有 3 个主要应用场景：

扩充知识：访问数据库、API 和知识库等外部来源的信息。
扩展功能：使用外部工具执行计算，并扩展模型的功能限制，例如使用计算器或创建图表。
执行操作：使用 API 与外部系统互动，例如安排预约、创建账单、发送电子邮件或控制智能家居设备。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Schedule a meeting with Bob and Alice for 03/27/2025 at 10:00 AM about the Q3 planning."
          }
        ]
      }
    ],
    "tools": [
      {
        "functionDeclarations": [
          {
            "name": "schedule_meeting",
            "description": "Schedules a meeting with specified attendees at a given time and date.",
            "parameters": {
              "type": "object",
              "properties": {
                "attendees": {
                  "type": "array",
                  "items": {"type": "string"},
                  "description": "List of people attending the meeting."
                },
                "date": {
                  "type": "string",
                  "description": "Date of the meeting (e.g., '2024-07-29')"
                },
                "time": {
                  "type": "string",
                  "description": "Time of the meeting (e.g., '15:00')"
                },
                "topic": {
                  "type": "string",
                  "description": "The subject or topic of the meeting."
                }
              },
              "required": ["attendees", "date", "time", "topic"]
            }
          }
        ]
      }
    ]
  }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'v1beta/models/gemini-3-flash-preview:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Schedule a meeting with Bob and Alice for 03/27/2025 at 10:00 AM about the Q3 planning."
          }
        ]
      }
    ],
    "tools": [
      {
        "functionDeclarations": [
          {
            "name": "schedule_meeting",
            "description": "Schedules a meeting with specified attendees at a given time and date.",
            "parameters": {
              "type": "object",
              "properties": {
                "attendees": {
                  "type": "array",
                  "items": {"type": "string"},
                  "description": "List of people attending the meeting."
                },
                "date": {
                  "type": "string",
                  "description": "Date of the meeting (e.g., '\''2024-07-29'\'')"
                },
                "time": {
                  "type": "string",
                  "description": "Time of the meeting (e.g., '\''15:00'\'')"
                },
                "topic": {
                  "type": "string",
                  "description": "The subject or topic of the meeting."
                }
              },
              "required": ["attendees", "date", "time", "topic"]
            }
          }
        ]
      }
    ]
  }'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2026-03-12 08:08:02

文档理解

代码执行