AIApplicationConfig Metadata Type in SFDX

Architectural Overview#

While AIApplication defines the high-level identity and type of an Einstein AI solution, AIApplicationConfig governs how that application behaves at runtime—controlling scoring thresholds, top factor display limits, and feature-specific toggles.

Separating AIApplicationConfig from the base AIApplication allows architects to tune operational parameters (such as confidence thresholds or explanation display settings) in production or staging without redeploying the underlying machine learning data definitions.

SFDX Directory & File Suffix#

Key Metadata Fields#

Declarative XML & package.xml Examples#

Sample .aiApplicationConfig-meta.xml#

<?xml version="1.0" encoding="UTF-8"?>
<AIApplicationConfig xmlns="http://soap.sforce.com/2006/04/metadata">
    <aiApplicationDeveloperName>Customer_Churn_Prediction_App</aiApplicationDeveloperName>
    <developerName>Customer_Churn_App_Runtime_Config</developerName>
    <masterLabel>Customer Churn App Runtime Config</masterLabel>
</AIApplicationConfig>

Sample package.xml Manifest#

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

SOQL Query & SFDX CLI Commands#

Inspect AIApplicationConfig Records via SOQL#

SELECT Id, DeveloperName, MasterLabel, AIApplicationId, CreatedDate
FROM AIApplicationConfig
ORDER BY CreatedDate DESC

Retrieve and Deploy via Salesforce CLI#

# Retrieve all AIApplicationConfig records
sf project retrieve start --metadata "AIApplicationConfig:*"

# Deploy a specific AIApplicationConfig
sf project deploy start --metadata "AIApplicationConfig:Customer_Churn_App_Runtime_Config"

Senior Architect Best Practices & Gotchas#

• Cross-Environment Portability: Never hardcode 15- or 18-character Salesforce record IDs inside configuration XML; always reference the parent application by its portable aiApplicationDeveloperName.
• UI Component Visibility: When configuring Einstein prediction explanations or top factors via AIApplicationConfig, ensure end users have a PermissionSet granting read access to the target prediction fields on the CustomObject.

Frequently asked questions

What is the purpose of AIApplicationConfig in Salesforce?

AIApplicationConfig stores the operational and runtime configuration parameters for a parent AIApplication, such as scoring behavior, thresholds, and feature flags.

Where are AIApplicationConfig files located in SFDX?

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

Can I deploy AIApplicationConfig without its parent AIApplication?

No, the referenced AIApplication must already exist in the target org or be included in the same deployment transaction.

How do I retrieve AIApplicationConfig components using Salesforce CLI?

Run sf project retrieve start --metadata AIApplicationConfig to pull all AI application configuration files into your local project.