> ## Documentation Index > Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt > Use this file to discover all available pages before exploring further. # Как исправить ошибки 400 (Thought Signature) в Gemini при вызовах инструментов? > В моделях Gemini 3 и новее ошибка «Function call is missing a thought_signature» означает, что ваш клиент потерял подпись при воспроизведении истории; «Invalid / Corrupted thought signature» означает, что подпись не прошла валидацию на текущем маршруте. Как их различить и устранить каждую из них. ## Краткий ответ При выполнении многоэтапного вызова функций (function calling) моделями Gemini 3 и более поздними (gemini-4-argon, gemini-3.8-flash, gemini-3.1-pro-preview и т. д.) возникают два типа ошибок 400, связанных с подписью рассуждений (`thoughtSignature`), и для них требуются разные решения: | Текст ошибки | Значение | Решение | | - | - | - | | `Function call is missing a thought_signature in functionCall parts` | **В вашем запросе отсутствует подпись.** Поле `thoughtSignature` было удалено из части `functionCall` предыдущего шага при повторной отправке истории диалога | Исправьте клиент: верните предыдущий ответ модели в историю **без изменений**; не пересобирайте эту часть заново | | `Invalid thought signature` / `Corrupted thought signature` | **Подпись была отправлена, но не прошла валидацию на текущем маршруте.** Обычно диалог сменил маршрут, модель, ключ или группу в процессе общения | Отправьте запрос повторно один раз без изменений; если ошибка сохраняется, удалите `thoughtSignature` из предыдущих шагов истории и отправьте снова либо начните новый диалог | Если вы выполняете вызовы через OpenAI-совместимый эндпоинт `/v1/chat/completions`, **к вам это не относится**: шлюз сам управляет подписями, и стандартных сообщений `tool_calls` / `tool` будет вполне достаточно. ## Как различить эти две ошибки ### Отсутствующая подпись ```text theme={null} 400 Function call is missing a thought_signature in functionCall parts. This is required for tools to work correctly, and missing thought_signature may lead to degraded model performance. Additional data, function call `default_api:Bash`, position 2. ``` В сообщении указывается функция и её индекс в массиве `parts`. Это строгое правило, установленное провайдером модели для семейства Gemini 3: **каждая часть `functionCall` в текущей реплике должна содержать свою подпись.** При отсутствии подписи запрос завершается ошибкой 400 на любом маршруте, и повторные попытки не помогут. ### Недействительная или поврежденная подпись ```text theme={null} 400 Invalid thought signature. 400 Corrupted thought signature. ``` Поле присутствует, но не проходит валидацию. Подпись представляет собой зашифрованный blob-объект, который **может проверить только создавший его маршрут**. Если в ходе диалога меняется маршрут, модель, ключ или группа, ранее созданные подписи могут перестать приниматься. ## Почему это происходит Когда включены tools, модели Gemini 3 прикрепляют зашифрованный `thoughtSignature` к той же части, что и каждый `functionCall`, фиксируя состояние рассуждения на этом шаге. При следующем запросе модели он необходим для продолжения цепочки рассуждений, поэтому провайдер требует отправлять его обратно без изменений. Самая частая причина. Кастомный фреймворк или middleware при сборке истории сохраняет только `name` и `args` из `functionCall` и отбрасывает соседний `thoughtSignature`; либо чанки при потоковой передаче собираются заново без объединения с подписью. Клиент сократил или суммаризировал контекст либо объединил несколько частей в одну, из-за чего подпись была удалена вместе с ними. Первые реплики обрабатывались маршрутом A, а последующие попали на маршрут B, который не распознает подписи маршрута A. Переключение может произойти из-за смены вами группы или ключа либо в результате автоматического переключения при сбое. Начало на gemini-3.8-flash и переключение на gemini-4-argon в рамках одного диалога. Подписи не переносятся между моделями. При параллельных вызовах функций модель прикрепляет подпись только к **первой** части `functionCall`; у остальных ее обоснованно нет, поэтому не создавайте ее искусственно. При последовательных вызовах (несколько шагов в рамках одной реплики) каждый шаг содержит подпись, и каждую из них необходимо возвращать. ## Исправление 1: отсутствует подпись, измените способ воспроизведения истории клиентом При использовании официального `google-genai` SDK просто используйте `contents.append(response.candidates[0].content)`; не извлекайте только поле `function_call`. При отправке прямых REST-запросов реплика модели в `contents` второго запроса должна выглядеть следующим образом: ```json theme={null} { "role": "model", "parts": [ { "functionCall": { "name": "lookup_order", "args": { "order_id": "B5001" } }, "thoughtSignature": "AY89..." } ] } ``` `thoughtSignature` и `functionCall` — это **два поля одной и той же части**, а не две разные части. При работе с LangChain, кастомным фреймворком агентов или слоем трансляции OpenAI-в-Gemini выведите фактическое тело второго запроса и убедитесь, что `thoughtSignature` все еще присутствует. `position N` в тексте ошибки — это `parts[N]`; проверяйте сразу там. Модели и маршруты различаются по строгости проверки отсутствующих подписей: одни пропускают их, другие возвращают 400. Если один и тот же код всегда работал на gemini-3.8-flash, но падает на gemini-4-argon, вероятнее всего, подпись никогда не отправлялась и ранее просто допускалась. Возврат подписей в соответствии с требованиями провайдера работает стабильно на всех моделях. ## Решение 2: недействительная подпись, повторите отправку или начните заново Когда шлюз APIYI получает ошибку 400 из-за подписи, он автоматически повторяет попытку по другому маршруту, поэтому обычная повторная отправка часто завершается успешно. Никаких изменений вносить не требуется. Удалите поле `thoughtSignature` из частей каждой реплики `role: "model"` в истории, затем отправьте запрос повторно. Вы потеряете контекст рассуждения этих реплик, и качество ответа может незначительно снизиться, но диалог можно будет продолжить. Удаляйте подписи только из реплик истории, но ни в коем случае не из текущей. Самый простой и надежный вариант. В новом диалоге каждая подпись создается по одному и тому же маршруту с самой первой реплики. Если вам нужно сменить модель, ключ или группу, сначала начните новый диалог. Не переключайте их внутри диалога, в котором уже есть история вызовов инструментов. ## Отсутствие обработки подписи на OpenAI-совместимом эндпоинте При вызове Gemini через `/v1/chat/completions` сообщения `tool_calls` не содержат поля подписи; шлюз сохраняет и восстанавливает его во время преобразования. В наших тестах на gemini-4-argon двухшаговые диалоги успешно работали для всех трёх форматов: одиночный вызов, два параллельных вызова и текст плюс вызов. Просто возвращайте сообщения `tool_calls` и `tool` стандартным для OpenAI способом. Клиентам, таким как Codex, которые по умолчанию используют `/v1/responses`, необходимо переключиться на протокол чата, поскольку модели Gemini пока не поддерживают этот эндпоинт. См. [Генерация текста Gemini 4 Argon](/ru/api-capabilities/gemini-4-argon/overview). ## Часто задаваемые вопросы Нет. Возврат подписей — это требование провайдера для всего семейства Gemini 3; маршруты некоторых моделей просто менее строги к их отсутствию. Переход на строго валидирующую модель вскрывает проблему, но первопричина по-прежнему заключается в клиенте, который вообще не отправлял подпись. Нет. Подпись действительна только на том маршруте и в контексте того диалога, где она была создана. Копирование ее в другой диалог приведет к ошибке Invalid. В той же части, что и `functionCall`, внутри чанка, который ее содержит. При повторной сборке stream объедините это поле вместе с `functionCall` в итоговый ответ модели, прежде чем возвращать его в историю. Не строго обязательно. Провайдер жестко валидирует подписи только в частях `functionCall`; отсутствие подписи в текстовой реплике не приводит к ошибке 400, однако ее сохранение помогает непрерывности рассуждения, поэтому в любом случае возвращайте весь ответ дословно. ## Связанные документы Полный двухшаговый пример, включая возврат сигнатур Примечания к многошаговым tool-call и настройка клиента Тот же класс проблем на стороне Claude Как каждый провайдер ожидает передачу истории This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.