Metadata API Developer Guide
jNewer Version Available
MlDomain (Beta)
File Suffix and Directory Location
NLU features are preview and aren’t part of the “Services” under your master subscription agreement with Salesforce. Use this feature at your sole discretion, and make your purchase decisions only on the basis of generally available products and features. Salesforce doesn’t guarantee general availability of this feature within any particular time frame or at all, and we can discontinue it at any time. This feature is for evaluation purposes only, not for production use. It’s offered as is and isn’t supported, and Salesforce has no liability for any harm or damage arising out of or in connection with it. All restrictions, Salesforce reservation of rights, obligations concerning the Services, and terms for related Non-Salesforce Applications and Content apply equally to your use of this feature.
MlDomain components have the suffix .mlDomain and are stored in the mlDomains folder.
Version
MlDomain components are available in API version 43.0 and later.
Special Access Rules
This object is available only if Chat and Einstein Bots are enabled in your org.
Fields
| Field Name | Field Type | Description |
|---|---|---|
| description | string | Einstein Intent Set description. |
| label | string | Einstein Intent Set name. |
| mlIntents | MlIntent[] | List of intents under this Einstein Intent Set. |
| mlSlotClasses | MlSlotClass[] | List of entities under this Einstein Intent Set. |
MlIntent
An intent in an Einstein Intent Set.
| Field Name | Field Type | Description |
|---|---|---|
| description | string | Einstein Intent Set description. |
| developerName | string | Required. This unique name prevents conflicts with other Einstein Intent Sets associated with the same bot version. This name can contain only underscores and alphanumeric characters and must be unique in your org. It must begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores. |
| label | string | Einstein Intent Set name. |
| mlIntentUtterances | MlIntentUtterance[] | List of customer inputs for this intent. |
| relatedMlIntents | MlRelatedIntent[] | List of intents within an Einstein Intent Set used to expand customer inputs for this intent. Only intents within local Einstein Intent Sets have related intents. |
MlIntentUtterance
A customer input for this intent.
| Field Name | Field Type | Description |
|---|---|---|
| utterance | string | A customer input or natural language query that triggers the parent intent. |
MlRelatedIntent
An intent in an Einstein Intent Set used to expand customer inputs for this intent. Only intents within local Einstein Intent Sets have related intents.
| Field Name | Field Type | Description |
|---|---|---|
| relatedMlIntent | string | Name of the intent that is used to extend the customer inputs of the current parent intent. |
MlSlotClass
An entity in this Einstein Intent Set.
| Field Name | Field Type | Description |
|---|---|---|
| description | string | A description of an Einstein Bot entity. |
| developerName | string | Required. This unique name prevents conflicts with other entities in an Einstein Intent Set. This name can contain only underscores and alphanumeric characters, and must be unique in your org. It must begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores. |
| extractionRegex | string | Regular expression used to extract an entity when the type is set to Pattern. |
| extractionType | MlSlotClassExtractionType (enumeration of type string) | Required. Valid values are:
|
| label | string | Label that identifies an entity throughout the Salesforce user interface. |
| mlSlotClassValues | MlSlotClassValue[] | List of entity values associated with an entity of type Value. |
MlSlotClassValue
An entity value associated with an entity of type Value.
| Field Name | Field Type | Description |
|---|---|---|
| synonymGroup | SynonymGroup | Represents a list of terms or synonyms for the current entity value. |
| value | string | Single value used to extract an entity of type Value. |
SynonymGroup
Represents a group of synonymous words or phrases.
| Field Name | Field Type | Description |
|---|---|---|
| languages | Language (enumeration of type string) | Required. Specifies the languages the value list applies to. If value list items are specific to a single language, specify only that language. If the value list items apply to multiple languages, specify multiple languages for one value list. |
| terms | string | Required. A word or phrase synonymous with other terms in the value list. |
Declarative Metadata Sample Definition
The following is an example of an MlDomain.
The following is an example package.xml that references the previous definition.
Wildcard Support in the Manifest File
This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.