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

# Create your first agent

> Build an AI voice agent from scratch and set its name, languages, greeting, personality, and voice.

<Info>
  An agent is the AI persona that talks to your callers. Creating one takes a few minutes — you set the basics here, then refine each part on its own page afterward.
</Info>

<Steps>
  <Step title="Open the agents page">
    From the dashboard, go to `/agents` and click **Create agent** (or open `/agents/create`).

    <Check>
      You'll see a single page with four sections: Overview, Scripts, Personality, and Voice.
    </Check>
  </Step>

  <Step title="Fill in the overview">
    Under **Overview**, set:

    * <strong>Name</strong> (required) — what the agent is called
    * <strong>Languages</strong> (required) — up to three languages the agent can speak
    * <strong>Timezone</strong> (required) — used for scheduling and call windows
    * <strong>Status</strong> — Active, Inactive, or Archived

    <Tip>
      Leave the avatar empty and an AI avatar is generated automatically. You can upload your own later.
    </Tip>
  </Step>

  <Step title="Write a greeting">
    Under **Scripts**, enter a **Greeting** (required) — the opening line the agent speaks. Click the **generate** button (the sparkles icon) to draft one for you based on the name and language.
  </Step>

  <Step title="Set personality and pick a voice">
    Under **Personality**, choose **Tones** and optionally write a personality description (the **generate** button can draft this).

    Under **Voice**, browse the female/male voice lists and click the play button to preview. Click a voice to select it (required).
  </Step>

  <Step title="Create the agent">
    When the status bar shows **All required fields are set**, click **Create agent**. You're taken to the agent's detail page where you can refine everything.

    <Check>
      The new agent appears in your `/agents` list and in the sidebar.
    </Check>
  </Step>
</Steps>

## What's next

After creating an agent, fine-tune it on its dedicated tabs:

<Columns cols={2}>
  <Card title="Personality & voice" icon="microphone" href="/guides/agent-personality-voice">
    Adjust tone and switch voices.
  </Card>

  <Card title="Scripts" icon="comment-dots" href="/guides/agent-scripts">
    Refine the greeting and conversation flow.
  </Card>

  <Card title="Questions & data" icon="list-check" href="/guides/agent-questions-data">
    Decide what the agent asks and captures.
  </Card>

  <Card title="Appointments" icon="calendar-check" href="/guides/appointments-offerings">
    Let callers book time on your calendar.
  </Card>
</Columns>

## Troubleshooting

<AccordionGroup>
  <Accordion title="The Create agent button is disabled">
    All required fields must be set: name, at least one language, timezone, a greeting, and a selected voice. The status bar at the bottom tells you what's missing.
  </Accordion>

  <Accordion title="I hit an agent limit">
    Your plan caps how many agents you can create. Upgrade your plan, or archive an agent you no longer use, then try again.
  </Accordion>

  <Accordion title="The AI generate buttons don't work">
    Set the agent's languages first — personality and script generation need a language to work from.
  </Accordion>
</AccordionGroup>