Agora Conversational AI Engine

Overview

Best for: Apps already on Agora RTC (including Asia-Pacific audiences) that want a single per-minute price including models.

At a glance

$0.10/min includes select managed ASR/LLM/TTS; same price with your own keys. First 300 minutes free. Plus $0.00099/min RTC per user.

Features

• managed ASR/LLM/TTS bundle
• BYO LLM endpoint (OpenAI-compatible URL)
• interruption handling
• telephony
• avatars (separate)
• Agent Studio no-code

Pricing

Free tier: First 300 minutes free.

Source: docs.agora.io

Setup

1. Create an Agora project (App ID + certificate) and enable Conversational AI in the console.
2. Have your client app join an RTC channel with a token.
3. POST to the join endpoint with channel, agent token, UIDs and asr/llm/tts config; store the returned agent_id.
4. Call the leave endpoint with agent_id when done (idle_timeout also stops it).

Endpoint

POST https://api.agora.io/api/conversational-ai-agent/v2/projects/{appid}/join

Authentication

HTTP Basic (base64 of Customer ID:Customer Secret)

// Start an Agora Conversational AI agent in an existing RTC channel (Node 18+)
const appId = process.env.AGORA_APP_ID;
const basic = Buffer.from(process.env.AGORA_CUSTOMER_ID + ":" + process.env.AGORA_CUSTOMER_SECRET).toString("base64");

const res = await fetch("https://api.agora.io/api/conversational-ai-agent/v2/projects/" + appId + "/join", {
  method: "POST",
  headers: { Authorization: "Basic " + basic, "Content-Type": "application/json" },
  body: JSON.stringify({
    name: "support-agent-" + Date.now(),
    properties: {
      channel: "room-123",
      token: process.env.AGENT_RTC_TOKEN,
      agent_rtc_uid: "0",
      remote_rtc_uids: ["1002"],
      idle_timeout: 120,
      // asr / llm / tts blocks: use credential_mode "managed" for Agora-billed models,
      // or vendor + your own key. See the join API reference for field names per vendor.
      llm: { system_messages: [{ role: "system", content: "You are a helpful voice assistant." }],
             greeting_message: "Hi! How can I help?" }
    }
  })
});
console.log(await res.json()); // { agent_id, create_ts, status: "RUNNING" }

Written from the current docs. Check the vendor's SDK version before you ship.

Warnings

Plus 12 warnings that apply to all platforms and telephony APIs. See category warnings.

Limits

• Concurrency limits not published in sources reviewed
• Managed-model list is limited; others need BYOK or BYOM (sales)

Models and products

Docs and sources

Docs

• Pricing doc
• Pricing page
• Join API

Sources used

• docs.agora.io/en/conversational-ai/overview/pricing
• agora.io/en/pricing/agora-conversational-ai-platform
• docs.agora.io/en/conversational-ai/rest-api/agent/join