Getting Started with Soul Machines Studio

Learn the basics

https://drive.google.com/file/d/11XG46rvR-2lZfaAycsda24yxhfNc_80W/view?usp=sharing

 

Start with Preset Project Templates

Preset Project Templates allow you to get started quickly with a pre-configured project built around a particular use case.

image-20240411-232418.png
  • The Preview link will launch the Digital Person in another tab, letting you interact with the role and observe the experience before choosing the template for your project.

  • The Customise button opens the project form allowing you to make edits to the template just like you would when you create a project. Once the form is edited and saved a new project is created under My projects.

You can learn more about each Preset Project Template here:

Customising a Template:

This section explains how to create a Digital Person experience. The preview in the right pane will show you the changes that have been applied, allowing you to test each configuration before deploying the project. Finally, when you are satisfied with your Digital Person, deploy it, and share the URL with the end-users.

Please note: Every time you make a change to the configuration, you must click Update Preview on the Preview window to incorporate the changes into the preview DP’s behavior.

ec8e1487-34d3-4da9-8851-108540ba4af7.png

The preview pane on the right hand side is a handy tool to test your configurations allowing you to fine tune your Digital Person. Use the text box to write your own sample script and test the voice and behaviour settings. Here’s a list of features you can test in the preview:

  • Changing avatar

  • Changing conversational content and Skills

  • Changing TTS/voice

  • Changing camera

  • Changing behaviour/personality

  • Gesture Markup

Every time you change one of those settings, click Update Preview on the Preview window to incorporate the changes into the preview DP’s behavior.

To show the text box and insert your own text that the DP can repeat:

  1. Open the text entry window

  2. Then type in a test sentence and click Repeat.

 

1. Choose a name for your project

  1. It must be a unique and meaningful name as this name will also be in your deploy links. The system does not allow you to use a name that has been already used for an existing project. 

2. Select your Digital Person avatar

Available to all our customers are the latest HumanOS2.6 Digital People. If you have built your own Custom Digital People, they will also be available to you.

If you would like to use any of the Digital Persons as a starting point and change the look, click on the 3 dots within the profile picture and select Collect Digital DNA. This gives you the unique blend used to create this Digital Person in an encoded format (a.k.a Digital DNA). Copy the DNA and save it in your preferred text editor.

 

To continue working on the Digital Person, use the Loading Digital DNA feature of the Digital DNA Blender.

Note: The Collect Digital DNA option is available only for the Digital People created from Digital DNA Blender.

3. Choose the behavior of your Digital Person

Some of the behavior options in Digital DNA studio are dependent on Human OS versions, and languages. Refer to the https://soulmachines-support.atlassian.net/wiki/spaces/~5a4d740dfed274297effe5c2/pages/1526277432 and https://soulmachines-support.atlassian.net/wiki/spaces/~5a4d740dfed274297effe5c2/pages/1526268958 for details.

Choose a behavior style

Behaviour styles are a predefined set of behaviors consisting of defined gestural and emotional behavior, that can be easily matched to the written persona you’ve created and your use case.

Behavior adjustments

Adjust behavior with sentence or word based behavior tags

Other behavioral settings

Boost expressiveness with additional iconic gestures - You can choose whether or not to automatically insert additional gestures. Turning this on will create a more expressive digital person. If you want a digital person to show less hand gestures you can turn this toggle off.

Enable Digital Person Greeting at the start - This option makes your Digital Person greet users as it starts up to provide them with a verbal cue that the interaction has commenced. This setting is enabled by default.

End Session Timeout - This option makes your Digital Person automatically end the conversation session with the user, after a specified period of inactivity from the user side, e.g. after 5 minutes. This setting is enabled by default.

React to negative facial expressions - You can choose whether or not to allow your digital person to respond to users' negative facial expressions.

React to negative speech - You can choose whether or not to allow your digital person to respond to users' negative speech.

Please refer to this page for more details on Behavior Adjustments and other behavioral settings.

4. Connect conversation content

By default Soul Machines Digital People are connected to GPT from OpenAI, but you can replace their conversational content to connect with your chosen provider by choosing “Replace conversation” from the UI.

 

We offer several options of prebuilt integrations as shown here:

If you already have conversational content in one of these providers, you can connect it here.

 

We also offer more advanced connections via our Skills API and our Orchestration Server pathway.

5. Add additional Skills

Skills are modular components that can be added to the Digital Person to enhance their conversation capabilities. See Adding Skills in your Digital Person for detailed information on adding and managing Skills.

Notes:

  • Skills can only be used with HumanOS 2.2+ Digital People and the Supported platforms.

  • Skills do not work with Generative Conversation Base

  • If your conversational content handles all NO_MATCH conditions, Skills will not be triggered.

 

 

 

6. Choose a language for the conversation

  1. Choose your Digital Person’s language.
    This is the language in which your Digital Person will speak. By default, English (US) is selected.

  2. Choose a voice and accent.
    We support TTS from Google, Microsoft, and Amazon.

  3. To test the voice

    1. click Update preview on the Preview window

    2. open the text entry window

    3. Then type in a test sentence and click Repeat.

  1. Choose Audience language.
    This is the language your target audience speaks, which the Digital Person understands.

  2. Add Speech Hints.
    If using Google Speech Services, this feature enables you to build a list of uncommon words or phrases that you want your Digital Person to understand. Type in commonly misinterpreted words or phrases that you want your Digital Person to be trained to recognize and understand.

 

7. Customize default UI

We offer a self-contained microsite which you can share the Digital Person experience with your end-users or colleagues. You can customise the primary and secondary colors as well as add a logo.

 

 

 

 

8. Customise camera behavior

Content and cinematic cuts can enhance the experience of interacting with a Digital Person by introducing a range of server-controlled camera cuts that respond to relevant objects appearing on screen. Choose one of the below camera behavior to configure the Digital Person’s interaction when content cards are displayed on the UI. For more information on content cards, see Displaying Content in the Digital DNA Studio Default UI.

Click the See preview link to view a short preview of the interaction.

 

 

9. Configure an orchestration server (optional)

Use an Orchestration Server if you're using unsupported NLP services, building a custom backend, implementing rich authentication, or requiring flexible data analytics. Orchestration servers are useful when you are using unsupported NLP services, designing a custom backend, implementing rich authentication, or need flexible data analytics. 

 

10. Deploy your project

  1. Click Save to save your work.
    You can return it at any time and pick it up from where you left off. 

  2. Click Deploy to apply and view the new changes to your project.
    You are presented with a URL to visit where your demo has been deployed.