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

# Live avatar

> Prepare an avatar presentation layer with separate session ownership, media contracts, interruption, and cleanup requirements.

Design an avatar as a presentation layer around a conversation. Decide who produces speech, who renders video, and who owns each session before selecting a vendor mode.

<Note>
  Threetone has no verified native avatar adapter or working avatar conversation runtime. Vendor session APIs do not remove Threetone's execution gate. This cookbook produces an integration design and independent media test plan.
</Note>

## Before you begin

Have permission to use the selected avatar assets, an approved vendor account, a backend owner, and a clear policy for audio, video, and transcript handling. Use synthetic text or approved sample audio for preparation.

<Steps>
  <Step title="Assign media and conversation responsibilities" id="avatar-cookbook-ownership">
    Record which service owns recognition, responses, speech generation, rendering, and playback. As one vendor example, [LiveAvatar's LITE lifecycle](https://docs.liveavatar.com/docs/lite-mode/lifecycle) expects an external speech pipeline and renders its audio as video. That mode's contract is not a Threetone integration.
  </Step>

  <Step title="Separate credentials and session identifiers" id="avatar-cookbook-credentials">
    Review the vendor's [session-token contract](https://docs.liveavatar.com/api-reference/sessions/create-session-token). Keep the vendor API key on your backend. Authorize each user before issuing permitted session access, and map application and vendor session IDs explicitly. Never substitute a vendor token for a Threetone credential.
  </Step>

  <Step title="Review audio and interruption behavior" id="avatar-cookbook-media">
    Verify the vendor's required encoding, sample rate, and chunk limits rather than forwarding arbitrary audio. Define how cancellation stops both speech generation and queued playback. Correlate utterances so late chunks from a previous response cannot make the avatar speak after interruption.
  </Step>

  <Step title="Plan disconnect and cleanup" id="avatar-cookbook-cleanup">
    Distinguish transport reconnection from creating another billable session. Inspect uncertain start outcomes before repeating them. On user exit or unrecoverable failure, stop the vendor session through its [documented lifecycle](https://docs.liveavatar.com/api-reference/sessions/stop-session), release media resources, and clear pending audio.
  </Step>
</Steps>

Keep a text alternative and visible disconnected state. Review [privacy boundaries](/agents-platform/monitor/privacy/overview) for every service receiving media. Threetone's stored retention settings do not guarantee deletion of vendor copies.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I paste an avatar endpoint into agent configuration?" id="faq-avatar-cookbook-endpoint">There is no verified avatar configuration field or adapter. The integration needs a released transport and an implemented application boundary.</Accordion>
  <Accordion title="Does a vendor-only demo prove the Threetone integration works?" id="faq-avatar-cookbook-demo">No. It verifies the tested vendor media path. Threetone session initiation and the complete conversation path require separate release and verification.</Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.