Security | Investigate User

Investigates a specific user's activity, reports, object access, and permission path to help analyze anomalies and answer investigative questions.

Required Editions

Available in: Lightning Experience
Available in: Enterprise, Performance, Unlimited, and Developer Editions with the Security Center add-on and Foundations or Agentforce 1 Editions.
User Permissions Needed
To view Security Center pages: View Security Center
To create and edit security policies: Manage Security Center
See Common User Access for Standard Agent Actions.

Action Details

API Name InvestigateUser
Reference Action Type Standard Action
Does this tool run one or more prompt templates? Yes
Required setup Turn on Security Center and Security Agent with View Security Center or Manage Security Center user permission.

InvestigateUser and Prompt Templates

The tool runs the Investigate User prompt template. The prompt template acts as a Salesforce investigation specialist.

  • Synthesizes user profile data, activity patterns, report usage, access evaluation, and permission lineage into a clear, actionable summary.
  • Identifies notable events.
  • Evaluates whether access is appropriate.
  • Traces permissions granted through profiles, permission sets, and roles.
  • Provides the next steps for investigation.

Guidelines and Considerations

InvestigateUser investigates users flagged in anomaly detection.

  • Provides a comprehensive user investigation, including profile, activity, and permissions data.
  • Evaluates whether user access to objects is appropriate and provides a rationale.
  • Traces permission lineage to identify how the system granted access.
  • Identifies risky permission grants that require review.
  • Includes clear next steps for further investigation or remediation in the output.