For the complete documentation index, see llms.txt. This page is also available as Markdown.

Create an agent

Create a new AI voice agent with configured instructions, voice, and settings, ready for deployment.

Agents handle calls based on the instructions, voice, and settings you define. This tutorial shows how to create an agent and configure how it behaves during calls.

Before you start

Make sure you have the following:

  • An active Agentalk account.

  • Basic understanding of how AI agents work.

Use separate agents for inbound and outbound calls

Create separate agents for inbound and outbound calls. The initial message must differ depending on whether the agent is receiving or initiating the call. Duplicate an existing agent to create the second one quickly.

Follow these steps to create and configure your agent:

1

Open the new agent form

Start by creating a new agent from the dashboard.

  1. Go to AI Agents in the left navigation.

  2. Click Create New agent.

The agent configuration screen opens with multiple tabs.

2

Configure basic settings

Define the core identity and behavior of your agent.

  1. Enter an Agent name. Example: support_inbound_en

  2. Enter the Initial message. This is what the caller hears first. Example: Hi! How can I help you today?

  3. Enable or disable Greeting must complete before user can speak.

  4. In the Conversation guidelines field, you can create and customize the agent’s instructions.

    Choose how you want to generate the instructions:

    • Manual writing: Write the instructions yourself.

    • Smart questionnaire: Answer guided questions to generate instructions.

    • Import from website: Enter a URL to generate instructions based on your site content.

    Once the instructions are generated or written, review and adjust them as needed.

  5. (Optional) Click Add parameter to capture structured data such as names, dates, or other variables during the conversation.

  6. (Optional) Open Additional settings:

    • Enable Call recording.

    • Select a Knowledge base.

    • Add a Conversation summary webhook URL.

When to use a knowledge base

The knowledge base is optional. Use it when your agent needs to answer questions from large or complex content.

3

Select voice and language

Choose how your agent sounds and generates responses.

  1. In Voice model selection, choose one option:

    1. Gemini or OpenAI

      Use this option for a simple setup with preconfigured models and minimal setup.

      • Select a voice in Voice and API key selection

      • Configure Background settings:

        • Sound type

        • Sound volume

      • (Optional) Set Language selection.

    2. Custom configuration Use this option when you need more control over the language model and voice behavior.

      • In LLM settings, choose:

        • Model type

        • Provider

      • Select a voice in Voice selection

      • Configure:

        • Background noise

        • Language (optional)

Additional fields may appear depending on your configuration.

4

Configure advanced settings

Adjust how the agent responds during calls. Most users can skip this step.

The following settings are optional and can be configured based on your use case.

Response settings

Control how the agent generates responses.

  • Maximum tokens: Controls response length.

  • Creativity level (temperature): Controls variation.

Interruptions & monitoring settings

Define when the agent can interrupt or be interrupted during the conversation.

  • Minimum interrupt duration: Minimum time before an interruption is detected

  • Minimum words: Minimum words required before allowing interruption

Timing settings

Control how the agent detects when the caller has finished speaking.

  • Minimum delay for end of speech

  • Maximum delay for end of speech

  • Silence timeout

  • Maximum duration: Limits how long the call can last.

Punctuation & response settings

Adjust how punctuation affects response timing.

  • Enable Automatic punctuation response.

  • Set Response delay for punctuation.

Save your changes when you finish configuring these settings.

5

Save and test the agent

Save your configuration and verify it works.

  • Click Save draft to keep changes without activating the agent.

  • Click Save to apply the configuration.

  • Click Save and test agent to run a test call.

  • Click Cancel to discard changes.

Next steps

Here are the recommended next steps after completing this guide:

Last updated