To create a new digital assistant:

1. Click to open the side menu, select Development > Digital Assistants, and click New Digital Assistant.

2. Complete the dialog, paying particular attention to these fields:
   • Platform Version: The platform version affects the behavior of your digital assistants, such as the way the Natural Language Understanding (NLU) engine resolves intents and which languages are supported natively.

     By default, this is set to the most recent platform version. However, if you specifically need the digital assistant to behave like other digital assistants that are based on a different platform version, you can choose an older version.

     See Platform Version.

   • Primary Language: (Appears only if the selected platform version is 20.12 or higher.) This determines both the default language for the digital assistant and whether the digital assistant will use native support for that language or rely on a translation service.

     If you plan to design the digital assistant for multiple languages, consider your choice here very carefully. In particular, if you want to support any languages other than the natively-supported languages, you should scroll down to the Translation Service section of the dropdown and select English from there.

     See Languages and Digital Assistants for detailed information on designing your digital assistant for your desired target languages.

     Note
     
     On platform versions 20.09 and lower, you don't specify a primary language. Instead a predominant language is automatically detected if you have set up the digital assistant with a translation service.

After you create the digital assistant, it appears in the Digital Assistant page in draft mode.

If you want to create a digital assistant that is similar to an existing digital assistant, or if you want to reuse the artifacts of an existing digital assistant, you can create the digital assistant by cloning.

To clone a version of a digital assistant:

1. Click to open the side menu and select Development > Digital Assistants.

2. In the tile for the digital assistant that you want to clone, click and select Clone.

3. Complete the dialog, paying particular attention to these fields:
   • Platform Version: The platform version affects the behavior of your digital assistants, such as the way the Natural Language Understanding (NLU) engine resolves intents and which languages are supported natively.

     By default, this is set to the most recent platform version. However, if you specifically need the digital assistant to behave like other digital assistants that are based on a different platform version, you can choose an older version.

     See Platform Version.

   • Primary Language: (Appears only if the selected platform version is 20.12 or higher.) This determines both the default language for the digital assistant and whether the digital assistant will use native support for that language or rely on a translation service.

     If you plan to design the digital assistant for multiple languages, consider your choice here very carefully. In particular, if you want to support any languages other than the natively-supported languages, you should scroll down to the Translation Service section of the dropdown and select English from there.

     See Languages and Digital Assistants for detailed information on designing your digital assistant for your desired target languages.

     Note
     
     On platform versions 20.09 and lower, you don't specify a primary language. Instead a predominant language is automatically detected if you have set up the digital assistant with a translation service.

You can create a digital assistant by importing a version of a digital assistant that was exported from another instance. The imported digital assistant will be in draft mode, even if it was published in the source instance.

To import a digital assistant:

1. Click to open the side menu and select Development > Digital Assistants.

2. From the Digital Assistant page, click Import Digital Assistant.

3. Upload the ZIP file that contains the exported digital assistant.

When you’ve completed building a version of a digital assistant, you can lock it down by publishing it. If you later want to make further modifications, you must create another version and work on that one.

To publish a version of a digital assistant:

1. Click to open the side menu and select Development > Digital Assistants.

2. In the tile for the digital assistant that you want to publish, click and select Publish.

At some point, you might want to create another version of a digital assistant, such as to add new features.

To create another version:

1. Click to open the side menu and select Development > Digital Assistants.

2. In the tile for the digital assistant that you want to version, click and select New Version.

3. Complete the dialog, paying particular attention to these fields:
   • Platform Version: The platform version affects the behavior of your digital assistants, such as the way the Natural Language Understanding (NLU) engine resolves intents and which languages are supported natively.

     By default, this is set to the most recent platform version. However, you can also specify a previous version, such as that used by the base version of the digital assistant.

     See Platform Version.

   • Primary Language: (Appears only if the selected platform version is 20.12 or higher.) This determines both the default language for the digital assistant and whether the digital assistant will use native support for that language or rely on a translation service.

     If you plan to design the digital assistant for multiple languages, consider your choice here very carefully. In particular, if you want to support any languages other than the natively-supported languages, you should scroll down to the Translation Service section of the dropdown and select English from there.

     See Languages and Digital Assistants for detailed information on designing your digital assistant for your desired target languages.

     Note
     
     On platform versions 20.09 and lower, you don't specify a primary language. Instead a predominant language is automatically detected if you have set up the digital assistant with a translation service.

1. Click to open the side menu and select Development > Digital Assistants.

2. In the tile for the digital assistant that you want to delete, click and select Delete.

If you have multiple Oracle Digital Assistant instances and you want to copy a digital assistant from one instance to another, you use the Export and Import commands:

1. Log in to the instance that you want to export the digital assistant from.

2. Click to open the side menu and select Development > Digital Assistants.

3. In the tile for the digital assistant that you want to export, click and select Export.

   A zip file with the digital assistant will be downloaded to your system.

4. Log in to the instance that you want to export the digital assistant to.

5. Click to open the side menu and select Development > Digital Assistants.

6. Click Import Digital Assistant.

7. Upload the ZIP file that contains the exported digital assistant.

To add a skill to a digital assistant:

1. Click to open the side menu, select Development > Digital Assistants, and double-click your digital assistant.

2. Click Add Skill.

3. In the tile for the skill you want to add, select .

   If you don't find the skill you are looking for, it might have a language mode that is not compatible with the language mode of your digital assistant. See Conditions for Adding a Skill to a Digital Assistant.

4. Click the Done button to close the Skills Catalog and display the page for the skill in the digital assistant.

5. Scroll down to the Interaction Model section of the page and make sure that the Invocation value is the name that you want users to use to invoke the skill.

   This name should adhere to these Invocation Name Guidelines.

6. Provide some example utterances that would be typical of how a user would invoke the skill.

   These utterances will be used as selectable options in the digital assistant's default welcome and help states.

7. If needed, add or change the name of the Group. A skill group is a collection of related skills. By grouping related skills, you can improve routing behavior in your digital assistant. See Skill Groups.

Digital assistants have the following limits for intents and training utterances:

• Maximum intents. Digital assistants can handle routing for up to a total of 10,000 intents split across all of its skills.
• Maximum training utterances. Digital assistants can handle up to 25,000 training utterances split across all of its skills.