Agora Convo AI Agent

Prepare RTC tokens

Generate Agora RTC tokens on your backend with the App Certificate. Use a distinct UID and token for each participant:

Token	Where it is used
Agent RTC token	Used by the Convo AI agent so it can join the Agora channel.
Avatar RTC token	`properties.avatar.params.agora_token` so Motion Server can publish avatar output into the same channel.
Client RTC token	Passed to the Web, iOS, or Android client so the user can join the same channel.

Use distinct Agora UIDs for the user, the Convo AI agent, and the Spatius avatar publisher. Do not reuse the avatar publisher UID as a client UID.

Spatius avatar provider

Get the App ID and API Key from Apps (Developer → API Key) and the Avatar ID from the Avatar Library. Keep the API Key in the server-side agent configuration. Add properties.avatar to the Convo AI agent configuration:

{
  "properties": {
    "channel": "room-a",
    "avatar": {
      "enable": true,
      "vendor": "spatius",
      "params": {
        "spatius_api_key": "${SPATIUS_API_KEY}",
        "spatius_app_id": "${SPATIUS_APP_ID}",
        "spatius_avatar_id": "${SPATIUS_AVATAR_ID}",
        "agora_uid": "77777",
        "agora_token": "avatar-rtc-token",
        "region": "us-west",
        "sample_rate": 24000,
        "session_expire_minutes": 30
      }
    }
  }
}

Replace the ${SPATIUS_*} placeholders in your server code before submitting the request. The publisher token must match agora_uid and properties.channel; sample_rate must match the agent’s TTS output. See Regions and Audio for the optional region and audio settings. After the start-agent request succeeds, return the Spatius App ID, Avatar ID, Agora App ID, channel, client UID, and client RTC token to your app. Never return the Spatius API Key or Agora App Certificate.

Start Here

Quickstarts

Integrations

Concepts

Examples & Support

Agora Convo AI Agent

Prepare RTC tokens

Spatius avatar provider

Next steps

Client

Audio

​Prepare RTC tokens

​Spatius avatar provider

​Next steps

Client

Audio

Prepare RTC tokens

Spatius avatar provider

Next steps