How to Use Gemini 3.1 Pro Custom Tools in Instinct
Gemini 3.1 Pro Custom Tools suits coding and investigations that combine Bash with custom search and inspection tools. Compared with Gemini 3.1 Pro Preview, it prioritizes custom tools more strongly, though Google warns of quality fluctuations on tasks that do not benefit from tools.
Prompts to try with Gemini 3.1 Pro Custom Tools in Instinct
Copy an example into Instinct, or ask in your own words.
Every morning, use Gemini 3.1 Pro Custom Tools to retrieve yesterday's failed payment events and related order statuses. Report unresolved mismatches with record references, and distinguish confirmed discrepancies from incomplete data.
Every hour, use Gemini 3.1 Pro Custom Tools to compare recent error spikes with deployment events through the available monitoring tools. Return affected services, timing evidence, and the next diagnostic check in under 250 words.
Each weekday, use Gemini 3.1 Pro Custom Tools to inspect newly escalated support cases using case and account lookup tools. Group cases by documented cause and list the evidence missing from unresolved cases.
Each evening, use Gemini 3.1 Pro Custom Tools to retrieve fulfilled orders and shipment events. Identify orders with conflicting statuses, include the relevant event timestamps, and return a compact report for review.
Every Monday, use Gemini 3.1 Pro Custom Tools with high reasoning to compare changed knowledge-base articles against current support guidance. Report contradictions with passage references and proposed corrections for review.
How to set up Gemini 3.1 Pro Custom Tools in Instinct
Pick the way that suits you. Each takes about two minutes.
Use the Spiral skill
- Send Instinct this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use Spiral's MCP server
- Create an API key
In the console, open API keys and create a key for Instinct. Copy it.
- Send Instinct this message
Instinct reads Spiral's skill and asks for your API key.
set up https://spiral.ai/SKILL.md
- Give Instinct the key
When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Gemini 3.1 Pro Custom Tools
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "vertex", "model": "google/gemini-3.1-pro-preview-customtools", "input": { "messages": [ { "role": "system" } ] } }'
Then paste one of the prompts above: Instinct finds Gemini 3.1 Pro Custom Tools on Spiral, shows the price and runs it.
Gemini 3.1 Pro Custom Tools providers and prices
Spiral runs Gemini 3.1 Pro Custom Tools through Vertex AI. Open a card for today's price, with every fee included.
Up to $0.063989 per run at the default inputs. $2.60 per 1M input tokens, $0.26 per 1M cached input tokens, $0.4875 per 1M cache write tokens, $15.60 per 1M output tokens; for a prompt above 200,000 tokens, $5.20 per 1M input tokens, $0.52 per 1M cached input tokens, $0.975 per 1M cache write tokens, $23.40 per 1M output tokens.
Settings you can ask for
Ask Instinct for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Seed | a whole number | ||
| Top p | 0 to 1 | ||
| Max tokens | 1 to 65536 | The most output tokens to generate. | |
| Temperature | 0 to 2 | ||
| Presence penalty | a number from -2 | ||
| Reasoning effort | low, medium, or high | high | How much the model reasons. |
| Frequency penalty | a number from -2 |
Every API field of Gemini 3.1 Pro Preview Custom Tools is on its tool page: open its card above.
What can you do with Gemini 3.1 Pro Custom Tools in Instinct?
Produce recurring investigations that connect fresh records with a concise evidence report using Gemini 3.1 Pro Custom Tools. Define what counts as a discrepancy and what evidence each scheduled report must include.
Trace a bug across a repository
Use code search and inspection tools to follow a failing request through the relevant modules. Ask for a minimal patch and a test that reproduces the failure.
Plan and verify a refactor
Find callers, inspect assumptions, and change one interface at a time. Request a report of affected behavior and the checks used to verify it.
Investigate recurring test failures
Combine test output, code inspection, and targeted test runs to examine intermittent failures. Separate reproduced causes from hypotheses that still need evidence.
Prepare a support investigation
Retrieve account history, order records, and relevant policy through custom tools. Build a timeline and draft a response that distinguishes confirmed facts from missing information.
Triage operational incidents
Query monitoring data and deployment history, then compare the timing of errors and changes. Produce an evidence-based incident brief with the next checks to run.
Investigate business data discrepancies
Retrieve related records from business systems and use calculation tools to compare totals. Return discrepancies with record references and leave unresolved matches explicit.
Turn retrieved evidence into a structured report
Search a knowledge base for material relevant to a question, compare conflicting statements, and return a concise report or schema-constrained JSON for downstream validation.
More on Gemini 3.1 Pro Custom Tools and Instinct
Gemini 3.1 Pro Custom Tools in other agents
Questions about Gemini 3.1 Pro Custom Tools in Instinct
Can Instinct use Gemini 3.1 Pro Custom Tools?
Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run Gemini 3.1 Pro Custom Tools like any built-in tool.
How much does Gemini 3.1 Pro Custom Tools cost in Instinct?
Up to $0.063989 per run at the default inputs. $2.60 per 1M input tokens, $0.26 per 1M cached input tokens, $0.4875 per 1M cache write tokens, $15.60 per 1M output tokens; for a prompt above 200,000 tokens, $5.20 per 1M input tokens, $0.52 per 1M cached input tokens, $0.975 per 1M cache write tokens, $23.40 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Instinct plan is separate.
Do I need a Vertex AI account to use Gemini 3.1 Pro Custom Tools in Instinct?
You need no Vertex AI account. Instinct uses one Spiral API key for every tool, and Spiral runs Gemini 3.1 Pro Custom Tools on its own Vertex AI account.
How long does it take to set up Gemini 3.1 Pro Custom Tools in Instinct?
About two minutes: create an API key, then send Instinct this message, then give Instinct the key.
Does Instinct wait while Gemini 3.1 Pro Custom Tools runs?
Gemini 3.1 Pro Custom Tools runs in the background. Instinct starts the run, checks on it and gives you the text, json when it's ready.
How does Gemini 3.1 Pro Custom Tools differ from Gemini 3.1 Pro Preview?
It prioritizes custom tools more strongly in workflows that also use Bash. Choose it for tasks that benefit from searching, inspecting evidence, and acting on tool results.
Is Gemini 3.1 Pro Custom Tools better for every task?
Google warns of quality fluctuations on tasks that do not benefit from tools. Test it on your actual work before choosing it for standalone writing or simple questions.
How much context and output can Gemini 3.1 Pro Custom Tools handle?
Google lists a maximum of 1,048,576 input tokens and 65,536 output tokens for Gemini 3.1 Pro. These are token limits, so request a specific answer length rather than treating them as page counts.
Can Gemini 3.1 Pro Custom Tools return reliable JSON?
Structured output can constrain the response to a supplied JSON Schema. Validate the returned values against the evidence because valid JSON can still contain incorrect information.
Which setting should I test first for difficult investigations?
Start with the default high reasoning level for a difficult investigation. Compare lower reasoning levels on routine tasks and keep the lowest level that passes your quality checks.
Start using Gemini 3.1 Pro Custom Tools in Instinct
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Instinct:
set up https://spiral.ai/SKILL.md


