Running jobs with Plauti MCP

Last updated

A deduplicate job searches an object for duplicate records, using one of your Plauti Deduplicate matching scenarios. With Plauti MCP, your AI assistant creates, runs, and follows these jobs for you. You can then ask it to review the job results, and merge or convert results. See Using Plauti MCP for examples of what you can ask to run deduplicate jobs.

What the assistant can do with jobs

The assistant can create and start a job, check its status, read its log, and stop it. When a job is finished, the assistant summarizes the result. This includes the number of duplicate groups, the average score, and whether your license limit was reached. You can then ask the assistant to open groups and pairs, show the record values side by side, preview which record would be kept as the master, and more.

A deduplicate search job only finds duplicates. Merging or converting is a separate step, and the assistant will ask you to confirm before it proceeds.

Where jobs run

Deduplicate search jobs run on your own computer, not in Salesforce and not on a Plauti server. Plauti MCP runs the job locally with its own job engine.

Merge jobs also run on your own computer, but where search jobs run fully locally, and the data is stored locally and then deleted after, merge jobs instead call an endpoint in Plauti Deduplicate to perform the merges, so no data is leaving Salesforce there.

Convert jobs are referred back to Plauti Deduplicate in Salesforce, and run there as an auto-convert subjob to the Deduplicate job, on the Deduplicate Job tab. Note that convert jobs coming from Plauti MCP are auto-converted even when the Auto-Convert button is disabled for the object.

Because Deduplicate jobs are started from your computer, they are available only in desktop AI apps on that computer. They are not available in browser-based AI apps, and they cannot be started by Agentforce or by other agents that run on a server.

What happens to your data during a job

When a job searches for duplicates, records are downloaded from Salesforce in encrypted form over a secure connection, and are temporarily stored on your computer, until all duplicate results are found. Once the job is finished, the results are sent back to Salesforce, where you can review them and merge or convert the duplicate records. The stored records are then automatically removed from your computer.

This applies only to the search for duplicates, not to reviewing deduplicate job results. See Permissions and data.

Job interruption

A running duplicate search or merge job is aborted if you quit your AI app. It is also aborted if your computer goes to sleep or shuts down, depending on your computer’s sleep settings. For a large job, check your sleep settings before you start.

In both cases any temporary data is deleted, even though the job was not yet finished.

Where you see jobs and logs

Jobs that you create through Plauti MCP are also visible in Plauti Deduplicate in Salesforce, together with their log. You can ask the assistant to read the log and explain it.

Furthermore, on your local machine a temporary job log is kept, but that only logs the metadata of the last run job. Earlier job data is overwritten. Note that a merge job is considered a separate job, so it will overwrite the metadata of its preceding duplicate search job.
This log records metadata such as the number of records processed, whether the job result was sent back to Salesforce without failure, and a confirmation that temporary files were correctly deleted afterwards.

Job limits

  • One job at a time. If a Deduplicate search or merge job is already running, wait until it is finished before you start the next job.
  • Large jobs take time. On large objects, a job can run for several minutes to hours, and it can look like nothing is happening. Ask the assistant to check the status again later.
  • Your license applies. Jobs use your Plauti Deduplicate license and its limits.
  • Full jobs only. The assistant finds duplicates by running a job over an object. It cannot search for the duplicates of a single record or of a record that is not saved yet. To see how two specific records score, ask the assistant to test your scenarios on those two records.

Permissions and data

The assistant can only do what the Salesforce user you logged in with is allowed to do. Plauti MCP never bypasses Salesforce permissions.

When you review job results, the assistant shows record values and explains scores. These values pass through your AI assistant. If your organization has rules for AI usage and data processing, check them before you start reviewing results.

Read more in AI Features and Data Processing.