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

# Agent overview

Agent lets you build a real-time character just by chatting. Tell it what kind of character you want, or pick a template, and it creates the look, the voice, the personality, and the way the character moves. You can try the character right away, keep adjusting it in the same chat, and share it with a link when it's ready.

<Note>
  Agent isn't enabled on every account yet. If you don't see **Agents** in the left navigation of [platform.vivix.ai](https://platform.vivix.ai), contact us to get access.
</Note>

## How it works

<Steps>
  <Step title="Create a character">
    Pick a [template](/agent/create-character/from-template) to get a ready-made character in one click, or [start from scratch](/agent/create-character/from-scratch) and describe the character you have in mind.

    <Frame caption="Describe a character in the message box, or pick a template below it.">
      <img src="https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/agent-home-v2.webp?fit=max&auto=format&n=BgA5EDt1AAw3iK5a&q=85&s=c6e5c57feb7914555f46e0cfec7e41b1" alt="Agent home page with a message box and a row of template cards" width="1751" height="1246" data-path="images/agent/agent-home-v2.webp" />
    </Frame>
  </Step>

  <Step title="Refine it in the chat">
    Ask for changes the way you'd explain them to a person: a different look or voice, a new personality, a gesture, a song and dance, or a mini game to play with viewers. You can attach reference images, product photos, or audio recordings.
  </Step>

  <Step title="Try it in the live preview">
    Open the **Live preview** panel and click **Talk to character** to have a real-time conversation. Click the red **End session** button at the top left of the panel when you're done.
  </Step>

  <Step title="Share it">
    Click **Share** at the top of the preview panel. **Copy link** publishes the character as its own page and copies the link. **Share to community** also lists it publicly under a name you choose.

    <Frame caption="A shared character page. Visitors click Talk to character to start a conversation.">
      <img src="https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/character-page-toffee-v2.webp?fit=max&auto=format&n=BgA5EDt1AAw3iK5a&q=85&s=e8419bdef04a779fe5d36c73cc2135a7" alt="Shared character page for Toffee with a Talk to character button" width="1800" height="1068" data-path="images/agent/character-page-toffee-v2.webp" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Talking to a character uses credits, the same as any other live session. Opening the preview panel on its own doesn't.
</Warning>

## Give your character an app

A character can do more than talk. Ask for an app, such as a card game, a quiz, or a product list, and it appears next to the character. Viewers can click around in it, and the character can use it too: it deals the cards, moves to the next question, or presents the product a viewer picked, and it reacts to what viewers do.

```text wrap theme={null}
Add a quiz next to the character with a question, four answer buttons, and a score. The character reads each question aloud, reveals the answer after the viewer picks one, and updates the score.
```

The Vespera template shows how this feels: she chats with the player while dealing blackjack at the table next to her. To build your own, see [Build an app the character can use](/agent/capabilities/app).

<Frame caption="Vespera and her blackjack table on the same page.">
  <img src="https://mintcdn.com/vivix-20d305ce/CoRu-ped4TmOlrpe/images/agent/app-vespera-v3.webp?fit=max&auto=format&n=CoRu-ped4TmOlrpe&q=85&s=b94b19d6e43f2165e4e728477fc13a9e" alt="Vespera's character page with a blackjack table next to the character" width="1782" height="1276" data-path="images/agent/app-vespera-v3.webp" />
</Frame>

## Where to go next

<Columns cols={2}>
  <Card title={"Create a character"} href={"/agent/create-character/from-template"}>
    Start from a template, or describe a new character from scratch.
  </Card>

  <Card title={"Build an app the character can use"} href={"/agent/capabilities/app"}>
    Add a game, a product list, or another interactive panel the character can use.
  </Card>

  <Card title={"Perform specific content"} href={"/agent/capabilities/performance"}>
    Have the character deliver lines, songs, or dances exactly the way you planned.
  </Card>

  <Card title={"Streaming Avatar API"} href={"/streaming-avatar/overview"}>
    Prefer to build it into your own product? Use the API instead.
  </Card>
</Columns>

## Terms used in these guides

| Term | Meaning |
| - | - |
| Project | One character you're working on, with its own chat and saved versions. |
| Live preview | The panel next to the chat where you talk to the latest version of your character. |
| App | An interactive panel next to the character, such as a mini game or a product list, that viewers and the character can both use. |
| Performance | Content the character delivers the same way every time, such as a greeting with a wave or a song with a dance. |
| Share | Turns the current version into a character page that others can open and talk to. |