In this quickstart, we’ll create an outbound voice agent that can navigate an IVR and get a restaurant’s hours. This guide will provide an overview of the platform by walking through the creation of a sample agent; for a more in-depth guide to using Vogent, see the platform overview guide.

Before you go through this guide, make sure to create an account.

The agent

Our outbound agent navigates an IVR and gets a restaurant’s hours.

Creating a new agent

To create a new agent, navigate to the Agents tab on the left sidebar and click the New Agent button on the top right.

For this quickstart, we’ll walk through the pre-built agent together. You can clone this agent to your workspace by following the instructions here.

Configuring the agent

Once you click into your cloned agent, you’ll see the agent’s configuration page. This is mission control for your agent, where you can configure the agent’s behavior and settings, go through past dials and run evaluations, and more.

Prompting the agent

Click on the Model tab to see the language model configuration for this agent.

This specific agent comprises both an IVR navigation model and a conversational model. The IVR model triggers when Vogent detects that a line is from an IVR; once it detects a human line, it switches irreversibly to the conversational model. See the IVR Settings section for more information.

You can view each model by going to the Version dropdown and selecting ivr-version or conversational-version.

The IVR Model

The IVR model is a prompted agent on top of GPT-4o. The prompt is as follows:

The Conversational Model

The conversational model is a prompted agent on top of Vogent’s Base Conversations model. This is a custom model that we offer that has been fine-tuned to perform well on the phone with minimal prompting.

The prompt is as follows:

For more information on prompting agents and choosing a base model, see the prompting agents guide.

Retrieving the hours post-call

After the call is completed, you can retrieve the hours from the call using the Dial Extractor webhook. The webhook will return the extracted hours in the format defined within the agent’s Extractor tab.

You can also view the extracted hours by clicking on the dial in the agent’s Dials tab, or in the Dial History tab in the left sidebar.

For this particular agent, we’ve defined the following extractor fields:

Field NameTypeDescriptionNullable
opening_timestringThe opening time, in military time, in the format HH:MMfalse
closing_timestringThe closing time, in military time, in the format HH:MMfalse

Thus, after every call, Vogent’s extractor model will parse the transcript for the opening_time and closing_time fields, and store them in the dial.

For more information on how to define extractors and use them effectively, see the extractors guide.

Making a call

Phone call

To make a phone call from an outbound agent, you’ll first need to create a phone number; see the getting started guide for more information.

You can then follow these steps:

1

Open the call modal

Click on the Make Call button on the top-right of the agent’s page.

2

Populate fields

In the Configure section, click on Find From Prompt to extract all of the variables from the prompt. Then, for each variable (in this case, just {{restaurant_name}}), enter a value.

3

Select an outbound phone number

Below the Configure section, toggle to Phone and select the phone number you want to call from.

4

Make the call

Enter the phone number that you’d like to dial, then click Dial.

Web call

To make a web call, you can follow the steps above; just toggle to Web instead of Phone.

Viewing past calls

To view past calls to the agent, you can go to the agent’s Dials tab. This will show you a list of all past calls to the agent as well as the extractor results. You can click into any dial to listen to the recording and see the full transcript of the call, among other things. You can also filter calls by date range, call type, and more, or view dials across agents in the Dial History tab on the left sidebar.

Testing new version on past calls

If you’ve made changes to your agent, you can test the new version on past calls by clicking the Run Counterfactual button when you’ve clicked into a dial. This will run the new agent on the same call transcript and show you the results.

Counterfactuals will feed call history up to the current line to generate each response, so they won’t be perfect reconstructions of how the conversation would have gone. LLM-as-judge functionality is coming soon to enable more dynamic agent testing. See the counterfactuals guide for more information.

Conclusion

In this quickstart, we’ve walked through the creation of an outbound agent that can navigate an IVR and get a restaurant’s hours. We’ve also covered how to define extractors and use them effectively.

This was a cursory overview of the different components of Vogent that can be used to create an outbound agent. To go further in depth on any of these features, or to understand functionality not covered here, see the platform overview guide. You can also check out some of our other quickstart guides for different agent types: