Skip to content

Set up Cabby

After these steps, Cabby is active, and the users you choose can build audiences with it.

Before you begin

Permission
Campaign Audience Builder: Admin permission set group.

Complete the steps in order. Users can use Cabby only once the org is registered, the connection test succeeded, Cabby is activated and they have the permission set. What each setting does is listed in Cabby settings.

  1. Open CAB Settings → Configure → AI & Integrations → AI Agent Setup.

  2. Accept Terms and Choose AI Data Processing Mode. Select Review Terms, choose the processing mode, select I have read and accept the terms, and confirm. Afterward, the action reads View or Change Terms.

  3. Assign Agent Permission Set. Select Select Users and assign Campaign Audience Builder Agent User. This step appears only when the current admin can assign permission sets; otherwise assign it from Salesforce Setup.

  4. Create Credentials. Select Create Credentials to create the Named Credential infrastructure.

  5. Enable Named Credential. Open the generated Salesforce Setup page and select Enable for Callouts.

  6. Register with CAB Agent. Select Register to create organization-specific Agent credentials. Regenerate Credentials replaces them when rotation is required.

  7. Test Connection. Select Test Connection and resolve any Named Credential, permission, or registration problem before continuing.

  8. Enable Metadata Statistics. Select Start. This starts an initial collection and schedules the nightly job. Use Unschedule to stop future collections.

  9. Activate Agent. Select Activate. The setup card then offers Deactivate instead.

Give setup administrators the Campaign Audience Builder Admin permission set. Do not assign that administrative access to ordinary Cabby users.

Give end users Campaign Audience Builder Agent User. It includes Use Segmentation Agent and the access needed by Cabby surfaces. The assignment flow also creates CAB_ExternalServices_Credential for external credential access; teams that deploy metadata through source control should retrieve and commit that generated permission set.

Salesforce Setup → Object Manager → Campaign → Field Sets → Agent Campaign Context

Add only custom Campaign fields that are safe to send to the Agent. The field set’s guidance is explicit: fields must be free of PII, PHI, and confidential data. CAB ignores unsupported field types, including identifiers, references, encrypted strings, Base64 values, addresses, and locations.

Which Campaign fields Cabby always receives is listed in Cabby settings.

Select Deactivate in the final setup step to revoke the organization’s Agent credentials. Reactivation requires a new registration.

The confirmation offers Also erase all data from Google Cloud Platform:

What deactivating keeps and what erasing deletes is listed in Cabby settings.

Message or symptomWhat to do
You don’t have permission to manage CAB Agent administrative settings. Ask your Salesforce administrator to assign the ‘Campaign Audience Builder Admin’ permission.Assign Campaign Audience Builder Admin to the setup administrator.
You don’t have permission to use the CAB Segmentation Agent. Ask your admin to assign the ‘Campaign Audience Builder Agent User’ permission set.Assign Campaign Audience Builder Agent User to the user.
Cabby has been updated. Please upgrade the Campaign Audience Builder package to the latest version to continue.Upgrade the Campaign Audience Builder package to the latest version.
This conversation’s data has expired. Start a new message to continue.Start a new message.
The agent couldn’t process that request. Please rephrase and try again.Rephrase the request and try again.
The agent couldn’t complete the task within the allowed number of steps. Try a more specific prompt.Use a narrower, more specific prompt.
The agent stopped responding and the turn was ended. Please try again.Retry the turn.
Your organization has reached its daily agent budget. Please try again tomorrow.Wait for the next daily budget period. This organization budget is separate from monthly conversation allowances; there is no documented numeric allowance in this message.
You have used all agent conversations for this month. Conversations reset at the beginning of each month.Existing conversations remain usable; users can’t start another one this month.

If Test Connection fails without one of these messages, confirm that Enable for Callouts was completed, the organization is registered, and the current credentials have not been regenerated or revoked since the Named Credential was configured.

Activate Agent offers Deactivate, and a user with Campaign Audience Builder Agent User can open Cabby in Campaign Audience Builder.