---
title: "Agents"
description: "Agents puts AI voice agents on calls and conversations: create calls over REST and talk to an agent in real time from your app."
version: "en"
---

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

# Agents

Agents puts AI agents on calls and voice conversations. Over REST you
create calls and follow their state; over a WebSocket you talk to an agent in
real time from your own app, with text or audio.

With the Agents API you can:

- Have an agent call a customer and know how the call ended.
- Open a voice conversation with an agent from a browser or an app,
  without exposing your key.
- Test every branch of your code without dialing any number, with the magic
  numbers of test mode.

With a test key, no call is dialed and nothing is billed.

## Get started

- [Quickstart](/get-started/quickstart/) — Check your key and create your first call, in cURL, Python or TypeScript.
- [Talk to an agent in real time](/agents/realtime/) — Create a session, open the socket and talk, in Python or TypeScript.
- [Test mode](/concepts/test-mode/) — The magic numbers and what changes with a test key.
- [BYOC: your own telephony](/concepts/byoc/) — Your carrier or your SIP trunk brings your existing numbers to your agents.

## Reference

- [API reference](/agents-api/) — Calls and realtime sessions: every endpoint, field and error.
- [Realtime WebSocket](/agents/websocket/) — Every message you send and receive over the /realtime channel.

Source: https://docs.qomni.ai/agents/index.mdx
