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

# DialNexa Agents Overview

> Understand the DialNexa Agents tab, including agent lists, folders, language filters, status filters, row actions, templates, test calls, published versions, and live routing readiness.

The Agents tab is where you manage the people your callers will speak to. Each agent contains the conversation behavior, language, model, voice, transcriber, functions, call settings, post-call fields, webhooks, and published version that live traffic can use.

<img src="https://mintcdn.com/dialnexa/0efoAN-6So4r-6NC/images/documentation/screenshots/agents-list.png?fit=max&auto=format&n=0efoAN-6So4r-6NC&q=85&s=47131c6e849318a5135178095967e6d1" alt="DialNexa Agents list showing language filter, status filter, search, create agent, phone number, call type, status, and row actions." style={{ width: '100%', maxWidth: '1100px', margin: '8px 0 24px', border: '1px solid #e5e7eb', borderRadius: '6px' }} width="3420" height="1964" data-path="images/documentation/screenshots/agents-list.png" />

<img src="https://mintcdn.com/dialnexa/O6bVvssz6DpTKOa0/images/documentation/screenshots/create-agent-basics.jpg?fit=max&auto=format&n=O6bVvssz6DpTKOa0&q=85&s=99329603a8113295484e9e22c7edf2e3" alt="DialNexa Create Agent modal showing Single prompt agent and Conversational flow agent type choices." style={{ width: '100%', maxWidth: '1100px', margin: '8px 0 24px', border: '1px solid #e5e7eb', borderRadius: '6px' }} width="1710" height="985" data-path="images/documentation/screenshots/create-agent-basics.jpg" />

<Note>
  Treat an agent like a hire for a very specific job. A booking agent, support intake agent, and payment reminder agent should not be the same person with a different name tag.
</Note>

## Start By Choosing The Agent Type

The most important early decision is the agent type. Choose Single Prompt for one focused objective, Conversational Flow for explicit node-based paths, and Speech to Speech for realtime voice calls where low turn latency matters.

<CardGroup cols={3}>
  <Card title="Types Of Agents" icon="bot" href="/agents/types-of-agents">
    Compare Single Prompt, Conversational Flow, and Speech to Speech before building.
  </Card>

  <Card title="Single Prompt Agents" icon="sparkles" href="/agents/single-prompt-agents">
    Use one prompt for one clear call objective.
  </Card>

  <Card title="Speech To Speech Agents" icon="audio-lines" href="/agents/speech-to-speech-agents">
    Use OpenAI realtime or Gemini model paths where enabled.
  </Card>
</CardGroup>

## What The Agents List Owns

| Area            | What users can do                                                                      |
| --------------- | -------------------------------------------------------------------------------------- |
| Search          | Search by agent name and agent id. Some links can also prefill search through the URL. |
| Language filter | Filter agents by the language saved on the current version.                            |
| Status filter   | Show all, active, or inactive agents based on publish and availability state.          |
| Folders         | Create folders, rename folders, delete folders, and move agents between folders.       |
| Agent rows      | Open an agent, inspect version context, and use row actions.                           |
| Create agent    | Start from Agent Builder, a blank agent, or a template where available.                |

## Agent Builder

Agent Builder is the guided create path for a draft Single Prompt Agent. It asks for business context, target customer, call objective, success criteria, information to collect, objections, tone, and extra context. DialNexa then drafts the prompt, welcome message, post-call fields, dynamic variables, and technical profile for review.

Use it when you want a strong first draft from structured answers. Start manually when you need a Conversational Flow Agent, exact compliance language, or a known production prompt.

## Row Actions

<CardGroup cols={2}>
  <Card title="Test call" icon="phone-call" href="/agents/testing-agents">
    Starts a phone test using the latest published version. If no published version exists, publish before testing from the list.
  </Card>

  <Card title="Duplicate" icon="copy" href="/agents/agent-versions-and-publishing">
    Creates a copy so users can experiment without changing the original agent.
  </Card>

  <Card title="Export" icon="download" href="/agents/history-and-version-review">
    Exports an agent configuration for reuse or backup.
  </Card>

  <Card title="Move" icon="folder-input" href="/agents/agent-folders">
    Moves the agent into a folder for use-case, customer, team, or environment organization.
  </Card>
</CardGroup>

## From Draft To Live Traffic

<Steps>
  <Step title="Create or import the agent">
    Choose a blank agent, a template, or an imported configuration.
  </Step>

  <Step title="Choose the conversation stack">
    Set voice, language, LLM model, transcriber, and voice model.
  </Step>

  <Step title="Write behavior">
    Add prompt, welcome behavior, variables, functions, and knowledge references where needed.
  </Step>

  <Step title="Connect useful actions">
    Add custom functions, dashboard integrations, workflow actions, or webhooks only when the call outcome needs them.
  </Step>

  <Step title="Set operational controls">
    Configure speech settings, call settings, post-call analysis, fallback behavior, and webhooks.
  </Step>

  <Step title="Publish a version">
    Published versions are what live routes should use.
  </Step>

  <Step title="Assign a route">
    Attach the version to a phone number, batch call, workflow call node, web call, or test call.
  </Step>
</Steps>

## Why A Test Call May Not Start

<AccordionGroup>
  <Accordion title="No published version">
    The list action looks for a published version first. Publish the draft before using row-level test call.
  </Accordion>

  <Accordion title="Invalid recipient number">
    The modal validates country code and expected digit length. Remove formatting and check the selected country.
  </Accordion>

  <Accordion title="Missing dynamic variables">
    If the agent prompt or flow expects variables, provide test values so the call does not sound incomplete.
  </Accordion>

  <Accordion title="Transfer destination validation failed">
    Conversational flow transfer destinations can require valid dynamic values before the test call starts.
  </Accordion>

  <Accordion title="Workspace not ready">
    KYC, wallet, or outbound readiness can block some outbound behavior. Follow the readiness prompt in the dashboard.
  </Accordion>
</AccordionGroup>

## What Not To Change From The List

The Agents list is for navigation and operations. Change detailed behavior inside the agent builder.

| Need                                                        | Open this page                      |
| ----------------------------------------------------------- | ----------------------------------- |
| Prompt, welcome message, or model behavior.                 | Agent builder.                      |
| Voice, language, transcriber, or voice model.               | Agent builder top selectors.        |
| Speech timing, Audio Cache, or Hinglish Map.                | Agent Settings, Speech Settings.    |
| Silence timeout, duration, voicemail, or transfer behavior. | Agent Settings, Call Settings.      |
| Extraction fields.                                          | Agent Settings, Post-call Analysis. |

## Related Reading

<CardGroup cols={2}>
  <Card title="Types Of Agents" icon="bot" href="/agents/types-of-agents">
    Choose the right agent structure before configuring the stack.
  </Card>

  <Card title="Agent Builder" icon="sparkles" href="/agents/ai-agent-builder">
    Create a draft single prompt agent from a guided brief.
  </Card>

  <Card title="Languages Voices Models And Transcribers" icon="sliders-horizontal" href="/agents/languages-voices-models-and-transcribers">
    Choose the conversation stack.
  </Card>

  <Card title="Single Prompt Agents" icon="sparkles" href="/agents/single-prompt-agents">
    Use one prompt for one clear objective.
  </Card>

  <Card title="Conversational Flow Agents" icon="git-branch" href="/agents/conversational-flow-agents">
    Use explicit branching for scripted calls.
  </Card>

  <Card title="Speech To Speech Agents" icon="audio-lines" href="/agents/speech-to-speech-agents">
    Compare realtime model paths for latency-sensitive calls.
  </Card>

  <Card title="Testing Agents" icon="phone-call" href="/agents/testing-agents">
    Place safe test calls.
  </Card>

  <Card title="Dashboard Integrations" icon="plug" href="/dashboard-integrations/overview">
    Connect agent outcomes to WhatsApp, email, workflows, and external systems.
  </Card>
</CardGroup>
