Skip to main content

AMROAR Technologies

Agentforce implementation troubleshooting — permissions and access check

Agentforce Implementation: The #1 Permission Mistake Killing Your ROI

You did everything right. Picked a solid use case. Configured the agent carefully. Connected it to your data. Tested it. Went live. And now you’re sitting there looking at a dashboard that says your Agentforce implementation is technically running — except it’s not actually working. Customers are getting bounced to a human more than you expected. Your reps are quietly double-checking everything the agent says before they trust it. And leadership keeps asking why the numbers don’t match what you promised in the business case.

If that’s where you are right now, take a breath. You haven’t broken anything, and the product isn’t faulty. There’s one specific gap that trips up almost every Agentforce rollout — and it’s almost never the thing teams think to look at first.

It’s not your prompts. It’s not the use case you picked. And not even which Salesforce edition you’re on.

It’s whether your agent actually has permission to see what it needs to see.

Let me walk you through what that means, and why it quietly wrecks more implementations than anything else.

The Thing Almost Nobody Checks in Their Agentforce Implementation

Here’s a story I’ve seen play out more times than I can count during an Agentforce implementation.

A team builds an agent to handle billing questions. They hook it up to the Account and Case objects. They write clean, well-thought-out instructions. And they run a few test questions, the agent nails every one, and they ship it.

Three weeks later, things start falling apart on real customer conversations — conversations the test cases never came close to. The agent says it can’t find information that’s clearly sitting right there in the org. It gives half-answers. It punts to a human constantly, even on the simplest requests.

So the team goes digging. They check the prompts — fine. They check the topic setup — fine also they check the actual data — it’s there, in the right fields, no issues.

So what’s actually going on?

In the vast majority of cases like this, the real answer is data access and permissions — specifically, the user the agent is running as doesn’t actually have visibility into the records, fields, or related lists it needs in order to answer the question. Agentforce plays by your existing Salesforce sharing rules. If that running user can’t see a field, a related record, or an entire object because of profile settings, sharing rules, or field-level security — your agent can’t see it either. Doesn’t matter how good your prompts are.

This is, by a wide margin, the most common reason a well-built Agentforce implementation looks great in testing and then quietly falls apart once real customers start talking to it.

Why This Slips Through So Easily

I want to be clear — this isn’t a sign your Agentforce implementation was done sloppily. There are some very understandable reasons this gets missed almost every single time.

Whoever tests it is usually an admin. When you’re building and testing an agent, you’re probably logged in as a system admin or someone with pretty wide-open access. Everything looks fine because you can see everything. But the actual user the agent runs as in production — often some dedicated integration or service account — has a completely different, usually much tighter, permission set. You’re testing with one set of eyes and deploying with another.

Most Agentforce guides walk you through configuration, not access. Setup documentation focuses on topics, actions, instructions — the visible building blocks. Reviewing your permission and sharing model isn’t treated as a required step, because it’s “basic Salesforce admin stuff” that’s assumed to already be sorted. Except basic doesn’t mean obvious, especially in an org that’s accumulated sharing rules over five or six years.

The failure doesn’t look like a permissions problem. When an agent can’t access something, it doesn’t throw up a clean “access denied” message for the customer to see. It just acts like it doesn’t know the answer. Or gives a half-baked response. Or punts to a human. Teams naturally assume that’s a prompt issue or a knowledge gap, and they spend hours rewriting instructions that were never actually the problem.

It’s invisible until the wrong record shows up. Permission and sharing setups are rarely uniform across every record — different owners, different sharing rules, different record types. So the agent might perform beautifully for some accounts and mysteriously fall apart on others. Unless you’re deliberately testing across a real spread of records, this pattern is easy to miss entirely.

What Fixing Your Agentforce Implementation Actually Looks Like

This isn’t a massive lift. But it does need to be its own deliberate step in your agentforce implementation process — not something you only think about after everything else has failed.

1. Find Out Exactly Who the Agent Is Running As

Every Agentforce agent operates under a specific Salesforce user context. Go find out exactly which user or permission set that is — don’t guess, don’t assume. Pull up that profile and permission set assignment directly and look closely at object permissions, field-level security, and record-level sharing.

2. Match Up What the Agent Needs Against What It Can Actually See

Make a list — every object and field your agent needs to reference: Accounts, Cases, custom objects, related lists, whatever it is. Then go through each one and check it against what the running user can actually access. It’s a bit tedious, I won’t pretend otherwise. But skipping this step is exactly how teams end up debugging confusing failures in production instead of catching the problem before anyone notices.

3. Actually Test as the Running User — Not as Yourself

This is the step almost everyone skips. Before you go live, run your test scenarios logged in as (or impersonating) the actual user the agent operates under — not your own admin login. If that’s not easy to do, at the very least, sit down and go line by line through that permission set against everything the agent needs.

4. Don’t Forget Sharing Rules and Record Ownership

If your org uses ownership-based sharing, role hierarchies, or criteria-based sharing rules, test against records that belong to different people, sit in different stages, and span different record types. An agent that works great on accounts owned by your top performer might completely fall apart on accounts owned by someone three branches over in the role hierarchy.

5. Don’t Stop at Standard Salesforce Objects

If your agent is pulling from Salesforce Data Cloud or connecting to external data through an integration, the same exact issue can show up one layer deeper. The agent needs proper access to those unified profiles and data streams too — Data Cloud has its own data space and permission model, and it needs to be checked separately from your standard Salesforce sharing setup.

A Story That Actually Happened

A mid-market SaaS company’s Agentforce implementation was built to summarize account health for their customer success team before renewal calls. It was pulling from Account, Opportunity, Case, and a custom Health Score object they’d built.

During testing, the CS lead — who happened to be a Salesforce admin — ran it against a dozen sample accounts, and it was genuinely impressive. Clean summaries, accurate numbers, smart next-step suggestions.

Then it went live. And CS reps started coming back saying the agent kept telling them it “couldn’t find sufficient information” — for accounts that very obviously had plenty of data sitting right there.

Two weeks went by. The team rewrote the instructions. They tweaked the topic. They double, triple-checked the Health Score object setup. Nothing helped.

Finally, someone thought to check the actual permission set assigned to the agent’s running user.

Turns out — it had read access to Account and Opportunity. But not to the Health Score object. And Case visibility was locked down by a sharing rule that only applied to records owned by a specific support queue.

They updated the permission set to include Health Score, added a sharing rule exception for the agent’s running user, and just like that — the agent started performing exactly like it had in testing. Consistently. Across every record. Regardless of who owned it.

Two weeks of “prompt tuning” that fixed nothing. Twenty minutes of checking permissions that fixed everything.

Symptom-Chasing vs. Checking Permissions First

Symptom-Chasing Approach Permission-First Approach
First response to a failure Rewrite prompts and instructions Check the running user’s object and field access
Time to actually find the cause Days to weeks Minutes to a couple of hours
How testing happens Admin account, ideal records Actual running user, varied record ownership
What usually happens Partial fixes, the problem keeps coming back Steady performance across every record
How the team feels afterward Frustrated, unsure what actually changed Confident — they know exactly what was wrong

Where This Fits Into Your Bigger Agentforce Picture

This permission check doesn’t replace the other foundational work your agentforce implementation needs — clean data, a well-scoped use case, a knowledge base someone’s actually keeping updated. We’ve covered that side of the equation in detail — why most Agentforce deployments fail before they even get to permissions.It’s a separate layer that sits on top of all of that, and it’s one most checklists skip entirely.

You could have spotless data, a beautifully scoped agent, and a perfectly maintained knowledge base — and still hit a wall in production because the agent’s running user simply can’t see the records it needs. Data quality and data access are two completely different problems, and most implementation guides only ever talk about the first one.

If you’re building or troubleshooting salesforce ai agents more broadly, treat access and permissions as a required check right alongside data quality and scope — not something you only look at once you’ve ruled out everything else.

What This Means for Your Business

If your Agentforce agent is technically live but just not performing the way it should, don’t reach for the prompts first. Go check what the running user can and can’t see.

This one check, done properly before go-live, prevents the single most common — and most confusing — failure mode in real Agentforce deployments. It takes maybe thirty minutes and can save you weeks of chasing the wrong problem.

If you’re evaluating salesforce ai tools more broadly across your business, this is a pretty good litmus test for how ready your implementation process really is. If your team can’t quickly answer “what does our agent’s running user actually have access to,” that’s a sign you need a clearer access-review step before you roll out more use cases.

Getting real value from salesforce ai isn’t about chasing whatever feature launched last week. It’s about getting the unglamorous fundamentals — data, scope, and access — right before you flip the switch, so the technology actually gets the chance to do what it’s capable of.

Troubleshooting an Agentforce deployment that just isn’t performing the way it should? Talk to Amroar — we’ll help you find what’s actually wrong instead of guessing. Or connect with us on LinkedIn to start the conversation.

Questions we get asked every week.

Why is my Agentforce agent not working? +
What permission sets does Agentforce need? +
Does Agentforce respect Salesforce user permissions? +
Why does my Agentforce agent work for some records but not others? +
How do I check what permissions an Agentforce agent’s running user has? +
Why does Agentforce fail in production but work in testing? +

Comments are closed