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

# Quick Start

> Create your first voice agent in 5 minutes

Build a simple voice agent with three stages: Start, Conversation, and End Call. This guide walks you through the essential steps to get your first agent up and running.

## Step 1: Create a New Agent

<Steps>
  <Step title="Navigate to Flow Agents">
    From the dashboard sidebar, click **Flow Agents**.
  </Step>

  <Step title="Click Create New Agent">
    Click the **Create New Agent** button in the top right corner.
  </Step>

  <Step title="Enter Agent Details">
    Fill in the creation form:

    * **Name**: Give your agent a descriptive name (e.g., "Customer Support Agent")
    * **Description**: Optional description of what the agent does
    * **Language**: Select the primary language (default: English US)

    Click **Create** to proceed.
  </Step>
</Steps>

## Step 2: Build the Flow

After creation, you'll enter the Flow Canvas. A **Start** node is automatically added.

<Steps>
  <Step title="Configure the Start Node">
    Click on the **Start** node to select it. In the right panel:

    * Set **Speaker First** to "Agent" (the agent speaks first)
    * Enter a **Greeting Message**:

    ```
    Hello! Thank you for calling. How can I help you today?
    ```
  </Step>

  <Step title="Add a Conversation Node">
    From the left sidebar, drag a **Conversation** node onto the canvas below the Start node.

    Click on the Conversation node and configure:

    * **Mode**: Prompt (AI generates responses)
    * **Prompt**: Enter instructions for the AI:

    ```
    You are a helpful customer service assistant.
    - Answer questions about our products and services
    - Be friendly and professional
    - If you cannot help, offer to transfer to a human agent
    - When the customer is done, thank them and end the call
    ```
  </Step>

  <Step title="Connect Start to Conversation">
    Click the handle (small circle) on the bottom of the **Start** node and drag to the top handle of the **Conversation** node. A connection line will appear.
  </Step>

  <Step title="Add an End Call Node">
    Drag an **End Call** node from the sidebar onto the canvas.

    Configure it:

    * **Farewell Message**:

    ```
    Thank you for calling! Have a great day.
    ```
  </Step>

  <Step title="Add a Transition">
    In the Conversation node, scroll to **Transitions** and click **Add Transition**:

    * **Condition**: "The customer indicates they are done or says goodbye"
    * **Go to**: Select the End Call node

    This tells the agent when to end the conversation.
  </Step>
</Steps>

## Step 3: Test Your Agent

<Steps>
  <Step title="Open Test Panel">
    Click the **Test** button in the top toolbar to open the test interface.
  </Step>

  <Step title="Start a Test Chat">
    Type a message like "Hi, I have a question about your products" and press Enter.

    Watch as:

    * The active node highlights on the canvas
    * The AI responds based on your prompt
    * Transitions activate when conditions are met
  </Step>

  <Step title="Verify the Flow">
    Test different scenarios:

    * Ask a few questions
    * Say "That's all, thank you" to trigger the end transition
    * Confirm the farewell message plays
  </Step>
</Steps>

## Step 4: Save and Publish

<Steps>
  <Step title="Save Your Work">
    Click **Save** in the top toolbar. Your flow auto-saves, but manual save ensures all changes are captured.
  </Step>

  <Step title="Activate the Agent">
    Toggle the **Active** switch in the top toolbar to enable the agent for live calls.
  </Step>
</Steps>

## Your First Flow

Here's what your completed flow should look like:

```
┌─────────────────┐
│     START       │
│  "Hello! Thank  │
│  you for..."    │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  CONVERSATION   │
│  Customer       │
│  Service AI     │
└────────┬────────┘
         │ "done or goodbye"
         ▼
┌─────────────────┐
│    END CALL     │
│  "Thank you..." │
└─────────────────┘
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Flow Canvas" icon="diagram-project" href="/agent-builder/flow-canvas">
    Learn about the canvas interface in detail
  </Card>

  <Card title="Conversation Stage" icon="comments" href="/agent-builder/stages/conversation">
    Deep dive into conversation node configuration
  </Card>

  <Card title="Voice Settings" icon="microphone" href="/agent-config/voice-settings">
    Configure your agent's voice and speech
  </Card>

  <Card title="Attach Phone Number" icon="phone" href="/publish/phone-number">
    Connect your agent to a phone number
  </Card>
</CardGroup>