Create your first agent

Updated

Create and test your first AI voice agent in minutes using a pre-built template.

This page guides you through creating and testing your first AI voice agent. In less than 10 minutes, you will have a working agent that you can speak to in the browser. No telephony setup is required.

Prefer natural language?

Use Concierge to build and test an agent by describing what you want instead of following the steps below.

Create an agent

To create your first agent:

  1. Log in to Agora Console.

  2. Select your project from the dropdown at the top of the page. The agent uses this project's credentials to connect to Agora. Agora bills the usage to this project.

  3. In the navigation sidebar, select Agents.

  4. Select Create Agent.

  5. Enter a name for your agent.

  6. Under Choose a template, select the Blank Template.

  7. Select Create Agent.

    The agent editor opens with a system prompt and pre-configured model settings.

Configure your agent

The agent editor is organized into multiple tabs. For the quickstart, you only need to review the Prompt tab and the Models tab.

Review the prompt

The agent editor opens with the following prompts:

  • System prompt: The base instructions that shape how your agent thinks, speaks, and escalates.
  • Greeting: The first assistant message before the live exchange starts. Type in a greeting such as Hello, how can I help you today?
  • Failure message: The fallback message used when the agent needs a moment or cannot proceed.

Review selected models

Models determine which ASR, LLM, and TTS services your agent uses to process speech, generate responses, and synthesize voice output.

  1. Select the Models tab.

  2. Review the pre-selected models for Automatic Speech Recognition (ASR), Large Language Model (LLM), and Text-to-Speech (TTS). Use the default values to create your first agent.

The default models support Agora Managed Key. When you use a managed key, Agora provides the API credentials for your selected vendor. You do not need to obtain an API key directly from the vendor. See Pricing for details. To use your own API key or use a vendor that does not support a managed key, see Customize your agent.

Test the agent

  1. Select the Test tab in the right panel.
  2. Select Start Call to start a test call.
  3. Allow microphone access when prompted.
  4. Speak to the agent to verify it responds correctly.

For guidance on what to test and how to troubleshoot issues, see Test your agent.

Next steps

You now have a working voice agent. From here you can:

  • Customize your agent: Fully configure models, prompts, and advanced settings for your use case
  • Manage integrations: Manage API credentials, knowledge bases, MCPs, custom tools, and connectors for reuse across agents