Chữ ký của Thought

Chữ ký suy nghĩ là biểu thị được mã hoá của quy trình suy nghĩ nội bộ của mô hình và được dùng để duy trì bối cảnh lập luận trong các lượt tương tác nhiều lượt. Khi sử dụng các mô hình tư duy (chẳng hạn như Gemini 3 và 2.5), API có thể trả về một trường thoughtSignature trong các phần nội dung của phản hồi (ví dụ: text hoặc functionCall).

Theo nguyên tắc chung, nếu nhận được chữ ký suy nghĩ trong câu trả lời của mô hình, bạn nên truyền lại chính xác chữ ký đó như khi nhận được khi gửi nhật ký trò chuyện ở lượt tiếp theo. Khi sử dụng Gemini 3 Pro, bạn phải truyền lại chữ ký suy nghĩ trong quá trình gọi hàm, nếu không bạn sẽ gặp lỗi xác thực (mã trạng thái 4xx).

Cách hoạt động

Hình ảnh bên dưới minh hoạ ý nghĩa của "lượt" và "bước" khi chúng liên quan đến tính năng gọi hàm trong Gemini API. "Lượt" là một lượt trao đổi hoàn chỉnh trong cuộc trò chuyện giữa người dùng và mô hình. "Bước" là một hành động hoặc thao tác chi tiết hơn do mô hình thực hiện, thường là một phần của quy trình lớn hơn để hoàn tất một lượt.

Sơ đồ các lượt và bước gọi hàm

Tài liệu này tập trung vào việc xử lý lệnh gọi hàm cho Gemini 3 Pro. Tham khảo phần hành vi của mô hình để biết sự khác biệt với phiên bản 2.5.

Gemini 3 Pro trả về chữ ký tư duy cho tất cả các câu trả lời của mô hình (câu trả lời từ API) bằng một lệnh gọi hàm. Chữ ký suy nghĩ xuất hiện trong những trường hợp sau:

  • Khi có các lệnh gọi hàm song song, phần lệnh gọi hàm đầu tiên do phản hồi của mô hình trả về sẽ có chữ ký suy nghĩ.
  • Khi có các lệnh gọi hàm tuần tự (nhiều bước), mỗi lệnh gọi hàm sẽ có một chữ ký và bạn phải truyền tất cả chữ ký trở lại.
  • Các phản hồi của mô hình không có lệnh gọi hàm sẽ trả về chữ ký ý tưởng bên trong phần cuối cùng mà mô hình trả về.

Bảng sau đây minh hoạ các lệnh gọi hàm nhiều bước, kết hợp định nghĩa về lượt và bước với khái niệm về chữ ký được giới thiệu ở trên:

Turn

Bước

Yêu cầu của người dùng

Câu trả lời của mô hình

FunctionResponse

1

1

 request1 = user_prompt FC1 + signature FR1

1

2

 request2 = request1 + (FC1 + signature) + FR1 FC2 + signature FR2

1

3

 request3 = request2 + (FC2 + signature) + FR2 text_output

(no FCs)

Không có

Chữ ký trong các phần gọi hàm

Khi tạo functionCall, Gemini dựa vào thought_signature để xử lý chính xác đầu ra của công cụ trong lượt tiếp theo.

  • Hành vi:
    • Single Function Call (Một lệnh gọi hàm): Phần functionCall sẽ chứa một thought_signature.
    • Lệnh gọi hàm song song: Nếu mô hình tạo ra các lệnh gọi hàm song song trong một phản hồi, thì thought_signature sẽ chỉ được đính kèm vào phần functionCall đầu tiên. Các phần functionCall tiếp theo trong cùng một phản hồi sẽ không chứa chữ ký.
  • Yêu cầu: Bạn phải trả về chữ ký này ở đúng phần mà bạn đã nhận được khi gửi nhật ký trò chuyện trở lại.
  • Xác thực: Quy trình xác thực nghiêm ngặt được thực thi cho tất cả các lệnh gọi hàm trong lượt hiện tại . (Chỉ cần lượt hiện tại; chúng tôi không xác thực ở các lượt trước)
    • API này sẽ quay lại lịch sử (từ mới nhất đến cũ nhất) để tìm thông báo User gần đây nhất có chứa nội dung tiêu chuẩn (ví dụ: text) ( đây sẽ là điểm bắt đầu của lượt hiện tại). Đây sẽ không be là functionResponse.
    • Tất cả các lượt functionCall phản hồi của mô hình xảy ra sau thông báo sử dụng cụ thể đó đều được coi là một phần của lượt phản hồi.
    • Phần đầu tiên functionCall trong mỗi bước của lượt hiện tại phải bao gồm thought_signature.
    • Nếu bạn bỏ qua thought_signature cho phần functionCall đầu tiên trong bất kỳ bước nào của lượt hiện tại, thì yêu cầu sẽ không thành công và trả về lỗi 400.
  • Nếu không nhận được chữ ký thích hợp, bạn sẽ gặp lỗi theo cách sau
    • gemini-3-pro-preview: Nếu không thêm chữ ký, bạn sẽ gặp lỗi 400. Nội dung sẽ có dạng:
      • Lệnh gọi hàm <Function Call> trong khối nội dung <index of contents array> thiếu thought_signature. Ví dụ: Lệnh gọi hàm FC1 trong khối nội dung 1. bị thiếu thought_signature.

Ví dụ về lệnh gọi hàm tuần tự

Phần này cho thấy ví dụ về nhiều lệnh gọi hàm, trong đó người dùng đặt một câu hỏi phức tạp đòi hỏi nhiều nhiệm vụ.

Hãy xem một ví dụ về lệnh gọi hàm nhiều lượt, trong đó người dùng đặt một câu hỏi phức tạp đòi hỏi nhiều việc cần làm: "Check flight status for AA100 and book a taxi if delayed".

Turn

Bước

Yêu cầu của người dùng

Câu trả lời của mô hình

FunctionResponse

1

1

 request1="Check flight status for AA100 and book a taxi 2 hours before if delayed." FC1 ("check_flight") + signature FR1

1

2

 request2 = request1 + FC1 ("check_flight") + signature + FR1 FC2("book_taxi") + signature FR2

1

3

 request3 = request2 + FC2 ("book_taxi") + signature + FR2 text_output

(no FCs)

 None

Đoạn mã sau đây minh hoạ trình tự trong bảng trên.

Lượt 1, Bước 1 (Yêu cầu của người dùng)

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Check flight status for AA100 and book a taxi 2 hours before if delayed."
        }
      ]
    }
  ],
  "tools": [
    {
      "functionDeclarations": [
        {
          "name": "check_flight",
          "description": "Gets the current status of a flight",
          "parameters": {
            "type": "object",
            "properties": {
              "flight": {
                "type": "string",
                "description": "The flight number to check"
              }
            },
            "required": [
              "flight"
            ]
          }
        },
        {
          "name": "book_taxi",
          "description": "Book a taxi",
          "parameters": {
            "type": "object",
            "properties": {
              "time": {
                "type": "string",
                "description": "time to book the taxi"
              }
            },
            "required": [
              "time"
            ]
          }
        }
      ]
    }
  ]
}

Lượt 1, Bước 1 (Phản hồi của mô hình)

{
"content": {
        "role": "model",
        "parts": [
          {
            "functionCall": {
              "name": "check_flight",
              "args": {
                "flight": "AA100"
              }
            },
            "thoughtSignature": "<Signature A>"
          }
        ]
  }
}

Lượt 1, Bước 2 (Phản hồi của người dùng – Gửi đầu ra của công cụ) Vì lượt này của người dùng chỉ chứa functionResponse (không có văn bản mới), nên chúng ta vẫn đang ở Lượt 1. Chúng ta phải bảo tồn <Signature_A>.

{
      "role": "user",
      "parts": [
        {
          "text": "Check flight status for AA100 and book a taxi 2 hours before if delayed."
        }
      ]
    },
    {
        "role": "model",
        "parts": [
          {
            "functionCall": {
              "name": "check_flight",
              "args": {
                "flight": "AA100"
              }
            },
            "thoughtSignature": "<Signature A>" //Required and Validated
          }
        ]
      },
      {
        "role": "user",
        "parts": [
          {
            "functionResponse": {
              "name": "check_flight",
              "response": {
                "status": "delayed",
                "departure_time": "12 PM"
                }
              }
            }
        ]
}

Lượt 1, Bước 2 (Mô hình) Giờ đây, mô hình quyết định đặt taxi dựa trên đầu ra của công cụ trước đó.

{
      "content": {
        "role": "model",
        "parts": [
          {
            "functionCall": {
              "name": "book_taxi",
              "args": {
                "time": "10 AM"
              }
            },
            "thoughtSignature": "<Signature B>"
          }
        ]
      }
}

Lượt 1, Bước 3 (Người dùng – Gửi đầu ra của công cụ) Để gửi thông tin xác nhận đặt xe taxi, chúng ta phải thêm chữ ký cho TẤT CẢ các lệnh gọi hàm trong vòng lặp này (<Signature A> + <Signature B>).

{
      "role": "user",
      "parts": [
        {
          "text": "Check flight status for AA100 and book a taxi 2 hours before if delayed."
        }
      ]
    },
    {
        "role": "model",
        "parts": [
          {
            "functionCall": {
              "name": "check_flight",
              "args": {
                "flight": "AA100"
              }
            },
            "thoughtSignature": "<Signature A>" //Required and Validated
          }
        ]
      },
      {
        "role": "user",
        "parts": [
          {
            "functionResponse": {
              "name": "check_flight",
              "response": {
                "status": "delayed",
                "departure_time": "12 PM"
              }
              }
            }
        ]
      },
      {
        "role": "model",
        "parts": [
          {
            "functionCall": {
              "name": "book_taxi",
              "args": {
                "time": "10 AM"
              }
            },
            "thoughtSignature": "<Signature B>" //Required and Validated
          }
        ]
      },
      {
        "role": "user",
        "parts": [
          {
            "functionResponse": {
              "name": "book_taxi",
              "response": {
                "booking_status": "success"
              }
              }
            }
        ]
    }
}

Ví dụ về lệnh gọi hàm song song

Hãy xem một ví dụ về việc gọi hàm song song, trong đó người dùng yêu cầu "Check weather in Paris and London" xem mô hình xác thực ở đâu.

Turn

Bước

Yêu cầu của người dùng

Câu trả lời của mô hình

FunctionResponse

1

1

request1="Xem thời tiết ở Paris và London"

FC1 ("Paris") + chữ ký

FC2 ("London")

FR1

1

2

request 2 = request1 + FC1 ("Paris") + signature + FC2 ("London")

text_output

(không có FC)

Không có

Đoạn mã sau đây minh hoạ trình tự trong bảng trên.

Lượt 1, Bước 1 (Yêu cầu của người dùng)

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Check the weather in Paris and London."
        }
      ]
    }
  ],
  "tools": [
    {
      "functionDeclarations": [
        {
          "name": "get_current_temperature",
          "description": "Gets the current temperature for a given location.",
          "parameters": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "description": "The city name, e.g. San Francisco"
              }
            },
            "required": [
              "location"
            ]
          }
        }
      ]
    }
  ]
}

Lượt 1, Bước 1 (Phản hồi của mô hình)

{
  "content": {
    "parts": [
      {
        "functionCall": {
          "name": "get_current_temperature",
          "args": {
            "location": "Paris"
          }
        },
        "thoughtSignature": "<Signature_A>"// INCLUDED on First FC
      },
      {
        "functionCall": {
          "name": "get_current_temperature",
          "args": {
            "location": "London"
          }// NO signature on subsequent parallel FCs
        }
      }
    ]
  }
}

Lượt 1, Bước 2 (Phản hồi của người dùng – Gửi đầu ra của công cụ) Chúng ta phải giữ nguyên <Signature_A> ở phần đầu tiên đúng như đã nhận.

[
  {
    "role": "user",
    "parts": [
      {
        "text": "Check the weather in Paris and London."
      }
    ]
  },
  {
    "role": "model",
    "parts": [
      {
        "functionCall": {
          "name": "get_current_temperature",
          "args": {
            "city": "Paris"
          }
        },
        "thought_signature": "<Signature_A>" // MUST BE INCLUDED
      },
      {
        "functionCall": {
          "name": "get_current_temperature",
          "args": {
            "city": "London"
          }
        }
      } // NO SIGNATURE FIELD
    ]
  },
  {
    "role": "user",
    "parts": [
      {
        "functionResponse": {
          "name": "get_current_temperature",
          "response": {
            "temp": "15C"
          }
        }
      },
      {
        "functionResponse": {
          "name": "get_current_temperature",
          "response": {
            "temp": "12C"
          }
        }
      }
    ]
  }
]

Chữ ký trong các phần không phải functionCall

Gemini cũng có thể trả về thought_signatures ở phần cuối của câu trả lời trong các phần không phải là lệnh gọi hàm.

  • Hành vi: Phần nội dung cuối cùng (text, inlineData…) do mô hình trả về có thể chứa thought_signature.
  • Đề xuất: Bạn nên trả về những chữ ký này để đảm bảo mô hình duy trì khả năng suy luận chất lượng cao, đặc biệt là đối với các quy trình làm việc phức tạp theo hướng dẫn hoặc quy trình làm việc mô phỏng theo kiểu tác nhân.
  • Xác thực: API không thực thi quy trình xác thực một cách nghiêm ngặt. Bạn sẽ không nhận được lỗi chặn nếu bỏ qua các tham số này, mặc dù hiệu suất có thể giảm.

Văn bản/Lý luận trong ngữ cảnh (Không xác thực)

Lượt 1, Bước 1 (Phản hồi của mô hình)

{
  "role": "model",
  "parts": [
    {
      "text": "I need to calculate the risk. Let me think step-by-step...",
      "thought_signature": "<Signature_C>" // OPTIONAL (Recommended)
    }
  ]
}

Lượt 2, Bước 1 (Người dùng)

[
  { "role": "user", "parts": [{ "text": "What is the risk?" }] },
  {
    "role": "model", 
    "parts": [
      {
        "text": "I need to calculate the risk. Let me think step-by-step...",
        // If you omit <Signature_C> here, no error will occur.
      }
    ]
  },
  { "role": "user", "parts": [{ "text": "Summarize it." }] }
]

Chữ ký để tương thích với OpenAI

Ví dụ sau đây minh hoạ cách xử lý chữ ký suy nghĩ cho một API hoàn thành cuộc trò chuyện bằng cách sử dụng khả năng tương thích với OpenAI.

Ví dụ về lệnh gọi hàm tuần tự

Đây là ví dụ về việc gọi nhiều hàm, trong đó người dùng đặt một câu hỏi phức tạp đòi hỏi nhiều việc cần làm.

Hãy xem một ví dụ về chức năng gọi nhiều lượt, trong đó người dùng hỏi Check flight status for AA100 and book a taxi if delayed và bạn có thể thấy điều gì sẽ xảy ra khi người dùng hỏi một câu hỏi phức tạp đòi hỏi nhiều việc cần làm.

Turn

Bước

Yêu cầu của người dùng

Câu trả lời của mô hình

FunctionResponse

1

1

 request1="Check the weather in Paris and London" FC1 ("Paris") + signature

FC2 ("London")

 FR1

1

2

 request 2 = request1 + FC1 ("Paris") + signature + FC2 ("London") text_output

(no FCs)

 None

Đoạn mã sau đây sẽ đi qua trình tự đã cho.

Lượt 1, Bước 1 (Yêu cầu của người dùng)

{
  "model": "google/gemini-3-pro-preview",
  "messages": [
    {
      "role": "user",
      "content": "Check flight status for AA100 and book a taxi 2 hours before if delayed."
    }
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "check_flight",
        "description": "Gets the current status of a flight",
        "parameters": {
          "type": "object",
          "properties": {
            "flight": {
              "type": "string",
              "description": "The flight number to check."
            }
          },
          "required": [
            "flight"
          ]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "book_taxi",
        "description": "Book a taxi",
        "parameters": {
          "type": "object",
          "properties": {
            "time": {
              "type": "string",
              "description": "time to book the taxi"
            }
          },
          "required": [
            "time"
          ]
        }
      }
    }
  ]
}

Lượt 1, Bước 1 (Câu trả lời mẫu)

{
      "role": "model",
        "tool_calls": [
          {
            "extra_content": {
              "google": {
                "thought_signature": "<Signature A>"
              }
            },
            "function": {
              "arguments": "{\"flight\":\"AA100\"}",
              "name": "check_flight"
            },
            "id": "function-call-1",
            "type": "function"
          }
        ]
    }

Lượt 1, Bước 2 (Phản hồi của người dùng – Gửi đầu ra của công cụ)

Vì lượt tương tác này của người dùng chỉ chứa functionResponse (không có văn bản mới) nên chúng ta vẫn ở Lượt 1 và phải giữ lại <Signature_A>.

"messages": [
    {
      "role": "user",
      "content": "Check flight status for AA100 and book a taxi 2 hours before if delayed."
    },
    {
      "role": "model",
        "tool_calls": [
          {
            "extra_content": {
              "google": {
                "thought_signature": "<Signature A>" //Required and Validated
              }
            },
            "function": {
              "arguments": "{\"flight\":\"AA100\"}",
              "name": "check_flight"
            },
            "id": "function-call-1",
            "type": "function"
          }
        ]
    },
    {
      "role": "tool",
      "name": "check_flight",
      "tool_call_id": "function-call-1",
      "content": "{\"status\":\"delayed\",\"departure_time\":\"12 PM\"}"                 
    }
  ]

Lượt 1, Bước 2 (Mô hình)

Giờ đây, mô hình sẽ quyết định đặt taxi dựa trên đầu ra của công cụ trước đó.

{
"role": "model",
"tool_calls": [
{
"extra_content": {
"google": {
"thought_signature": "<Signature B>"
}
            },
            "function": {
              "arguments": "{\"time\":\"10 AM\"}",
              "name": "book_taxi"
            },
            "id": "function-call-2",
            "type": "function"
          }
       ]
}

Lượt 1, Bước 3 (Người dùng – Gửi đầu ra của công cụ)

Để gửi thông tin xác nhận đặt xe taxi, chúng ta phải thêm chữ ký cho TẤT CẢ các lệnh gọi hàm trong vòng lặp này (<Signature A> + <Signature B>).

"messages": [
    {
      "role": "user",
      "content": "Check flight status for AA100 and book a taxi 2 hours before if delayed."
    },
    {
      "role": "model",
        "tool_calls": [
          {
            "extra_content": {
              "google": {
                "thought_signature": "<Signature A>" //Required and Validated
              }
            },
            "function": {
              "arguments": "{\"flight\":\"AA100\"}",
              "name": "check_flight"
            },
            "id": "function-call-1d6a1a61-6f4f-4029-80ce-61586bd86da5",
            "type": "function"
          }
        ]
    },
    {
      "role": "tool",
      "name": "check_flight",
      "tool_call_id": "function-call-1d6a1a61-6f4f-4029-80ce-61586bd86da5",
      "content": "{\"status\":\"delayed\",\"departure_time\":\"12 PM\"}"                 
    },
    {
      "role": "model",
        "tool_calls": [
          {
            "extra_content": {
              "google": {
                "thought_signature": "<Signature B>" //Required and Validated
              }
            },
            "function": {
              "arguments": "{\"time\":\"10 AM\"}",
              "name": "book_taxi"
            },
            "id": "function-call-65b325ba-9b40-4003-9535-8c7137b35634",
            "type": "function"
          }
        ]
    },
    {
      "role": "tool",
      "name": "book_taxi",
      "tool_call_id": "function-call-65b325ba-9b40-4003-9535-8c7137b35634",
      "content": "{\"booking_status\":\"success\"}"
    }
  ]

Ví dụ về lệnh gọi hàm song song

Hãy xem ví dụ về lệnh gọi hàm song song, trong đó người dùng hỏi "Check weather in Paris and London" và bạn có thể thấy vị trí mà mô hình thực hiện quy trình xác thực.

Turn

Bước

Yêu cầu của người dùng

Câu trả lời của mô hình

FunctionResponse

1

1

 request1="Check the weather in Paris and London" FC1 ("Paris") + signature

FC2 ("London")

 FR1

1

2

 request 2 = request1 + FC1 ("Paris") + signature + FC2 ("London") text_output

(no FCs)

 None

Sau đây là mã để duyệt qua chuỗi đã cho.

Lượt 1, Bước 1 (Yêu cầu của người dùng)

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Check the weather in Paris and London."
        }
      ]
    }
  ],
  "tools": [
    {
      "functionDeclarations": [
        {
          "name": "get_current_temperature",
          "description": "Gets the current temperature for a given location.",
          "parameters": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "description": "The city name, e.g. San Francisco"
              }
            },
            "required": [
              "location"
            ]
          }
        }
      ]
    }
  ]
}

Lượt 1, Bước 1 (Câu trả lời mẫu)

{
"role": "assistant",
        "tool_calls": [
          {
            "extra_content": {
              "google": {
                "thought_signature": "<Signature A>" //Signature returned
              }
            },
            "function": {
              "arguments": "{\"location\":\"Paris\"}",
              "name": "get_current_temperature"
            },
            "id": "function-call-f3b9ecb3-d55f-4076-98c8-b13e9d1c0e01",
            "type": "function"
          },
          {
            "function": {
              "arguments": "{\"location\":\"London\"}",
              "name": "get_current_temperature"
            },
            "id": "function-call-335673ad-913e-42d1-bbf5-387c8ab80f44",
            "type": "function" // No signature on Parallel FC
          }
        ]
}

Lượt 1, Bước 2 (Phản hồi của người dùng – Gửi đầu ra của công cụ)

Bạn phải giữ nguyên <Signature_A> ở phần đầu tiên như khi nhận được.

"messages": [
    {
      "role": "user",
      "content": "Check the weather in Paris and London."
    },
    {
      "role": "assistant",
        "tool_calls": [
          {
            "extra_content": {
              "google": {
                "thought_signature": "<Signature A>" //Required
              }
            },
            "function": {
              "arguments": "{\"location\":\"Paris\"}",
              "name": "get_current_temperature"
            },
            "id": "function-call-f3b9ecb3-d55f-4076-98c8-b13e9d1c0e01",
            "type": "function"
          },
          {
            "function": { //No Signature
              "arguments": "{\"location\":\"London\"}",
              "name": "get_current_temperature"
            },
            "id": "function-call-335673ad-913e-42d1-bbf5-387c8ab80f44",
            "type": "function"
          }
        ]
    },
    {
      "role":"tool",
      "name": "get_current_temperature",
      "tool_call_id": "function-call-f3b9ecb3-d55f-4076-98c8-b13e9d1c0e01",
      "content": "{\"temp\":\"15C\"}"
    },    
    {
      "role":"tool",
      "name": "get_current_temperature",
      "tool_call_id": "function-call-335673ad-913e-42d1-bbf5-387c8ab80f44",
      "content": "{\"temp\":\"12C\"}"
    }
  ]

Câu hỏi thường gặp

  1. Làm cách nào để chuyển nhật ký từ một mô hình khác sang Gemini 3 Pro bằng một phần lệnh gọi hàm trong lượt và bước hiện tại? Tôi cần cung cấp các phần gọi hàm không do API tạo và do đó không có chữ ký suy nghĩ liên kết?

    Mặc dù không nên chèn các khối lệnh gọi hàm tuỳ chỉnh vào yêu cầu, nhưng trong trường hợp không thể tránh được, chẳng hạn như cung cấp thông tin cho mô hình về các lệnh gọi hàm và phản hồi được thực thi một cách xác định bởi ứng dụng, hoặc chuyển dấu vết từ một mô hình khác không bao gồm chữ ký ý tưởng, bạn có thể đặt các chữ ký giả sau đây của "context_engineering_is_the_way_to_go" hoặc "skip_thought_signature_validator" trong trường chữ ký ý tưởng để bỏ qua quy trình xác thực.

  2. Tôi đang gửi lại các lệnh gọi hàm song song xen kẽ và các phản hồi, còn API đang trả về mã lỗi 400. Vì sao lại như vậy?

    Khi API trả về các lệnh gọi hàm song song "FC1 + chữ ký, FC2", phản hồi dự kiến của người dùng là "FC1 + chữ ký, FC2, FR1, FR2". Nếu bạn có các khoá này xen kẽ với nhau dưới dạng "FC1 + chữ ký, FR1, FC2, FR2", thì API sẽ trả về lỗi 400.

  3. Khi truyền trực tuyến và mô hình không trả về một lệnh gọi hàm, tôi không thể tìm thấy chữ ký suy nghĩ

    Trong phản hồi của mô hình không chứa FC có yêu cầu truyền phát trực tiếp, mô hình có thể trả về chữ ký ý tưởng trong một phần có nội dung văn bản trống. Bạn nên phân tích cú pháp toàn bộ yêu cầu cho đến khi mô hình trả về finish_reason.

Hành vi ký tên suy nghĩ theo dòng mô hình

Mô hình Gemini 3 Pro và Gemini 2.5 có hành vi khác nhau với chữ ký tư duy trong các lệnh gọi hàm:

  • Nếu có lệnh gọi hàm trong câu trả lời, hãy làm như sau:
    • Gemini 3 Pro sẽ luôn có chữ ký ở phần lệnh gọi hàm đầu tiên. Bạn bắt buộc phải trả lại bộ phận đó.
    • Gemini 2.5 sẽ có chữ ký ở phần đầu tiên (bất kể loại nào). Bạn không bắt buộc phải trả lại bộ phận đó.
  • Nếu không có lệnh gọi hàm nào trong phản hồi, hãy làm như sau:
    • Gemini 3 Pro sẽ có chữ ký ở phần cuối nếu mô hình tạo ra một ý tưởng.
    • Gemini 2.5 sẽ không có chữ ký ở bất kỳ phần nào.

Để biết hành vi chữ ký tư duy của các mô hình Gemini 2.5, hãy tham khảo trang Tư duy.