You are here:
CRM Analytics with Agentforce Coworker (Beta)
Connect Agentforce Coworker to a dedicated CRM Analytics agent that uses CRM Analytics MCP server so that your users can ask natural-language questions about their analytics data without leaving Coworker.
Required Editions
| Available in Lightning Experience |
| Available with CRM Analytics, which is available for an extra cost in Enterprise, Performance, and Unlimited Editions |
What Your Users Can Do
After you set up the connection, your users can ask Coworker to:
- Find datasets, dashboards, lenses, and apps.
- Get a summary of what a dashboard, lens, or app contains.
- Review a dataset's fields.
- Run a SAQL query on a dataset and see the results in Coworker.
For example, a user can ask, "Run a SAQL query on the Opportunity dataset to get the total Amount by StageName."
The connection is read-only. Users can look up and query analytics assets, but they can't create, change, delete, run, or schedule them.
Components of the Connection
The three components in this table work together to get a question from Coworker to your analytics data.
| Component | What It Does |
|---|---|
| Agentforce Coworker | The AI assistant and enterprise search experience that your users ask questions in. Coworker can hand off a question to another Agentforce agent. |
crma_mcp agent |
An Agentforce Employee Agent with a CRM Analytics subagent and default fallback subagents. Its actions call the CRM Analytics MCP server tools. Coworker routes analytics questions to this agent. |
CRM Analytics MCP server (crma-beta) |
The Salesforce-hosted MCP server that provides 10 read-only tools to list and get datasets, dashboards, lenses, and apps, get dataset field schemas (XMD), and run SAQL queries. |
How the crma_mcp Agent Is Structured
The crma_mcp agent has an agent router and the subagents in this table.
| Component | What It Does |
|---|---|
| Agent Router | Classifies the user's intent. Routes data and analytics questions to the CRM Analytics subagent. |
| CRM Analytics | Does read-only CRM Analytics work. Discovers and queries assets by using the 10 crma-beta MCP tools. |
| General FAQ | Answers company and product questions from knowledge articles. |
| Off Topic and Ambiguous Question | Politely redirects the user or asks for clarification. |
The CRM Analytics subagent has an action for each crma-beta tool. Its
instructions set these rules.
- Discovery first. The agent lists an asset before it gets or queries the asset, so
it doesn't guess dataset, dashboard, lens, or app IDs. To run a SAQL query, the agent
calls
list_datasets, thenget_datasetorget_xmdfor the exact field names, and thenexecute_query. - Correct SAQL usage. The agent uses the dataset's current version ID and case-sensitive field names in its queries.
- Read-only. The agent refuses requests to create, update, delete, run, or schedule anything.
- Grounded answers. The agent bases every answer on data that an action returns.
For the list of tools, see CRM Analytics MCP Server Tool Reference.
How a Question Gets Answered
Coworker answers a CRM Analytics question in these stages.
- Coworker's Search Agent recognizes that the question is about analytics data and hands
it off to the
crma_mcpagent. - The agent router in the
crma_mcpagent routes the question to the CRM Analytics subagent. - The CRM Analytics subagent calls its actions. Each action targets a
crma-betaMCP tool, such asplatformMcpTool://analytics/crma-beta/list_datasets. - CRM Analytics MCP server runs the tool as the Coworker user and returns the results to the agent.
- The agent composes an answer from the returned data, and Coworker shows it to the user.
Security and Billing
Queries run as the Coworker user, so CRM Analytics field-level security, row-level security, and sharing all apply. The agent can see only the assets that the user can see. Calls to CRM Analytics MCP server and Coworker interactions use Flex Credits.
Setup takes five steps: turn on the MCP server, register it, create the
crma_mcp agent, turn on the agent for Coworker, and test it in Coworker.
For the steps, see Set Up Agentforce
Coworker to Query CRM Analytics Data (Beta).
