Role Management

Overview

Role management supports products such as AI dolls and smart storytelling robots. These products require AI agents to achieve different personalities and chat styles. Each role includes the role name, description, and personality settings. The platform supports user-defined roles and also provides official reference roles.

Role management covers all roles used under the current account. You can choose roles from the role library per business requirements, and bind them with the AI agents.

Create role

Go to the Role Management page and click Create Role.

Configure the following fields when creating a role:

• Role Name: The name of the specified role.

• Role Personality: Define role traits, backstory, knowledge base, interests, and specialized skills. This field serves as the role’s prompt. For example, an expert in joke-telling or storytelling.

• Timbre: Support tailored voice timbre.

  Timbre settings must match the target region and language. For example, AI dolls for the US market must use a region-supported timbre. You can filter timbre resources by region and language.

• Language: Specifies the supported languages for chats, covering both text-to-speech (TTS) and automatic speech recognition (ASR). When English is selected, both input and output languages default to English.

• Label: It is used to categorize roles, enabling grouped management in panels and service displays.

• Avatar: Each role requires an uploaded avatar, which will be displayed across panels and service channels. Consistent avatar styling is recommended to maintain visual coherence.

  

Apply roles to agents

Each agent can be associated with one or multiple roles to deliver contextual dialogue experiences in diversified product scenarios.

Path: Create Role > Variables > Role Variables > Preset Role Management.

Perform the following steps:

1. On the page of My Agent, click Create Agent or Develop in the Operation column.

   

2. On the page of 01 Model Configuration that appears, find Variables and click + to open the Edit Variables page.

   

3. Enable Preset Role Management. Role variables are designed for AI toys, smart speakers, and other scenarios requiring predefined role settings. This feature must be used with product control panels, allowing users to customize roles, timbres, and personalities.

   

4. Click Preset Role Management. On the page that appears, click Add Preset Role to choose an official role or custom role.

   

5. After you enable variables, complete agent development, and bind the agent with devices, the AI toy’s control panel will show preset role profiles. Users can switch between roles.

Work with AI toy panel

Taking the AI ​​toy solution as an example, here is how to use it with the panel. For more information, see AI Capabilities Development.

1. Link a product with your agent.

   

2. Configure role variables and preset roles.

   

   

3. Select the official panel and develop panel interactions.

   

4. View the panel. On the panel, users can switch among multiple roles that have been configured for the agent.