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

# Launch an Agent

> Create, test, and connect a PyAI voice agent in the console without writing code. Agents is live in beta.

Agents is live in **Beta**. Use the console to configure an Omni-powered voice
agent, test its opening message in the browser, and connect a phone number.
Features, limits, and production behavior may change during beta.

<Note>
  Agents usage is billed at the current Agents rate. Managed telephony is
  metered separately. Sandbox API keys never bill, but production Agent calls
  require a funded live account.
</Note>

<Steps>
  <Step title="Open the Agent builder">
    Go to [Launch an Agent](https://console.pyai.com/agents?signup=1\&path=agent\&utm_source=docs.pyai.com\&utm_medium=docs).
    Sign up or sign in. The path is preserved through authentication.
  </Step>

  <Step title="Describe the job">
    Choose a template or start blank. Set the agent's persona, greeting,
    language, voice, and the rules it must follow.
  </Step>

  <Step title="Connect knowledge and tools">
    Add the information the agent should answer from. Bind tools when the agent
    needs to look up data or take an action. Keep sensitive credentials in
    server-side tool configuration.
  </Step>

  <Step title="Test before assigning a number">
    Run the browser greeting test. Confirm that the opening line, voice, and
    first response match your instructions. Test transfer and consent behavior
    when your workflow uses them.
  </Step>

  <Step title="Connect a phone number">
    Assign an available managed number or connect a supported carrier route.
    Availability and regulatory onboarding vary by country. Live calls consume
    Agents usage plus any managed telephony usage.
  </Step>
</Steps>

## Agents Beta or Omni API?

Choose **Agents Beta** when you want a console workflow for configuration,
testing, and phone setup. Choose the **Omni API** when your application needs to
open realtime sessions and control the full `configure` frame in code. Both use
the same Omni realtime engine.

## Next steps

<CardGroup cols={2}>
  <Card title="Agent greetings" href="/guides/agent-greeting">Set the first line and recording consent behavior.</Card>
  <Card title="Omni tools" href="/guides/omni-tools">Connect hosted, server, or client tools.</Card>
  <Card title="Pricing and metering" href="/pricing-and-metering">Understand Agents and telephony usage.</Card>
  <Card title="Build with the API" href="/quickstart#build-with-the-api">Use an instant sandbox key and make your first request.</Card>
</CardGroup>