Large model application management

更新时间:
复制 MD 格式

This document explains how to create and configure a large model application for outbound and inbound calls. This includes associating a large model gateway and configuring settings such as scripts, opening prompts, calling voices, Inbound Call Configuration, and conversation attributes.

Step 1: Create a large model application

In the Intelligent Contact Center > Large Model Communication > Communication Intelligence Engine > Large Model Application Management. Click Create Large Model Application. In the dialog box, configure the basic information and click Submit to create the application.

Parameters

Parameter

Description

Example

Application name

Enter a custom name.

Test Application

Model name

Select a deployed large model gateway.

-

Base model version

Select a base model version.

-

Maximum concurrency

The default value is 100. To adjust this value, contact your account manager.

-

Qualification

Select an approved qualification. You can view your qualifications on the Qualification Management page in Voice Messaging Service.

-

Script

Select an approved script. You can manage scripts under Script Management in Voice Messaging Service.

-

Opening prompt

  • Text: Customize the opening prompt content. You can use variables in the format ${param}.

  • Recording: WAV, MP3, and M4A formats are supported. The file size cannot exceed 2 MB, and the duration cannot exceed 60 seconds.

    Note

    For a more natural-sounding voice, if you use a recording for the opening prompt, select a calling voice cloned from the same source.

Text: Hello, are you ${param}?

Prompt

Customize the prompt content. You can use variables in the format ${param}.

Note

A prompt is an instruction you provide to the large model.

You are Xiaomei, a professional Alibaba Cloud customer service agent who handles pre-sales inquiries. You must strictly follow these rules: 1. If a customer asks about ${problem}, guide them to view the details in ${document}. 2. If a customer asks about ${other}, guide them to view the details in ${answer}.

Calling voice

In the dialog box, select a voice style for calls. You can audition different voices online.

-

Calling voice configuration

You can select the voice type and style, customize the speech rate and volume, and audition the voice online.

In the Calling Voice dialog box, for Voice Type, you can select options such as the pre-set system voices from Alibaba Cloud Cosyvoice. You can filter voices by Voice Name, Suggested Use, and Gender. The table displays information such as voice characteristics, sub-scenarios, and language. For each voice, you can click Audition. You can set the speech rate from -200 to 200 and the volume from 0 to 100. You can also configure whether to Enable Audio Mixing and Enable Background Music. In the Content Audition area, enter the text to audition (up to 100 characters), select whether to Audition with Synthesized Opening, and click Audition Audio to listen. After you are satisfied, click OK.

Step 2: Configure inbound calls (optional)

After creating the large model application, you can configure its inbound call settings.

  1. On the Large Model Application Management > Inbound Call Configuration to open the configuration page.

  2. Choose to use an Alibaba Cloud number or a customer-provided line number. Click Add Number.

    • Alibaba Cloud number: A number you have applied for in Voice Messaging Service.

      Important

      Number types include Inbound, Outbound, and Inbound + Outbound. You must select a number that supports inbound calls, such as an Inbound or Inbound + Outbound number. If you do not have a number that supports inbound calls, go to the Voice Messaging Service console > Real Number Application page to apply for one. For details, see Real Number Application.

      In the Add Alibaba Cloud Number dialog box, select the checkboxes of the numbers you want to add, and then click OK.

    • Customer-provided line number: Use a number from your own line.

      Note

      The customer-provided line feature is currently available by invitation only. Before using it, contact your account manager to add your account to the allowlist. For more details, see Customer-Provided Lines.

      In the Add Customer-provided Line Number dialog box, select a Line Name, enter the inbound numbers in the Line Number input box. You can enter up to 10 numbers. Only digits are supported. Separate multiple numbers with line breaks. Then, click Add.

  3. Callback configuration: When a user calls in, you can retrieve opening prompt variables based on the calling and called numbers.

    Turn on the Callback configuration, configure the parameters, and then click Enable.

    1. HTTP request URL: Required. Must start with http or https and be no more than 200 characters long.

    2. Response Variable Configuration: The application automatically reads variables from its text-based opening prompt. You can click Re-identify to fetch the latest variables.

      Note

      This feature can also be used without any variables, primarily to pass information such as the incoming line number.

      In the application creation form, the Opening prompt type supports both Text and Recording options. If you select Text, a tip below the input box indicates that the opening prompt supports variables in the format ${param}, for example: Hello, are you ${param}?. The Prompt input box also supports this variable format. At the bottom of the form, you can click the Select Calling Voice button to configure the voice.

    3. Example: Fill in the fields as shown in the example, click the Test button, and enter the calling number and called number in the dialog box.

    4. Timeout Setting: Required. Configure the timeout period for reading variables. If a timeout occurs, the default variable values are used.

Step 3: Configure transfer to human agent (optional)

Note

Before you can configure transfers to a human agent, you must submit an integration request for an agent trunk and have it approved. For details, see Agent Trunks.

After creating the large model application, you can configure settings to transfer calls to a human agent.

  1. On the Large Model Application Management > Transfer to Human Agent Configuration to open the configuration dialog box.

  1. Enable the Transfer to human agent feature.

Parameters

Parameter

Description

Agent trunk name

Select the name of an approved agent trunk.

Transferred-to number

The number that will receive the transferred call request. You need to confirm this number with the agent platform.

Transfer type

When the Communication Intelligence Engine receives a transfer-to-human-agent tag from the large model, it transfers the call to a skill group or agent.

Transfer type ID

The ID of the human agent type to transfer to, such as a queue ID or agent ID.

Transfer to human agent prompt

This prompt is played after the transfer instruction is received. The call is transferred to the agent platform after the prompt finishes. To avoid conflicts, do not configure this prompt if the agent platform has its own audio prompt.

Transfer to human agent failure prompt

If the transfer to the agent platform fails, this prompt plays, and the call terminates afterward.

  1. Click Confirm.

Step 4: Configure conversation attributes

On the Large Model Application Management > Conversation Attribute Configuration. In the dialog box that appears, configure the conversation attributes and click OK.

Parameters

Parameter

Description

Recommended configuration

Silence duration

Specifies the wait time (in seconds) when neither party is speaking before the silence-triggered model is triggered. The range is 3 to 15 seconds.

5

Silence-triggered model

When the customer is silent, this feature proactively calls the model. The application inputs a fixed phrase to the model: User did not speak. For custom content, contact technical support for personalized configuration.

Values:

  • Yes: Enables the silence-triggered model. When neither party is speaking, the model is actively triggered to generate content, and the silence event is pushed to your large model.

  • No: Disables the silence-triggered model.

Yes

Hang up on silence configuration

Configure the number of silence events that trigger an automatic hang-up. The range is 1 to 5 times.

3

Smart answering detection

Enabled by default. Automatically detects voice assistants or mailboxes and returns a smart status code via the LlmSmartCallReport-Call Record Message.

-

Hang up immediately

When smart answering detection identifies a voice assistant or mailbox, you can choose whether to terminate the call. The default is No. You can enable immediate hang-up based on your business needs.

-

Maximum call duration

The valid range is 300 to 3,600 seconds. The call automatically hangs up when this limit is reached.

-

Morse code playback configuration

If enabled, an AI-generated Morse code declaration plays at the end of the conversation.

-

Uninterruptible opening prompt

If enabled, the large model will ignore any interruptions for a specified period during the opening. This is useful for scenarios where an identity or important notice must be fully delivered, preventing the opening prompt from being interrupted by the customer or background noise. Two options are available:

  • Uninterruptible throughout

  • Uninterruptible during a specified opening period

-

Prevent consecutive interruptions

When the number of interruptions exceeds a threshold, the large model ignores further interruptions for a configured duration and completes its speech to ensure a smooth conversation.

You can configure the system to disallow interruptions for X seconds if the number of consecutive interruptions exceeds X.

-

Acknowledgement phrases

If enabled, when a customer interrupts the large model, it may first respond with natural-sounding acknowledgement phrases like "Go ahead" or "Mm-hmm" to yield the floor to the customer. This reduces the robotic feel and improves the naturalness of the interaction.

-

Step 5: Associate a summary agent (optional)

Prerequisites: You have created a Xiaoji Agent. See Xiaoji Agent.

  1. Go to the Artificial Intelligence Cloud Call Service console. In the navigation bar, choose LLM Communication > Communication Intelligence Engine > LLM Application Management.

  2. Find your application and click Xiaoji Agent Configuration in the Actions column.

  3. Set Associate Xiaoji Agent to Yes and select the corresponding Xiaoji Agent.

    Associating a Xiaoji Agent incurs additional fees. See Billing Details for pricing. If you don’t have a suitable Xiaoji Agent, click Create Xiaoji Agent to create one.

Step 6: View large model application details

After configuring the conversation attributes, you can view the application's details. On the Large Model Application Management tab, click Details for the created application to view its details in a dialog box.

The details page consists of two parts: Basic Information (Application name, Application code, Model name, Model code, Qualification, Script, Use case, Scenario, Opening prompt, Prompt, Calling voice, Volume, Speech rate, Base model version, Maximum concurrency, Hotword library) and Conversation Attributes (Silence-triggered model, Silence duration, Hang up on silence configuration, Smart answering detection, Maximum call duration).

Interruption events

During a conversation with the large model application, an interruption event may occur. When an interruption event occurs, the application predicts the point of interruption and passes the content, truncated at the point of interruption, to the large model.

For example, if the agent is saying This is a test opening prompt and you say Who are you? after it has said This is a, an interruption event occurs. The application predicts the interruption point. The content passed to the large model is not:

[
  {
    "role": "assistant",
    "content": "This is a test opening prompt"
  },
  {
    "role": "user",
    "content": "Who are you?"
  }
]

but instead:

[
  {
    "role": "assistant",
    "content": "This is a"
  },
  {
    "role": "user",
    "content": "Who are you?"
  }
]