> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravan.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Build your first phone agent in 5 minutes

> Step-by-step guide to create, test, and deploy your first AI phone agent.

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.

<Frame>
  <img src="https://mintcdn.com/agni/wGEXRTXXwORCEgLm/images/agents-dashboard-list.png?fit=max&auto=format&n=wGEXRTXXwORCEgLm&q=85&s=26cc6fb861fb99809c4b80c716da1fd8" alt="Agni Agents dashboard with existing agents and the option to create a new agent" width="1919" height="1079" data-path="images/agents-dashboard-list.png" />
</Frame>

## Before you start

You need access to an Agni workspace. If you have not signed in yet, follow [Authentication](/guides/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.

<CardGroup cols={3}>
  <Card title="Create" icon="robot">
    Build the agent and define how it should handle calls.
  </Card>

  <Card title="Test" icon="phone-volume">
    Run a browser call before you send the agent to real callers.
  </Card>

  <Card title="Deploy" icon="tower-broadcast">
    Connect the agent to a number or campaign when it is ready.
  </Card>
</CardGroup>

## Create the agent

<Steps>
  <Step title="Open Agents" icon="users">
    From the Agni dashboard, click **Agents** in the sidebar.

    <Frame>
      <img src="https://mintcdn.com/agni/wGEXRTXXwORCEgLm/images/agents-dashboard-list.png?fit=max&auto=format&n=wGEXRTXXwORCEgLm&q=85&s=26cc6fb861fb99809c4b80c716da1fd8" alt="Agents dashboard showing the list of configured agents" width="1919" height="1079" data-path="images/agents-dashboard-list.png" />
    </Frame>
  </Step>

  <Step title="Start a new agent" icon="plus">
    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.

    <Frame>
      <img src="https://mintcdn.com/agni/wGEXRTXXwORCEgLm/images/agent-builder-overview.png?fit=max&auto=format&n=wGEXRTXXwORCEgLm&q=85&s=2440d3a8f3dd81a88d09548e9014bb90" alt="Agni agent builder with the prompt editor and configuration panels" width="1919" height="1079" data-path="images/agent-builder-overview.png" />
    </Frame>
  </Step>

  <Step title="Add a starter prompt" icon="pen-line">
    In the prompt editor, describe the agent's role, tone, goal, and boundaries.

    Use this starter prompt for your first test:

    ```text theme={null}
    You are Ava, a helpful phone agent for a dental clinic.
    Your goal is to greet callers, understand why they are calling, and help them book an appointment.
    Ask one question at a time.
    Keep responses under two sentences.
    If the caller asks for medical advice, explain that a dentist will help them during the appointment.
    Confirm the caller's name, preferred date, preferred time, and phone number before ending the call.
    ```
  </Step>

  <Step title="Choose the model" icon="brain-circuit">
    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.

    <Frame>
      <img src="https://mintcdn.com/agni/wGEXRTXXwORCEgLm/images/model-selector.png?fit=max&auto=format&n=wGEXRTXXwORCEgLm&q=85&s=5ade1852d77efa7b200bc7cfda7348e2" alt="Model selector in the Agni agent builder" width="1163" height="145" data-path="images/model-selector.png" />
    </Frame>
  </Step>

  <Step title="Pick a voice" icon="mic">
    Choose a voice that matches the caller experience you want.

    Click a voice to preview it, then select it for the agent.

    <Frame>
      <img src="https://mintcdn.com/agni/wGEXRTXXwORCEgLm/images/voice-picker.png?fit=max&auto=format&n=wGEXRTXXwORCEgLm&q=85&s=99012ff5e46b0bc0d5e5fb5c3ef8dcbc" alt="Voice picker showing available voices for an Agni agent" width="733" height="920" data-path="images/voice-picker.png" />
    </Frame>
  </Step>

  <Step title="Set the welcome message" icon="message-circle">
    Open the **Welcome Message** settings and choose how the agent starts the call.

    For your first agent, use a direct greeting:

    ```text theme={null}
    Hi, this is Ava from Bright Dental. How can I help you today?
    ```

    <Frame>
      <img src="https://mintcdn.com/agni/wGEXRTXXwORCEgLm/images/welcome-message-options.png?fit=max&auto=format&n=wGEXRTXXwORCEgLm&q=85&s=7cdfa15afe564cf0865aa682dc45d51d" alt="Welcome message settings for an Agni agent" width="1078" height="167" data-path="images/welcome-message-options.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Keep the first version small. Add tools, knowledge bases, and advanced call handling after the agent can complete one simple conversation well.
</Tip>

## 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.

<Frame>
  <img src="https://mintcdn.com/agni/wGEXRTXXwORCEgLm/images/testing-panel.png?fit=max&auto=format&n=wGEXRTXXwORCEgLm&q=85&s=d1ca8b3de83ea914a2df611c339e343e" alt="Testing panel for running web and phone calls with an Agni agent" width="535" height="940" data-path="images/testing-panel.png" />
</Frame>

<Steps>
  <Step title="Open the testing panel" icon="flask-conical">
    In the agent builder, open the testing panel.
  </Step>

  <Step title="Start a web call" icon="phone">
    Select **Web Call**, then start the call from your browser.
  </Step>

  <Step title="Try a realistic caller request" icon="messages-square">
    Speak like a real caller. For example:

    ```text theme={null}
    Hi, I need to book a cleaning for next Tuesday afternoon.
    ```
  </Step>

  <Step title="Review the conversation" icon="clipboard-check">
    Check whether the agent asked for the right details, stayed on task, and ended the call clearly.
  </Step>
</Steps>

<Note>
  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.
</Note>

## Deploy the agent

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

<Steps>
  <Step title="Connect a phone number" icon="phone-forwarded">
    Open [Phone Numbers](/guides/phone-numbers) and buy, import, or connect a number.

    <Frame>
      <img src="https://mintcdn.com/agni/wGEXRTXXwORCEgLm/images/telephony-dashboard.png?fit=max&auto=format&n=wGEXRTXXwORCEgLm&q=85&s=1b7e42043cba889da0426bde46353438" alt="Phone Numbers dashboard showing connected phone numbers" width="1919" height="1079" data-path="images/telephony-dashboard.png" />
    </Frame>
  </Step>

  <Step title="Route inbound calls" icon="route">
    For incoming calls, create an inbound rule and assign the phone number to your new agent. See [Inbound Calls](/guides/inbound-calls) under Campaigns for the full setup.
  </Step>

  <Step title="Use the agent in outbound calls" icon="send">
    For outbound calls, add the agent to an outbound workflow after you have contacts and caller ID ready. See [Outbound](/guides/campaigns) under Campaigns for the workflow.
  </Step>

  <Step title="Run one live test" icon="check-circle">
    Call the number or launch a small test campaign. Confirm that the agent answers, follows the prompt, and captures the outcome you expect.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Agents" icon="robot" href="/guides/agents">
    Configure tools, speech settings, memory, and post-call extraction.
  </Card>

  <Card title="Prompt engineering" icon="pen-nib" href="/guides/prompt-engineering">
    Improve how your agent handles edge cases and caller intent.
  </Card>

  <Card title="Phone numbers" icon="phone" href="/guides/phone-numbers">
    Buy, import, and manage numbers for live calling.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/introduction">
    Explore REST API endpoints for programmatic agent workflows.
  </Card>
</CardGroup>
