google · Google AI Docs
Gemini API Thought Signatures
Explains how to use thought signatures to access and interpret the internal reasoning processes of models that support thinking capabilities.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Gemini API Thought Signatures
Explains how to use thought signatures to access and interpret the internal reasoning processes of models that support thinking capabilities.
When To Use
Use when you need to programmatically access or validate the internal reasoning steps generated by a model during its thinking process.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/gemini-api-thought-signatures-workflow-guide.md | A guide explaining how thought signatures work in the Gemini API, including implementation details for REST API users and examples for sequential and parallel function calling. | Questions about a guide explaining how thought signatures work in the Gemini API, including implementation details for REST API users... |
examples/gemini-api-thought-signatures-json-request.text | A JSON-formatted request body demonstrating how to include thought signatures within a Gemini API content part. | Exact payloads, commands, or snippets shown in A JSON-formatted request body demonstrating how to include thought signatures within a Gemini API content part. |
examples/gemini-api-thought-signatures-json.text | A JSON object demonstrating the structure of a model response containing a thought signature within a function call part. | Exact payloads, commands, or snippets shown in A JSON object demonstrating the structure of a model response containing a thought signature within a function call p... |
examples/gemini-api-thought-signatures-json-2.text | A JSON representation of a multi-turn conversation demonstrating the inclusion of a thoughtSignature within a model function call. | Exact payloads, commands, or snippets shown in A JSON representation of a multi-turn conversation demonstrating the inclusion of a thoughtSignature within a model f... |
examples/gemini-api-thought-signatures-json-3.text | A JSON object demonstrating the structure of a model response containing a thought signature within a function call. | Exact payloads, commands, or snippets shown in A JSON object demonstrating the structure of a model response containing a thought signature within a function call. |
examples/gemini-api-thought-signatures-json-4.text | A JSON-formatted example demonstrating the inclusion of a thoughtSignature field within a model function call response. | Exact payloads, commands, or snippets shown in A JSON-formatted example demonstrating the inclusion of a thoughtSignature field within a model function call response. |
examples/gemini-api-thought-signatures-json-request-2.text | A JSON-formatted request body demonstrating how to include tool declarations and user content for Gemini API thought signatures. | Exact payloads, commands, or snippets shown in A JSON-formatted request body demonstrating how to include tool declarations and user content for Gemini API thought... |
examples/gemini-api-thought-signatures-json-5.text | A JSON representation of a function call response demonstrating the inclusion of a thought signature in the first part of a multi-part response. | Exact payloads, commands, or snippets shown in A JSON representation of a function call response demonstrating the inclusion of a thought signature in the first par... |
examples/gemini-api-thought-signatures-json-request-3.text | A text file demonstrating the inclusion of the thoughtsignature field within a model function call request in the Gemini API. | Exact payloads, commands, or snippets shown in A text file demonstrating the inclusion of the thoughtsignature field within a model function call request in the Gem... |
examples/gemini-api-thought-signatures-json-6.text | A JSON object demonstrating the structure of a model response containing a thought signature field. | Exact payloads, commands, or snippets shown in A JSON object demonstrating the structure of a model response containing a thought signature field. |
examples/gemini-api-thought-signatures-json-structure.text | A text representation of a JSON conversation history demonstrating how thought signatures are interleaved within model response parts. | Exact payloads, commands, or snippets shown in A text representation of a JSON conversation history demonstrating how thought signatures are interleaved within mode... |
examples/gemini-api-thought-signatures-json-request-4.text | A JSON-formatted request body demonstrating how to include thought signatures within a Gemini API message payload. | Exact payloads, commands, or snippets shown in A JSON-formatted request body demonstrating how to include thought signatures within a Gemini API message payload. |
examples/gemini-api-thought-signatures-json-7.text | A JSON representation of a model response containing a thought signature within a tool call. | Exact payloads, commands, or snippets shown in A JSON representation of a model response containing a thought signature within a tool call. |
examples/gemini-api-thought-signatures-json-message-structure.text | A JSON-formatted message array demonstrating the required thoughtsignature field within a model tool call response. | Exact payloads, commands, or snippets shown in A JSON-formatted message array demonstrating the required thoughtsignature field within a model tool call response. |
examples/gemini-api-thought-signatures-json-8.text | A JSON representation of a model response containing a thought signature within a tool call. | Exact payloads, commands, or snippets shown in A JSON representation of a model response containing a thought signature within a tool call. |
examples/gemini-api-thought-signatures-json-message-structure-2.text | A JSON-formatted message array demonstrating the inclusion of a thoughtsignature field within a model tool call response. | Exact payloads, commands, or snippets shown in A JSON-formatted message array demonstrating the inclusion of a thoughtsignature field within a model tool call respo... |
examples/gemini-api-thought-signatures-json-9.text | A JSON object demonstrating the structure of a thought signature within an assistant role response containing tool calls. | Exact payloads, commands, or snippets shown in A JSON object demonstrating the structure of a thought signature within an assistant role response containing tool ca... |
examples/gemini-api-thought-signatures-json-message-structure-3.text | A JSON-formatted message array demonstrating the inclusion of a thoughtsignature field within an assistant tool call. | Exact payloads, commands, or snippets shown in A JSON-formatted message array demonstrating the inclusion of a thoughtsignature field within an assistant tool call. |
What This Skill Covers
- Important: Thought signatures are handled automatically when you use the official Google Gen AI SDKs and append the full model response object directly to hi...
- Main sections:
How it works,Signatures in function calling parts,Sequential function calling example,Parallel function calling example,Signatures in non functionCall parts.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://ai.google.dev/gemini-api/docs/thought-signatures