Configuring Voci Adapter

Important:

All directory paths in this chapter are relative to the default installation directory in /opt/voci/adapter/.

The vociadapter service requires a connection to the V‑Blaze ASR engine ( vociserver ); however, the ASR engine does not have to run on the same machine as the adapter.

Voci Adapter is a service that works with the OrecX Audio call capture system by establishing a connection to an active orkaudio process to receive audio and metadata from calls on a network. The following diagram shows the Voci Adapter process and configurations:

Voci Adapter runs as a service with the following commands:


systemctl status | start | stop | restart vociadapter

Note: The vociadapter service requires the orkaudio service to run simultaneously.

Voci Adapter settings are defined in the /config/custom.cfg configuration file. If the file doesn't exist, /config/default.cfg is used instead. To customize the Voci Adapter, copy /config/default.cfg to /config/custom.cfg and adjust the newly created configuration file.

The custom.cfg file consists of an [Adapter] section, a [Recorder] section, and a number of custom sections named after the handlers and actions. The [Adapter] section is a top-level section used to configure the following:

Logging — Configure to rotate between a number of log files, named out.log.i where i is the file's index number. Rotation of the log file is triggered by exceeding a configured log file size. The most recent log file has the index dropped from the filename and is named out.log.
Handlers — The [Adapter] section defines which handlers are active. The purpose of handlers is to group actions to share a single audio transcription. All fields in the [Adapter] section are mandatory except for customroot.

[Adapter]
loglevel=error
logdir=/var/log/vociadapter
logfilesize=20000000
numlogfiles=5
handlers= LiveCall, PostCall
customroot=/opt/voci/adapter

Table 1. The `[Adapter]` section of /config/custom.cfg
Parameter	Values	Description
loglevel	`debug` (default), `info` , `error`	Controls the amount of detail in log entries.
logdir	/path/to/log/dir	The absolute or relative path to the logging directory. If `logdir` isn't specified, log entries will default to stdout or stderr (for errors).
logfilesize	`22000000` (default)	The maximum size (bytes) for each log file.
numlogfiles	`5` (default)	The maximum number of log files to keep.
handlers	No default	A comma-separated list defining the handlers to use. Each handler must include its own configuration section.
customroot	/opt/voci/adapter/ (default)	Directory where the Voci Adapter looks for config, actions, formatters, and filters directories.