Configuring Handlers
Handlers contain V‑Blaze transcription parameters to interact with the ASR engine to transcribe audio. Additionally, handlers include a list of actions that perform various tasks based on the transcription results. Multiple handler configurations are useful to connect to different V‑Blaze servers or if multiple transcription configurations are required.
Configuring Handler Transcription Settings
Each handler configuration has a separate section that specifies a set of parameters to interact with V-Blaze. The default [Adapter]
section within /config/default.cfg
contains two handlers to separate transcription requests:
[LiveCall]
— Activates at the start of a call. The[LiveCall]
handler contains transcription settings optimized for speed.[PostCall]
— Activates when a call has completed. The[PostCall]
handler contains transcription settings optimized for quality.
The following is a sample [LiveCall]
handler:
[LiveCall] server = localhost actions = LiveLog activitylevel = 50 uttminactivity = 100 uttmaxsilence = 800 uttpadding = 100 reconnectdelay = 1 reconnectattempts = 0 reconnectmaxdelay = 600
The following is a sample [PostCall]
handler:
[PostCall] server = localhost actions = PostLog gender = true emotion = true scrubdir = /var/lib/vociadapter/json utthandler = true mincalldur = 10 maxcalldur = 7200 maxcalls = 100000
/config/custom.cfg
Parameter | Values | Description |
---|---|---|
server | localhost (default), URL: HTTP or HTTPS | Specify the hostname or address of the ASR engine for the handler to use. |
actions | No default | Define the list of actions for the handler to use. |
scrubtext | No default | V-Blaze API parameter — Enables the ASR engine to redact sensitive information from transcripts. |
scrubdir | No default | Specify a directory to save redacted transcripts. |
utthandler | true (default), false | If |
mincalldur | 10 (default) | Specifies the minimum call length (seconds) for the handler to accept. |
maxcalldur | 7200 (default | Specifies the maximum call length (seconds) for the handler to accept. |
maxcalls | 100000 | Specifies the maximum number of simultaneous calls the handler allows. |
filters | No default | Specifies which filter configurations to call. |
gender | No default | V-Blaze API parameter — Set |
emotion | No default | V-Blaze API parameter — Set |
reconnectdelay | 1 (default) | Initial delay (seconds) for reconnect attempts. |
reconnectattempts | 0 (default) | Maximum number of reconnect attempts before shutting down the service. For unlimited attempts, set |
reconnectmaxdelay | 600 (default) | Upperbound in seconds for the exponential backoff for reconnect attempts. |
Note
Refer to V-Blaze Transcription Parameters for more information on the V-Blaze API parameters in the table above.
Configuring Handlers for Multiple Servers
Connect to multiple servers by setting the value of server
to a comma-separated list of separate servers. You can also limit the number of simultaneous streams by adding @n
, where n
is the number of streams. The following configuration is an example of multiple servers with limited streams:
server = hostname_1 @10, hostname_2 @15, hostname_3
Note
The adapter assigns each transcription request to the server with the smallest load.
If @n
isn't specified, the value is set to the match the value of maxstreams
returned by a V‑Blaze API /status
query.