Skip to main content
Create a working phone agent by setting its role, voice, greeting, and deployment path. This guide keeps the setup focused so you can make your first test call in a few minutes.
Agni Agents dashboard with existing agents and the option to create a new agent

​
Before you start

You need access to an Agni workspace. If you have not signed in yet, follow Authentication first. For live phone deployment, you also need a connected phone number. You can still create and test the agent in your browser without one.

Create

Build the agent and define how it should handle calls.

Test

Run a browser call before you send the agent to real callers.

Deploy

Connect the agent to a number or campaign when it is ready.

​
Create the agent

Open Agents

From the Agni dashboard, click Agents in the sidebar.
Agents dashboard showing the list of configured agents

Start a new agent

Click + New Agent to open the agent builder.The builder gives you a prompt editor, model controls, voice settings, and test tools in one workspace.
Agni agent builder with the prompt editor and configuration panels

Add a starter prompt

In the prompt editor, describe the agent’s role, tone, goal, and boundaries.Use this starter prompt for your first test:

Choose the model

Open the model selector and choose the model you want the agent to use.For a first agent, choose the default recommended model unless you already know you need a faster or more specialized option.
Model selector in the Agni agent builder

Pick a voice

Choose a voice that matches the caller experience you want.Click a voice to preview it, then select it for the agent.
Voice picker showing available voices for an Agni agent

Set the welcome message

Open the Welcome Message settings and choose how the agent starts the call.For your first agent, use a direct greeting:
Welcome message settings for an Agni agent
Keep the first version small. Add tools, knowledge bases, and advanced call handling after the agent can complete one simple conversation well.

​
Test the agent

Use a browser call before connecting the agent to a phone number. This helps you catch prompt issues without spending telephony credits.
Testing panel for running web and phone calls with an Agni agent

Open the testing panel

In the agent builder, open the testing panel.

Start a web call

Select Web Call, then start the call from your browser.

Try a realistic caller request

Speak like a real caller. For example:

Review the conversation

Check whether the agent asked for the right details, stayed on task, and ended the call clearly.
If the agent gives long answers, add a prompt rule such as Keep responses under two sentences. If it skips required details, list those details explicitly in the prompt.

​
Deploy the agent

Once the browser test works, connect the agent to a real calling path.

Connect a phone number

Open Phone Numbers and buy, import, or connect a number.
Phone Numbers dashboard showing connected phone numbers

Route inbound calls

For incoming calls, create an inbound rule and assign the phone number to your new agent. See Inbound Calls under Campaigns for the full setup.

Use the agent in outbound calls

For outbound calls, add the agent to an outbound workflow after you have contacts and caller ID ready. See Outbound under Campaigns for the workflow.

Run one live test

Call the number or launch a small test campaign. Confirm that the agent answers, follows the prompt, and captures the outcome you expect.

​
Next steps

Agents

Configure tools, speech settings, memory, and post-call extraction.

Prompt engineering

Improve how your agent handles edge cases and caller intent.

Phone numbers

Buy, import, and manage numbers for live calling.

API reference

Explore REST API endpoints for programmatic agent workflows.