ServiceAISetupDefinition

Represents settings for an Einstein for Service feature such as Einstein Article Recommendations.

Parent Type 

This type extends Metadata and inherits its fields.

File Suffix and Directory Location 

ServiceAISetupDefinition components have the suffix .serviceAISetupDescription and are stored in the serviceAISetupDescriptions folder.

Version 

Introduced in API version 51.0.

Special Access Rules 

This type is available only when an org is configured to access the application in the appSourceType field. For example, if appSourceType is set to ARTICLE_RECOMMENDATION, this type is available only if Einstein Article Recommendations is enabled in the org and the Main Services Agreement has been accepted.

Fields 

appSourceType 

  • Type: ApplicationSourceType (enumeration of type string)
  • Required: Yes
  • Description: Required. The target application for the configuration.
  • Possible values:
    • REPLY_RECOMMENDATION — Einstein Reply Recommendations
    • ARTICLE_RECOMMENDATION — Einstein Article Recommendations
    • UTTERANCE_RECOMMENDATION — Einstein Bot utterances
    • FAQ — Einstein Bot frequently asked questions

name 

  • Type: string
  • Required: Yes
  • Description: Required. A reference to the configuration.

setupStatus 

  • Type: ServiceAISetupDefStatus (enumeration of type string)
  • Required: Yes
  • Description: Required. The status of the configuration.
  • Possible values:
    • FIELDS_SELECTED
    • TRAINING
    • READY_TO_ACTIVATE
    • SERVING
    • RETIRED
    • ARCHIVED
    • READY_FOR_REVIEW

supportedLanguages 

  • Type: string
  • Required: No
  • Description: Required when appSourceType is ARTICLE_RECOMMENDATION. Language codes for selected and supported languages.

Declarative Metadata Sample Definition 

Here’s an example of a ServiceAISetupDefinition component.

1<?xml version="1.0" encoding="UTF-8"?>
2<ServiceAISetupDefinition xmlns="http://soap.sforce.com/2006/04/metadata">
3    <appSourceType>ARTICLE_RECOMMENDATION</appSourceType>
4    <name>SA1601228426202</name>
5    <setupStatus>ARCHIVED</setupStatus>
6    <supportedLanguages>en,de,fr,it,es,pt,nl</supportedLanguages>
7</ServiceAISetupDefinition>

The following is an example package.xml that references the previous definition.

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3    <types>
4        <members>*</members>
5        <name>ServiceAISetupDefinition</name>
6    </types>
7</Package>

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.