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

# First Agent

> Build your first voice agent step by step — manually or with the AI generator.

# 🎨 Build Your First Agent

Once the app is running and your API keys are configured, here's how to build a simple voice agent.

## Manual build

<Steps>
  <Step title="Add an Agent node">
    Drag **Agent** from the sidebar onto the canvas. This is the central node that orchestrates your voice agent — configure the agent name, persona, and language here.
  </Step>

  <Step title="Add component nodes">
    Drag an **LLM**, **TTS**, and **STT** node onto the canvas. Connect each one to the Agent node — they auto-route to the correct handle.
  </Step>

  <Step title="Configure the Agent">
    Click the Agent node and fill in the **Persona** (system prompt) field — e.g., "You are a friendly customer support agent."
  </Step>

  <Step title="Build the conversation flow">
    Add a **Start** node and connect it to the Agent node's output. Then add a **Burst** node, then an **End** node. Chain them: Start → Burst → End.
  </Step>

  <Step title="Set the opening line">
    Click the Start node and set the **Command** to your opening line (e.g., `Hello! How can I help you today?`). Enable **Is Literal** to speak it verbatim instead of generating it.
  </Step>

  <Step title="Test it">
    Click **Test** in the top bar, then **Start Session**. Allow microphone access when prompted and start talking to your agent.
  </Step>
</Steps>

## Or use the AI generator

Instead of building manually, describe your agent in plain language:

1. Click the **AI** button in the toolbar
2. Type something like: `Build a customer support agent with a greeting, a triage question, and two branches: billing and technical support`
3. The AI generates the full flow and applies it to the canvas automatically

***

## Next steps

<CardGroup cols={2}>
  <Card title="API Keys" icon="key" href="/getting-started/api-keys">
    Full reference for every supported provider key.
  </Card>

  <Card title="Node Overview" icon="circle-nodes" href="/building-flows/node-overview">
    Learn about all available node types.
  </Card>

  <Card title="AI Generation" icon="wand-magic-sparkles" href="/ai-generation/generate-flow">
    Generate flows from natural language.
  </Card>

  <Card title="Environment Variables" icon="gear" href="/deployment/environment-variables">
    Complete environment variable reference.
  </Card>
</CardGroup>