Skip to content

Salesforce Agentforce usage

Salesforce Agentforce contributes Flex Credit and action-level usage rows for AI activity inside Salesforce.

Release state

This guide documents the read-only salesforce_agentforce connector implemented in the platform connector surface.

Required access

Configure Salesforce authorization and Venturi manifest capabilities separately:

Authorization or capability Purpose
Connected-app OAuth scope api Authenticate to Salesforce APIs. This scope is not read-only by itself.
Optional refresh-token scope Maintain unattended access when permitted by connected-app policy.
Venturi capability agentforce_usage Enable Agentforce usage collection. This is not a Salesforce OAuth scope.
Venturi capability flex_credit_usage Enable Flex Credit collection. This is not a Salesforce OAuth scope.

Enforce read-only behavior with a dedicated integration user and a permission set limited to the required objects, fields, reports, and API reads. Do not grant Create, Edit, Delete, Modify All Data, or Customize Application. OAuth scope api permits API authentication; the user’s permission set supplies the least-privilege boundary. See Salesforce’s Models API authorization guidance for the connected-app flow.

Setup

  1. Create a connected app or integration user for Venturi.
  2. Apply the dedicated read-only permission set and connected-app policy above.
  3. Store the credential reference in Venturi.
  4. Configure VENTURI_AGENTFORCE_INSTANCE_URL; set VENTURI_AGENTFORCE_LOOKBACK_DAYS when you need a window other than the 30-day default. Set VENTURI_AGENTFORCE_FLEX_CREDIT_USD only when the customer’s Salesforce commercial schedule defines a stable per-credit value; otherwise the connector preserves credit quantity and leaves USD value null.
  5. In Venturi, open Integrations and select Salesforce Agentforce and run Test connection.

Verification

  • Agentforce action rows appear in the latest sync.
  • Flex Credit balance or consumption context appears where Salesforce exposes it.
  • Salesforce billing or contract records remain authoritative for Flex Credit value; Venturi does not invent a USD conversion.
  • The connector inventory marks Salesforce Agentforce as read-only.

Rotation and offboarding

Rotate the connected-app credential through Salesforce administration. Removing the connector stops new Agentforce usage syncs.