google · Google AI Docs
Gemini API Gemini Interactions API
Overview of the Gemini Interactions API designed for building coding agents and complex agentic workflows.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Gemini API Gemini Interactions API
Overview of the Gemini Interactions API designed for building coding agents and complex agentic workflows.
When To Use
Use when you need to implement agentic workflows, coding agent setups, or complex multi-turn interactions using the Gemini Interactions API.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/gemini-api-interactions-workflow-guide.md | A documentation overview describing the capabilities and autonomous research processes of the Gemini Deep Research Agent. | Questions about a documentation overview describing the capabilities and autonomous research processes of the Gemini Deep Research Ag... |
examples/gemini-api-interactions-deep-research-python-client.text | A Python code example demonstrating how to initiate and poll a deep research interaction using the Gemini API client. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to initiate and poll a deep research interaction using the Gemini API client. |
examples/gemini-api-interactions-deep-research-nodejs.text | A Node.js code example demonstrating how to initiate and poll a deep research interaction using the Gemini Interactions API. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to initiate and poll a deep research interaction using the Gemini Interactio... |
examples/gemini-api-interactions-deep-research-curl-request.text | A curl command demonstrating how to start a deep research task and poll for results using the Gemini Interactions API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to start a deep research task and poll for results using the Gemini Interactions API. |
examples/gemini-api-interactions-gemini-api-deep-research-python-interaction.text | A Python code snippet demonstrating how to use the Gemini API to create a deep research interaction plan using the genai client. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to use the Gemini API to create a deep research interaction plan using the ge... |
examples/gemini-api-interactions-gemini-api-deep-research-nodejs-interaction.text | A Node.js code example demonstrating how to create and poll a deep research interaction using the Gemini API client. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to create and poll a deep research interaction using the Gemini API client. |
examples/gemini-api-interactions-deep-research-curl-request-2.text | A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research agent configuration. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research agent configuration. |
examples/gemini-api-interactions-gemini-api-deep-research-refine-plan-python.text | A Python code snippet demonstrating how to refine a research plan using the Gemini Interactions API's deep research agent. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to refine a research plan using the Gemini Interactions API's deep research a... |
examples/gemini-api-interactions-gemini-api-deep-research-interaction-nodejs.text | A Node.js code snippet demonstrating how to create a deep research interaction using the Gemini API client. | Exact payloads, commands, or snippets shown in A Node.js code snippet demonstrating how to create a deep research interaction using the Gemini API client. |
examples/gemini-api-interactions-deep-research-curl-request-3.text | A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research agent configuration. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research agent configuration. |
examples/gemini-api-interactions-gemini-api-deep-research-interaction-python.text | A Python code snippet demonstrating how to approve a research plan and initiate a deep research interaction using the Gemini API. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to approve a research plan and initiate a deep research interaction using the... |
examples/gemini-api-interactions-gemini-api-deep-research-interaction-nodejs-2.text | A Node.js code example demonstrating how to create and poll a deep research interaction using the Gemini API. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to create and poll a deep research interaction using the Gemini API. |
examples/gemini-api-interactions-deep-research-curl-request-4.text | A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research agent configuration. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research agent configuration. |
examples/gemini-api-interactions-gemini-api-deep-research-python-interaction-2.text | A Python code example demonstrating how to initiate and poll a deep research interaction using the Gemini API client. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to initiate and poll a deep research interaction using the Gemini API client. |
examples/gemini-api-interactions-gemini-api-deep-research-nodejs-interaction-2.text | A Node.js code example demonstrating how to initiate a deep research interaction using the Gemini API client. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to initiate a deep research interaction using the Gemini API client. |
examples/gemini-api-interactions-deep-research-curl-request-5.text | A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research agent configuration. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research agent configuration. |
examples/gemini-api-interactions-gemini-api-deep-research-python-interaction-crea.text | A Python code snippet demonstrating how to create a deep research interaction using the Gemini API with Google Search tools. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to create a deep research interaction using the Gemini API with Google Search... |
examples/gemini-api-interactions-gemini-api-deep-research-nodejs-interaction-crea.text | A Node.js code example demonstrating how to create a deep research interaction using the Gemini API with Google Search tools. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to create a deep research interaction using the Gemini API with Google Searc... |
examples/gemini-api-interactions-deep-research-curl-request-6.text | A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research-preview agent with Google Search tools enabled. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research-preview agent with... |
examples/gemini-api-interactions-gemini-api-deep-research-python-interaction-crea-2.text | A Python code snippet demonstrating how to create a deep research interaction using the Gemini API client. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to create a deep research interaction using the Gemini API client. |
examples/gemini-api-interactions-deep-research-nodejs-create-interaction.text | A Node.js code snippet demonstrating how to create a deep research interaction using the Gemini API client. | Exact payloads, commands, or snippets shown in A Node.js code snippet demonstrating how to create a deep research interaction using the Gemini API client. |
examples/gemini-api-interactions-deep-research-curl-request-7.text | A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research-preview agent with urlcontext tools. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research-preview agent with... |
examples/gemini-api-interactions-gemini-api-deep-research-python-interaction-crea-3.text | A Python code snippet demonstrating how to create a deep research interaction using the Gemini API with code execution tools. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to create a deep research interaction using the Gemini API with code executio... |
examples/gemini-api-interactions-gemini-api-deep-research-nodejs-interaction-crea-2.text | A Node.js code snippet demonstrating how to create a deep research interaction using the Gemini API with code execution tools. | Exact payloads, commands, or snippets shown in A Node.js code snippet demonstrating how to create a deep research interaction using the Gemini API with code executi... |
examples/gemini-api-interactions-deep-research-curl-request-8.text | A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research-preview agent with code execution tools. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research-preview agent with... |
examples/gemini-api-interactions-deep-research-python-create-interaction.text | A Python code snippet demonstrating how to create a deep research interaction using the Gemini API with an MCP server tool. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to create a deep research interaction using the Gemini API with an MCP server... |
examples/gemini-api-interactions-gemini-api-deep-research-interaction-create-node.text | A Node.js code snippet demonstrating how to create a deep research interaction using the Gemini API with an MCP server tool. | Exact payloads, commands, or snippets shown in A Node.js code snippet demonstrating how to create a deep research interaction using the Gemini API with an MCP serve... |
examples/gemini-api-interactions-deep-research-curl-request-9.text | A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research-preview agent and MCP tools. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research-preview agent and... |
examples/gemini-api-interactions-gemini-api-deep-research-python-interaction-3.text | A Python code snippet demonstrating how to initiate a deep research interaction using the Gemini API with file search tools. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to initiate a deep research interaction using the Gemini API with file search... |
examples/gemini-api-interactions-deep-research-nodejs-create-interaction-2.text | A Node.js code snippet demonstrating how to create a deep research interaction using the Gemini API client. | Exact payloads, commands, or snippets shown in A Node.js code snippet demonstrating how to create a deep research interaction using the Gemini API client. |
examples/gemini-api-interactions-deep-research-curl-request-10.text | A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research-preview agent with file search tools. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research-preview agent with... |
examples/gemini-api-interactions-gemini-api-deep-research-prompt.text | A text-based example demonstrating a complex research prompt for the Gemini deep research agent. | Exact payloads, commands, or snippets shown in A text-based example demonstrating a complex research prompt for the Gemini deep research agent. |
examples/gemini-api-interactions-gemini-api-deep-research-nodejs-interaction-3.text | A Node.js code example demonstrating how to use the Gemini Interactions API to initiate a deep research task with a structured prompt. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to use the Gemini Interactions API to initiate a deep research task with a s... |
examples/gemini-api-interactions-deep-research-curl-request-11.text | A curl command demonstrating a POST request to the Gemini Interactions API endpoint for performing deep research tasks. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini Interactions API endpoint for performing deep research tasks. |
examples/gemini-api-interactions-gemini-api-deep-research-python-multimodal-analy.text | A Python code example demonstrating how to use the Gemini API to perform deep research and multimodal analysis on an image of an African watering hole. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to use the Gemini API to perform deep research and multimodal analysis on an... |
examples/gemini-api-interactions-gemini-api-deep-research-nodejs-multimodal-promp.text | A Node.js code example demonstrating a multimodal prompt for analyzing interspecies dynamics and behavioral risks in an image using the Gemini API. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating a multimodal prompt for analyzing interspecies dynamics and behavioral risks in... |
examples/gemini-api-interactions-deep-research-curl-image-input.text | A curl command demonstrating how to initiate a deep research task using the Gemini Interactions API with an image input. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to initiate a deep research task using the Gemini Interactions API with an image input. |
examples/gemini-api-interactions-gemini-api-deep-research-python-interaction-4.text | A Python code snippet demonstrating how to use the Gemini Client to create a deep research interaction with a document URI. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to use the Gemini Client to create a deep research interaction with a documen... |
examples/gemini-api-interactions-deep-research-nodejs-create-interaction-3.text | A Node.js code example demonstrating how to create a deep research interaction using the GoogleGenAI client with a text input and a PDF document URI. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to create a deep research interaction using the GoogleGenAI client with a te... |
examples/gemini-api-interactions-gemini-api-deep-research-curl-start-task.text | A curl command demonstrating how to initiate a deep research task using the Gemini Interactions API with document input. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to initiate a deep research task using the Gemini Interactions API with document input. |
examples/gemini-api-interactions-gemini-api-python-deep-research-interaction-stre.text | A Python code example demonstrating how to process a stream of events for a Gemini API deep research interaction. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to process a stream of events for a Gemini API deep research interaction. |
examples/gemini-api-interactions-gemini-api-deep-research-nodejs-interaction-stre.text | A Node.js code example demonstrating how to process a stream of interaction events for the Gemini Deep Research API. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to process a stream of interaction events for the Gemini Deep Research API. |
examples/gemini-api-interactions-gemini-api-deep-research-curl-interaction-start.text | A curl command demonstrating how to initiate a deep research interaction session using the Gemini API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to initiate a deep research interaction session using the Gemini API. |
examples/gemini-api-interactions-python-create-interaction.text | A Python code snippet demonstrating how to use the Gemini API to create a new interaction by referencing a previous interaction ID. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to use the Gemini API to create a new interaction by referencing a previous i... |
examples/gemini-api-interactions-create-interaction-nodejs.text | A Node.js code example demonstrating how to create a new interaction using the Gemini API by referencing a previous interaction ID. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to create a new interaction using the Gemini API by referencing a previous i... |
examples/gemini-api-interactions-curl-post-request.text | A curl command demonstrating a POST request to the Gemini Interactions API endpoint using a previous interaction ID. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini Interactions API endpoint using a previous interaction ID. |
examples/gemini-api-interactions-gemini-api-deep-research-python-agent-config.text | A Python code snippet demonstrating how to configure and initialize a deep research agent using the Gemini Interactions API. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to configure and initialize a deep research agent using the Gemini Interactio... |
examples/gemini-api-interactions-gemini-api-deep-research-interaction-create-node-2.text | A Node.js code example demonstrating how to create a deep research interaction using the Gemini API client. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to create a deep research interaction using the Gemini API client. |
examples/gemini-api-interactions-deep-research-curl-request-12.text | A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research agent configuration. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini Interactions API using the deep-research agent configuration. |
What This Skill Covers
- The Gemini Deep Research Agent autonomously plans, executes, and synthesizes multi-step research tasks. Powered by Gemini, it navigates complex information l...
- Main sections:
Python,JavaScript,REST,Supported Versions,Collaborative planning.
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/deep-research