The Salesforce Query Tool
Run a governed, read-only SOQL query against Salesforce so an agent can pull accounts, opportunities, and contacts into a task — grounding answers in live CRM data without risk of writes.
Reading isn’t doing
Most AI stops at retrieval: it can tell you what happened but can’t do anything about it. The value is in the write — creating the ticket, sending the reply, updating the record — and that demands governance, approval, and an audit trail most integrations lack.
Search-only agents
An agent that can’t act leaves every follow-up to a human.
Risky writes
Ungoverned write access to Slack, Jira, or CRM is dangerous.
Credential sprawl
Tokens scattered across tools are a breach waiting to happen.
No approval path
Consequential actions need a human gate that most bots skip.
Salesforce Query, without the risk
Capability
What it does
Query Salesforce records with SOQL, read-only.
it runs a read-only SOQL query against Salesforce and returns the matching records.
Assignable to any agent
How it works
Predictable, inspectable behavior
Designed to be reliable.
queries run through a governed connection with read-only scope and logging, so an agent can pull CRM data safely without any ability to modify it.
Every call logged
Governance
Private, governed, on-premise
Runs inside your perimeter.
Writes run under role-based policy with optional human approval, using credentials held in your own vault, and every action is logged — so an agent can act across your stack without over-permissioned access or data leaving your control.
Per-tenant, logged
Parameters
The salesforce_query tool accepts these inputs when an agent calls it. Required inputs are flagged.
default: 200 Optional Maximum records to return.
How the Salesforce Query tool works in practice
Salesforce Query is an integration & action tool you assign to a VDF AI agent. It runs a read-only SOQL query against Salesforce and returns the matching records. Its hallmarks — Salesforce, SOQL, Read-only — let an agent rely on it as a dependable step in a larger task rather than a brittle one-off script.
Under the hood, queries run through a governed connection with read-only scope and logging, so an agent can pull CRM data safely without any ability to modify it. It expects soql as required input, so calls are explicit and easy to audit. Every call is scoped to the requesting tenant and written to an audit log, so the capability is safe to run inside a regulated, on-premise environment — the same governance model behind every VDF AI tool.
Teams reach for Salesforce Query when they need to handle CRM grounding, reporting, and enrichment. It rarely works alone — pair it with Salesforce Create Record, Salesforce Update Record, and Read-Only SQL Query to build a complete, governed workflow, then compose those steps into an on-premise VDF AI Network.
Where Salesforce Query pays back
CRM grounding
Pull account and deal data into an answer.
Reporting
Query records to compile a report.
Enrichment
Fetch a contact’s details for context.
Pipeline insight
Read opportunities for analysis.
Assigned to agents, orchestrated as networks
On VDF AI, an industry’s use cases map to agents, and you assign tools like this one to those agents. Compose multiple agents into a governed, on-premise network.
What changes after you assign it
Questions about the Salesforce Query tool
What is the Salesforce Query tool?
It runs a read-only SOQL query against Salesforce and returns the matching records. Assigned to a VDF AI agent, it runs under role-based policy with full audit logging so the capability is safe to use in production.
Can it modify records?
No. This tool is strictly read-only; writes go through the create and update record tools under policy.
What query language does it use?
SOQL, Salesforce’s query language, so you can target exactly the records and fields you need.
What inputs does the Salesforce Query tool need?
It requires soql, and optionally accepts limit. Each parameter is validated when an agent calls the tool, and the full call is logged for audit.
Which tools pair well with Salesforce Query?
Salesforce Query is commonly assigned alongside Salesforce Create Record, Salesforce Update Record, and Read-Only SQL Query. On VDF AI you compose several tools and agents into a single governed, on-premise network.
Does it run on-premise?
Yes. Like every VDF AI tool, it can run on-premise or in your sovereign cloud, scoped per user and audit-logged, so your data never leaves your perimeter.
How do agents use it?
You assign the tool to an agent under a role-based policy; the agent calls it as one step in a task, and several agents and tools can be orchestrated together as a governed VDF AI Network.
Assign Salesforce Query to these agents
These VDF AI agents can be assigned this tool. Open an agent to see the full toolkit it can run.
Tools that work well alongside this one
Where this tool delivers value
Put Salesforce Query to work
See the Salesforce Query tool assigned to an agent and orchestrated in a governed, on-premise network.