Configuring EVI
Guide to configuring the Empathic Voice Interface (EVI).
The Empathic Voice Interface (EVI) is designed to be highly configurable, allowing developers to customize the interface to align with their specific requirements. Configuration of EVI can be managed through two primary methods: an EVI configuration and session settings.
Configuration options
EVI configuration options affect the behavior and capabilities of the interface, and include the following configuration options:
Configs, as well as system prompts and tools, are versioned. This versioning system supports iterative development, allowing you to progressively refine configurations and revert to previous versions if needed.
Default configuration options
EVI is pre-configured with a set of default values, which are automatically applied if you do not specify a configuration. The default configuration includes a preset voice and language model, but does not include a system prompt or tools. To customize these options, you will need to create and specify your own EVI configuration.
The default configuration settings are as follows:
Default configuration settings are subject to change. To ensure your setup remains consistent should changes occur, we recommend choosing explicit options when defining your EVI configuration.
Create a configuration
See instructions below for creating an EVI configuration through the Portal. In the Portal, navigate to the EVI Configurations page. Click the Create configuration button to begin.

Choose EVI version
To learn more about the differences between EVI versions 1 and 2, please see the feature comparison guide.

Choose voice
Select a voice from Hume’s 8 presets, or create your own custom voice. To learn more about voice customization options on the Hume Platform, please visit the Voices page.

Add tools
Equip EVI with built-in tools, like web search, or custom user-defined tools. Click the + Add button to select an existing tool or create a new one.

Test the configuration
The newly created configuration can now be tested. From the EVI Config details page, click Run in playground to test it out.

Once in the EVI Playground, click Start call to connect to EVI with your configuration.

The event message and timeout configuration options are not part of the initial config creation flow. However, you can set these options at any time in the playground or from the configuration’s edit page after your configuration has been created.


Apply the configuration
After creating an EVI configuration, you can use it in your conversations with EVI by including the
config_id in the query parameters of
your connection request. You can find the config_id
on the configuration’s edit page. To access this page, first
navigate to the configurations page and then click the Edit button for
the desired configuration.

See the sample code below which showcases how to apply your configuration: