Agent Building Features within the AI Studio platform Agent Building Features within the AI Studio platform

Agent Building Features within the AI Studio platform

Maria Scieranska

Objective

Learn about the features within the Vonage AI Studio platform.  

Applies To

  • Vonage AI Studio

Content

  1. Change agent details
  2. JWT Endpoint
  3. Canvas Toolbar
  4. Canvas search bar
  5. Missing features colour codes
  6. Move & duplicate multiple nodes
  7. Jump to node
  8. Label your nodes
  9. Duplicating an agent
  10. Export and Import Agents

Change agent details

You can change your agent's details at any point by clicking on the three dots on the top left. This includes:-

Agent Details - Displays your agent name, agent type, agent ID, chosen language, region, time zone, voice, volume and integration details. This also includes the the option to share your recordings to make them public.

Noise Sensitivity (For Voice only) - Users calling in with a lot of background disturbance? You can now customize the sensitivity of your agent to noise from the telephony settings in the agent details.

Setting the noise sensitivity appropriately is imperative especially if you have the barge-in feature enabled in your agent. Be sure to test in live environments to accurately imitate the environments that user will be calling in from.

a1.png

By default the Noise sensitivity is set to 40, we recommend testing your agent out 
with 20 to suit most background noise levels.

Phone Settings - Access settings to change or remove your agent's phone number.

Versions - This button can be used to access your past version history. More on versions and publishing here.

Duplicate - Use this feature if you want to duplicate your agent.

Export Agent - This feature allows you to export and import an agent to a different account.

Delete -  Option to delete your agent.

a2.gif

 

JWT Endpoint

You can now send your X-Vgai-key to an endpoint in order to get the JWT token. This works well in cases where you require the token to access private recordings for voice agents or secure inbound media for WhatsApp agents. 

 

Additionally the endpoint will also allow you to return agent data including: agent language, voice (if it's a telephony agent), timezone, name, status of the recording (private or public), region and the date of publishing the agent.

Here's how to go about it:-

GET https://studio-api-eu.ai.vonage.com/agents/:agentid

Headers

Name Type Description
X-Vgai-Key String  

Please keep in mind that this endpoint will return the JWT token only for SMS, WhatsApp and Telephony agents. HTTP agents do not have JWT tokens.

 

Canvas Toolbar

With this tool you can organise the agent and it will help you find your way around the canvas.

a3.webp

From left to right -

  • Home - Go to the START node
  • Zen Mode - Removes the left and right tab with the building blocks from the screen and centralises on the canvas
  • Zoom to fit - Zoom out to view the entire agent
  • Zoom in and out - focus on certain parts of the agent or look at the big picture
  • Search bar - Type in the name of your node, a specific parameter or user expression, and have the agent guide you to the right place.

Canvas search bar

You can open the search bar by clicking on the top left magnifying glass icon. Search for a node, parameter, contact, location, intent, and more with a single click.

a4.gif

 

Missing features colour codes

If there is a problem with a node, it will be indicated in either yellow or red.

Yellow - More information needs to be entered, nodes are not connected

Red - Invalid data (missing parameter, validation error on the form itself), connected in an illogical manner e.g. Speak node after End Call node. This can also happen for example when you delete a parameter that's being used in the flow.

 

a5.webp

 

Move & duplicate multiple nodes

You can move multiple nodes by clicking and holding Shift and using your cursor to select and mark the cluster of nodes you want to move around the canvas. The selected nodes will appear with a purple outline. Click and hold any of the selected nodes and drag your cursor to move the cluster.

For Windows users hold Crtl + Shift whilst you select your nodes.

If you choose to duplicate multiple nodes, again click Shift, hold and mark the desired nodes. Then, click Command C, Command V for Mac, and Ctrl C, Ctrl V for Windows.

a6.gif

 

Jump to node

When doing a right-click on the exit point of a node, you have the ability to either jump to or connect to another node.

Jump to - Go to the following node in the flow that this node is connected to. Very helpful in large agents where nodes might not be in close proximity to one another.

Connect to - Using the node name in your search, you can now connect to another node without dragging the arrow. Simply select the node you'd like to connect to and the agent will connect them for you.

a7.gif

 

Label your nodes

You can rename your nodes to understand the topic of each node from a quick glance.

Click on a node and change the name of the node by selecting it and adding your name of choice.

a8.gif

 

Duplicating an agent

To duplicate an agent in your account, go to the main page, and click on the three little dots on the right at the end of the row of the agent. Select "Duplicate".

A new drawer will pop up to adjust the details of your agent copy. Once done, a duplicate of the original agent with your adjustments is going to be created at the top of the page.

a9.png

 

Export and Import Agents

Export and import your AI Studio agents from one account to another.

To export the agent from your account, follow these steps:

1. Go to the main agent page in your AI Studio account.
2. Locate the agent you want to export in the list.
3. Click on the three dots (ellipsis) on the right side next to the desired agent.
4. A menu should appear. Look for an option labeled "Export Agent".
5. Click on "Export Agent". This will trigger an email associated with the Vonage Studio account along with a link to download the exported agent.

Export_Agent.png

6. Follow email instructions to download the exported agent.

mail_exporting.png

 

 

To import the agent, use the following procedure:

1. Go to the main agent page in your AI Studio account.
2. Click on the "Import Agent" on the top right corner of the screen.

import_agent_1_1.png
3. Upload the agent's file in .zip format.
4. Once it is uploaded, you can make some changes to the agent, i.e. rename it, switch the region or the timezone, and change the voice, volume, and noise sensitivity under Telephony.
5. After all desired changes are made, click on the black "Import Agent" button on the top right of the drawer.

import_agent_2.png

import_agent_3.png

6. Now your agent has appeared on your account. Simply add a phone number and you are good to go!