AIScoringModelDefinition Metadata Type in SFDX

Architectural Overview#

Predictive scoring across Industry Clouds and core CRM relies on reusable model blueprints that specify which historical fields and related records contribute to a propensity or risk score. The AIScoringModelDefinition metadata type captures this model configuration in a portable XML structure.

By storing AIScoringModelDefinition in source control alongside AIUsecaseDefinition, architects can version-control feature selection changes, promote scoring models across sandboxes, and maintain strict governance over which fields feed predictive AI algorithms.

SFDX Directory & File Suffix#

Key Metadata Fields#

Declarative XML & package.xml Examples#

Sample .aiScoringModelDefinition-meta.xml#

<?xml version="1.0" encoding="UTF-8"?>
<AIScoringModelDefinition xmlns="http://soap.sforce.com/2006/04/metadata">
    <description>Predictive scoring model evaluating 90-day B2B contract renewal likelihood based on usage telemetry and support cases.</description>
    <isActive>true</isActive>
    <masterLabel>B2B Renewal Propensity Model</masterLabel>
</AIScoringModelDefinition>

Sample package.xml Manifest#

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
        <members>B2B_Renewal_Propensity_Model</members>
        <name>AIScoringModelDefinition</name>
    </types>
    <version>68.0</version>
</Package>

SFDX CLI Retrieval & Deployment#

Retrieve and deploy AIScoringModelDefinition components via the Salesforce CLI:

# Retrieve all AIScoringModelDefinition files from the org
sf project retrieve start --metadata "AIScoringModelDefinition:*"

# Deploy a specific AIScoringModelDefinition
sf project deploy start --metadata "AIScoringModelDefinition:B2B_Renewal_Propensity_Model"

Senior Architect Best Practices & Gotchas#

• Prevent Target Leakage (Hindsight Bias): Never include CustomField inputs that are only populated after the outcome occurs (such as Cancellation_Reason__c or Final_Settlement_Date__c). Target leakage produces artificially high sandbox metrics that fail in production.
• Coordinate with AIUsecaseDefinition: Deploy AIScoringModelDefinition and its companion AIUsecaseDefinition in the same package.xml manifest so cross-references validate cleanly.

Frequently asked questions

What is AIScoringModelDefinition used for in Salesforce?

It defines the declarative structure, input features, and scoring output configuration for predictive AI scoring models across Salesforce clouds.

Where are AIScoringModelDefinition files stored in SFDX?

They are stored in the force-app/main/default/aiScoringModelDefinitions directory with the .aiScoringModelDefinition-meta.xml file suffix.

How does AIScoringModelDefinition interact with AIUsecaseDefinition?

AIUsecaseDefinition defines the business problem and target entity, while AIScoringModelDefinition specifies the underlying scoring model configuration linked to that use case.

How do I retrieve AIScoringModelDefinition using the Salesforce CLI?

Run sf project retrieve start --metadata AIScoringModelDefinition to fetch all scoring model definitions into your local SFDX project.