Agora Conversational AI API

Name: Agora Conversational AI API API
Brand: Agora Conversational AI API
Availability: InStock

★ Only Publicly Available SpecCommunicationsVoice Telephonybasic8 EndpointsREST

For Agents

Spawn, control, and tear down voice AI agents inside Agora RTC channels — start, stop, query, update, speak, interrupt, and pull conversation history.

Quickstart

Get started with Agora Conversational AI API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"start an Agora conversational AI agent"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Agora Conversational AI API API.

Start a conversational AI agent in an Agora channel with an ASR-LLM-TTS configuration

Stop a running agent so it leaves the channel cleanly

Query agent runtime status by ID or list every running agent in a project

Update an active agent's configuration without recreating the session

GET STARTED

Start building with Agora Conversational AI API API

Explore with Jentic

View OpenAPI Spec

Jentic publishes the only available OpenAPI specification for Agora Conversational AI API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for Agora Conversational AI API, keeping it validated and agent-ready. The API provisions and controls AI voice agents that join Agora real-time channels and run an ASR-LLM-TTS pipeline against participants. Eight endpoints under /api/conversational-ai-agent/v2 cover the full agent lifecycle: join a channel, query status, list active agents, update configuration, broadcast a TTS message, interrupt the agent, retrieve conversation history, and leave. Authentication uses HTTP Basic with the Agora App ID and customer secret.

Use Cases

Patterns agents use Agora Conversational AI API API for, with concrete tasks.

★ Voice AI Customer Support Sessions

Support teams spin up an Agora conversational agent the moment a caller joins a channel, configuring the LLM with company knowledge and the TTS voice for the brand. The agent handles the conversation while a human supervisor can intervene by calling the interrupt endpoint, and the conversation history endpoint provides the transcript for QA or model fine-tuning.

POST /api/conversational-ai-agent/v2/projects/{appid}/join with the channel name, LLM config, and TTS voice

AI Voice Concierge in Live Apps

Consumer apps embed an Agora-powered voice agent that greets users, answers questions, and hands back to a human when needed. The /speak endpoint lets the host trigger announcements, and /interrupt yields the floor immediately. Active agent listing helps the app surface a control panel of running sessions.

POST /api/conversational-ai-agent/v2/projects/{appid}/agents/{agentId}/speak with the announcement text

Real-Time Conversation Audit

Compliance and analytics pipelines pull the conversation history endpoint as soon as an agent leaves the channel, archiving transcripts for review. Because the same endpoint works against live and finished agents, monitoring tools can poll it to provide near-real-time supervisor dashboards.

GET /api/conversational-ai-agent/v2/projects/{appid}/agents/{agentId}/history and store the transcript for review

AI Agent Voice Operations via Jentic

An orchestrating agent built on Jentic can launch, supervise, and retire Agora voice agents based on natural-language operator commands. Jentic stores the App ID and secret in its vault and applies HTTP Basic at request time, so the credentials never sit in the agent's working memory.

Use Jentic to search 'start an Agora conversational agent', execute the join, then call interrupt when a human joins

Key Endpoints

8 endpoints — jentic publishes the only available openapi specification for agora conversational ai api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/api/conversational-ai-agent/v2/projects/{appid}/join

Start a conversational AI agent

POST

/api/conversational-ai-agent/v2/projects/{appid}/agents/{agentId}/leave

Stop a running agent

GET

/api/conversational-ai-agent/v2/projects/{appid}/agents/{agentId}

Query agent status

GET

/api/conversational-ai-agent/v2/projects/{appid}/agents

List active agents

POST

/api/conversational-ai-agent/v2/projects/{appid}/agents/{agentId}/update

Update agent configuration

POST

/api/conversational-ai-agent/v2/projects/{appid}/agents/{agentId}/speak

Broadcast TTS through the agent

POST

/api/conversational-ai-agent/v2/projects/{appid}/agents/{agentId}/interrupt

Interrupt agent speech

GET

/api/conversational-ai-agent/v2/projects/{appid}/agents/{agentId}/history

Retrieve conversation history

POST

/api/conversational-ai-agent/v2/projects/{appid}/join

Start a conversational AI agent

POST

/api/conversational-ai-agent/v2/projects/{appid}/agents/{agentId}/leave

Stop a running agent

GET

/api/conversational-ai-agent/v2/projects/{appid}/agents/{agentId}

Query agent status

GET

/api/conversational-ai-agent/v2/projects/{appid}/agents

List active agents

POST

/api/conversational-ai-agent/v2/projects/{appid}/agents/{agentId}/update

Update agent configuration

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Agora's App ID and Customer Secret are stored in Jentic's vault and combined into the HTTP Basic Authorization header at execution time. Agents never see the raw credentials, so leaked transcripts cannot be replayed.

Intent-based discovery

Agents search by intent (e.g. 'start a conversational AI agent in an Agora channel') and Jentic returns the join, leave, speak, and interrupt operations along with their input schemas.

Time to first call

Direct integration: 2-3 days to wire HTTP Basic auth, lifecycle calls, and history pulls. Through Jentic: under an hour — search, load schema, execute the join, then control.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Twilio

Programmable voice and messaging platform with media streams that can pipe audio to AI services

Choose Twilio when you want to build the ASR/LLM/TTS loop yourself over a PSTN or voice channel rather than use a turnkey agent.

Complementary

OpenAI

LLM and Realtime audio APIs that can power the language layer of an Agora agent

Pair with Agora's voice transport when you want to bring your own LLM and Realtime audio model rather than the bundled providers.

Complementary

Anthropic Messages

Claude messages API for the LLM behind a conversational voice agent

Use as the LLM provider for the conversation when Claude reasoning is preferred.

Alternative

Zoom Meetings

Video conferencing platform with bot SDKs for joining meetings programmatically

Choose Zoom Meetings when the conversation must occur in a Zoom meeting rather than an Agora RTC channel.

FAQs

Specific to using Agora Conversational AI API API through Jentic.

Why is there no official OpenAPI spec for Agora Conversational AI API?

Agora does not publish an OpenAPI specification for the Conversational AI surface. Jentic generates and maintains this spec so that AI agents and developers can call the Agora Conversational AI API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Agora Conversational AI API use?

HTTP Basic authentication using your Agora App ID and Customer Secret. Through Jentic, both values are stored in the credential vault and combined into the Authorization header at request time, so the agent never sees the raw secret.

How do I start a voice AI agent in an Agora channel?

Call POST /api/conversational-ai-agent/v2/projects/{appid}/join with the channel name, LLM provider configuration, ASR settings, and TTS voice. The response returns an agentId you use for all subsequent control calls.

Can I interrupt the agent while it is speaking?

Yes. POST /api/conversational-ai-agent/v2/projects/{appid}/agents/{agentId}/interrupt cuts the current TTS playback so a human or another speaker can take the floor. The agent stays joined to the channel and can resume speaking on the next /speak call.

How do I stop an Agora conversational agent through Jentic?

Search Jentic for 'stop an Agora conversational agent', load the POST /api/conversational-ai-agent/v2/projects/{appid}/agents/{agentId}/leave schema, and execute it with the project App ID and the agent ID returned by the original join call.

What are the rate limits for the Agora Conversational AI API?

The OpenAPI spec does not declare explicit per-second limits. Concurrency is bounded by your Agora project's allowance for active conversational agents — list active agents via GET /api/conversational-ai-agent/v2/projects/{appid}/agents to monitor utilisation.