8 Deploy the Sample UA Application

Before starting the UA-APP deployment, make sure to create a configuration file named mfe-app.properties.

You can find a sample mfe-app.properties file in the UA-APP sample project.

1. Locate the file IMCSampleApp-8.3.0.0.0.zip in your download of the Converged Application Server Release 8.3.
2. Unzip IMCSampleApp-8.3.0.0.0.zip.
3. Locate the mfe-app.properties file.
4. Copy the properties file to the Oracle Home folder.
5. In the properties file, set egress.destinationIp to the IP address of the Intelligent AI connector service. Set egress.destinationPort to the port of the Intelligent AI connector service.

   egress.destinationIp=<IP of IAC Service>
   egress.destinationPort=<Port of IAC Service>
                     
   egress.codec.name=PCM-16
   egress.codec.samplingRate=8000
   egress.codec.channelCount=1
   egress.codec.targetBitrate=64000
   egress.codec.format=S16LE
   egress.headerSize=146
   egress.streamDirection=incoming
   
   egress.metaData={"Create":<JSON of Tuning metadata parameters>,"Update":<JSON of Tuning metadata parameters>}

The egress.metaData property is used to control how the AI service (OCI in this case) behaves and responds, by tuning certain model parameters. For example:

{
  "Create": {
    "languageCode": "en-US",
    "partialSilenceThresholdInMs": 0,
    "finalSilenceThresholdInMs": 2000,
    "encoding": "audio/raw;rate=8000"
  },
  "Update": {
    "languageCode": "en-US",
    "partialSilenceThresholdInMs": 10
  }
}

It has two sections:

The metadata configuration consists of two sections: Create and Update.

The Create section is used when a new session is initialized and defines the initial behavior of the AI model. It can be used to set the default language (languageCode) and control how the system detects pauses, including parameters such as partialSilenceThresholdInMs, which determines how quickly partial input is processed, and finalSilenceThresholdInMs, which specifies how long the system waits before marking input as complete.

The Update section is used during an active session and allows dynamic adjustments without restarting the session. For example, it can be used to make the system more responsive by lowering silence thresholds or to change the language mid-session if needed.

When to Use What

• Use Create when starting a session and setting baseline behavior
• Use Update when you need to tweak responsiveness or behavior in real time once

Optional Usage

• The entire metaData block is optional
• If not provided, OCI will use its default parameters

Recommended approach:

• Start with defaults
• Add/tune parameters only if you need specific behavior on re-invites (for example, faster response, different silence handling)

Please refer to the metadata section to see the entire list of supported metadata parameters.

You need to tell your managed server where to find mfe-app.properties:

• Add -Dmfe.config.file=<absolute path to mfe-app.properties> to the server start command or in the JAVA_OPTIONS
• If you want to save and see the transcriptions in a particular folder use the below 2 flags:

  -Daic.transcription.save=true
  -Daic.transcription.dir=<absolute path to where you want to save the transcriptions>

  If dir is not given and save is true, transcriptions are saved in ${ORACLE_HOME} by default.

• Update the JAVA_OPTIONS variable in the startWebLogic.sh file and then restart your Admin and Managed servers.