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.
Agent isn’t enabled on every account yet. If you don’t see Agents in the left navigation of platform.vivix.ai, contact us to get access.
How it works
1
Create a character
Pick a template to get a ready-made character in one click, or start from scratch and describe the character you have in mind.
Describe a character in the message box, or pick a template below it.
2
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.
3
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.
4
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.
A shared character page. Visitors click Talk to character to start a conversation.
Anyone with the link can open the page, start a conversation, and click Remix to copy the character into their own workspace as a new project they can edit. Remix asks the visitor to sign in first. Sharing publishes the version as it is at that moment; your later edits stay in your workspace until you share again.
Talking to a character uses credits, the same as any other live session. Opening the preview panel on its own doesn’t.
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.
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.
Vespera and her blackjack table on the same page.
Where to go next
Create a character
Start from a template, or describe a new character from scratch.
Build an app the character can use
Add a game, a product list, or another interactive panel the character can use.
Perform specific content
Have the character deliver lines, songs, or dances exactly the way you planned.
Streaming Avatar API
Prefer to build it into your own product? Use the API instead.
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.
Game preview
The card in the chat that opens an app on its own, without starting a conversation. The name comes from the first apps the feature supported; it covers quizzes, product lists, and other interactive panels too.
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Vivix API Platform","description":"Build real-time interactive avatars, worlds, and blazing fast video generation with the Vivix API.","colors":{"primary":"#202124","light":"#E8EAED","dark":"#202124"},"logo":{"light":"https://mintcdn.com/vivix-20d305ce/_pH0P9NPGXmrYjpb/logo/light.svg?fit=max\u0026auto=format\u0026n=_pH0P9NPGXmrYjpb\u0026q=85\u0026s=baf0ff5242cbe15c7109578472ce97da","dark":"https://mintcdn.com/vivix-20d305ce/_pH0P9NPGXmrYjpb/logo/dark.svg?fit=max\u0026auto=format\u0026n=_pH0P9NPGXmrYjpb\u0026q=85\u0026s=589e9a9cf678ffb3e4d02b257709d2b2","href":"https://platform.vivix.ai"},"favicon":"https://mintcdn.com/vivix-20d305ce/_pH0P9NPGXmrYjpb/favicon.png?fit=max\u0026auto=format\u0026n=_pH0P9NPGXmrYjpb\u0026q=85\u0026s=5c253eff0d790be37c1e534f29b580b0","appearance":{"default":"light","strict":true},"background":{"color":{"light":"#F9F6F4","dark":"#141413"}},"navbar":{"primary":{"type":"button","label":"Developer Platform","href":"https://platform.vivix.ai"}},"seo":{"indexing":"navigable"},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vivix-20d305ce","hasAudioNarration":false,"actualSubdomain":"vivix-20d305ce","customDomains":["docs.vivix.ai"],"gitSource":{"type":"gitlab","owner":"vivix-labs","repo":"vivix-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"projectId":689,"hostUrl":"https://gitlab.vivix.work","mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6af736e036896a78e7f6275c","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API","count":73},{"language":"default","tag":"A1: Streaming Avatar","count":64},{"language":"default","tag":"API reference","count":45},{"language":"default","tag":"Server events","count":22},{"language":"default","tag":"Client events","count":8},{"language":"default","tag":"Integrate your app","count":7},{"language":"default","tag":"Agent","count":5},{"language":"default","tag":"Characters","count":5},{"language":"default","tag":"Sessions","count":5},{"language":"default","tag":"Voices","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--vivix-bg: #f9f6f4;--vivix-active: #e9e5e0;--vivix-line: #ddd8d3;--vivix-ink: #313131;--vivix-muted: #70757d;--vivix-note-bg: #f6f6f6}#sidebar-content li[data-active]>a{background-color:var(--vivix-active)!important;color:#202124!important}.callout[data-callout-type=\"note\"]{background-color:var(--vivix-note-bg)!important;border:0!important;border-left:3px solid var(--vivix-muted)!important;border-radius:6px!important}.callout[data-callout-type=\"note\"] [data-component-part=\"callout-content\"],.callout[data-callout-type=\"note\"] [data-component-part=\"callout-icon\"] svg{color:var(--vivix-ink)!important}#navbar{background-color:var(--vivix-bg);border-color:var(--vivix-line)}.columns>div>figure[data-name=\"frame\"]{height:100%}#w1-reference-pricing-note{background-color:#f0ece8;border-left:3px solid #b6aba0;border-radius:6px;padding:10px 14px;color:#5f6368;font-size:14px;line-height:1.5}#w1-reference-pricing-note strong{color:var(--vivix-ink);font-weight:600}.persona-map{display:grid;grid-template-columns:repeat(2, minmax(0, 1fr));gap:16px;margin:28px 0 36px;color:#313131;font-size:13px;line-height:1.5}.persona-group-label{grid-column:1 / -1;color:#61716a;font-size:12px;font-weight:600}.persona-group-label:not(:first-child){margin-top:8px}.persona-speech{grid-column:1 / -1}.persona-outcome{display:flex;flex-direction:column;padding:20px;border:1px solid #ddd8d3;border-radius:16px;background:#f5f1ed}.persona-inputs{display:grid;grid-template-columns:repeat(2, minmax(0, 1fr));gap:20px}.persona-inputs a,.persona-single-input{display:flex;flex-direction:column;gap:6px;text-decoration:none!important;border-bottom:0!important;color:#313131!important;font-weight:400}.persona-inputs a:hover .persona-module-title,.persona-single-input:hover .persona-module-title{text-decoration:underline}.persona-inputs a:focus-visible,.persona-single-input:focus-visible{outline:2px solid #617d79;outline-offset:4px;border-radius:3px}.persona-module-title{font-size:15px;line-height:1.4;font-weight:700}.persona-connector{margin:16px 0;text-align:center;color:#7b9788;font-size:23px;line-height:1}.persona-dialogue-scene{display:grid;grid-template-columns:1fr 1fr;gap:20px;align-items:center}.persona-speech-example{display:flex;flex-direction:column;gap:12px}.persona-viewer{color:#61716a;font-size:13px}.persona-reply{padding:14px 16px;border-radius:14px 14px 14px 3px;background:#fffaf5;border:1px solid #ddd8d3;font-size:15px;line-height:1.5}.persona-scene-caption{margin-top:12px;color:#576962;font-size:13px;line-height:1.6}.persona-map .persona-behavior-scene{width:100%;height:auto;margin:0}.persona-scene-labels{display:grid;grid-template-columns:1fr 1fr;gap:12px;margin-top:12px;color:#576962;font-size:13px;text-align:center}@media (max-width: 540px){.persona-map,.persona-inputs,.persona-dialogue-scene{grid-template-columns:minmax(0, 1fr)}.persona-speech,.persona-group-label{grid-column:1}.persona-dialogue-scene{gap:12px}}"}],"page":{"pagePath":"agent/overview","slug":"/agent/overview","pageMetadata":{"title":"Agent overview","sidebarTitle":"Overview","description":null,"href":"/agent/overview"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,CodeBlock,Columns,Frame,Heading,Note,OptimizedImage,Step,Steps,Table,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Agent isn’t enabled on every account yet. If you don’t see `,_jsx(_components.strong,{children:`Agents`}),` in the left navigation of `,_jsx(_components.a,{href:`https://platform.vivix.ai`,children:`platform.vivix.ai`}),`, contact us to get access.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`how-it-works`,children:`How it works`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Create a character`,children:[_jsxs(_components.p,{children:[`Pick a `,_jsx(_components.a,{href:`/agent/create-character/from-template`,children:`template`}),` to get a ready-made character in one click, or `,_jsx(_components.a,{href:`/agent/create-character/from-scratch`,children:`start from scratch`}),` and describe the character you have in mind.`]}),_jsx(Frame,{caption:`Describe a character in the message box, or pick a template below it.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/agent-home-v2.webp?fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=c6e5c57feb7914555f46e0cfec7e41b1`,alt:`Agent home page with a message box and a row of template cards`,\"data-og-width\":`1751`,width:`1751`,\"data-og-height\":`1246`,height:`1246`,\"data-path\":`images/agent/agent-home-v2.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/agent-home-v2.webp?w=280\u0026fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=8e390ecb98135c9ebc6a74e57caf0688 280w, https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/agent-home-v2.webp?w=560\u0026fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=43e41b37ab68e06da794cc2fe6e96447 560w, https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/agent-home-v2.webp?w=840\u0026fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=1aa12c17b76ffbbabbaa35a098ce9fec 840w, https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/agent-home-v2.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=b0fa4d3998f790fa75973284a404761d 1100w, https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/agent-home-v2.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=807b97ba1189b94e42451a232836d4d5 1650w, https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/agent-home-v2.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=56cbc74ac912f8c99d064c4f67f2fc12 2500w`})})]}),_jsx(Step,{title:`Refine it in the chat`,children:_jsx(_components.p,{children:`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.`})}),_jsx(Step,{title:`Try it in the live preview`,children:_jsxs(_components.p,{children:[`Open the `,_jsx(_components.strong,{children:`Live preview`}),` panel and click `,_jsx(_components.strong,{children:`Talk to character`}),` to have a real-time conversation. Click the red `,_jsx(_components.strong,{children:`End session`}),` button at the top left of the panel when you’re done.`]})}),_jsxs(Step,{title:`Share it`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Share`}),` at the top of the preview panel. `,_jsx(_components.strong,{children:`Copy link`}),` publishes the character as its own page and copies the link. `,_jsx(_components.strong,{children:`Share to community`}),` also lists it publicly under a name you choose.`]}),_jsx(Frame,{caption:`A shared character page. Visitors click Talk to character to start a conversation.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/character-page-toffee-v2.webp?fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=e8419bdef04a779fe5d36c73cc2135a7`,alt:`Shared character page for Toffee with a Talk to character button`,\"data-og-width\":`1800`,width:`1800`,\"data-og-height\":`1068`,height:`1068`,\"data-path\":`images/agent/character-page-toffee-v2.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/character-page-toffee-v2.webp?w=280\u0026fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=763e3fe61d3cfd00041c9ea910a013e4 280w, https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/character-page-toffee-v2.webp?w=560\u0026fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=9e1d0b76983844a6ae71403e45e45467 560w, https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/character-page-toffee-v2.webp?w=840\u0026fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=8877b3b957dc505e9c2aa6fe1ac46490 840w, https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/character-page-toffee-v2.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=ad5fc717a540813f0736d1585c04a716 1100w, https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/character-page-toffee-v2.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=c1a2c34039e44af9627a206469c6429c 1650w, https://mintcdn.com/vivix-20d305ce/BgA5EDt1AAw3iK5a/images/agent/character-page-toffee-v2.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=BgA5EDt1AAw3iK5a\u0026q=85\u0026s=44fd7778e52f40bd2b50933e6e0e8e0f 2500w`})}),_jsxs(_components.p,{children:[`Anyone with the link can open the page, start a conversation, and click `,_jsx(_components.strong,{children:`Remix`}),` to copy the character into their own workspace as a new project they can edit. Remix asks the visitor to sign in first. Sharing publishes the version as it is at that moment; your later edits stay in your workspace until you share again.`]})]})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Talking to a character uses credits, the same as any other live session. Opening the preview panel on its own doesn’t.`})}),`\n`,_jsx(Heading,{level:`2`,id:`give-your-character-an-app`,children:`Give your character an app`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(CodeBlock,{filename:``,wrap:`true`,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`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.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`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 `,_jsx(_components.a,{href:`/agent/capabilities/app`,children:`Build an app the character can use`}),`.`]}),`\n`,_jsx(Frame,{caption:`Vespera and her blackjack table on the same page.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/vivix-20d305ce/CoRu-ped4TmOlrpe/images/agent/app-vespera-v3.webp?fit=max\u0026auto=format\u0026n=CoRu-ped4TmOlrpe\u0026q=85\u0026s=b94b19d6e43f2165e4e728477fc13a9e`,alt:`Vespera's character page with a blackjack table next to the character`,\"data-og-width\":`1782`,width:`1782`,\"data-og-height\":`1276`,height:`1276`,\"data-path\":`images/agent/app-vespera-v3.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/vivix-20d305ce/CoRu-ped4TmOlrpe/images/agent/app-vespera-v3.webp?w=280\u0026fit=max\u0026auto=format\u0026n=CoRu-ped4TmOlrpe\u0026q=85\u0026s=addfa5e4a2dadcf7d60967107d48a29a 280w, https://mintcdn.com/vivix-20d305ce/CoRu-ped4TmOlrpe/images/agent/app-vespera-v3.webp?w=560\u0026fit=max\u0026auto=format\u0026n=CoRu-ped4TmOlrpe\u0026q=85\u0026s=c3eebe37c713bfbcf0147e8f77d8fdb8 560w, https://mintcdn.com/vivix-20d305ce/CoRu-ped4TmOlrpe/images/agent/app-vespera-v3.webp?w=840\u0026fit=max\u0026auto=format\u0026n=CoRu-ped4TmOlrpe\u0026q=85\u0026s=2f9e564b8eef9b6911a91a908e87865e 840w, https://mintcdn.com/vivix-20d305ce/CoRu-ped4TmOlrpe/images/agent/app-vespera-v3.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=CoRu-ped4TmOlrpe\u0026q=85\u0026s=f9fd93dbc9039386c904c5a175507300 1100w, https://mintcdn.com/vivix-20d305ce/CoRu-ped4TmOlrpe/images/agent/app-vespera-v3.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=CoRu-ped4TmOlrpe\u0026q=85\u0026s=d72bd8a74cbe32775a21e89166a322e0 1650w, https://mintcdn.com/vivix-20d305ce/CoRu-ped4TmOlrpe/images/agent/app-vespera-v3.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=CoRu-ped4TmOlrpe\u0026q=85\u0026s=fceeb8f129f457d8fd9dc8b406c890d1 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`where-to-go-next`,children:`Where to go next`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Create a character`,href:`/agent/create-character/from-template`,children:_jsx(_components.p,{children:`Start from a template, or describe a new character from scratch.`})}),_jsx(Card,{title:`Build an app the character can use`,href:`/agent/capabilities/app`,children:_jsx(_components.p,{children:`Add a game, a product list, or another interactive panel the character can use.`})}),_jsx(Card,{title:`Perform specific content`,href:`/agent/capabilities/performance`,children:_jsx(_components.p,{children:`Have the character deliver lines, songs, or dances exactly the way you planned.`})}),_jsx(Card,{title:`Streaming Avatar API`,href:`/streaming-avatar/overview`,children:_jsx(_components.p,{children:`Prefer to build it into your own product? Use the API instead.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`terms-used-in-these-guides`,children:`Terms used in these guides`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Term`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Project`}),_jsx(_components.td,{children:`One character you’re working on, with its own chat and saved versions.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Live preview`}),_jsx(_components.td,{children:`The panel next to the chat where you talk to the latest version of your character.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Game preview`}),_jsx(_components.td,{children:`The card in the chat that opens an app on its own, without starting a conversation. The name comes from the first apps the feature supported; it covers quizzes, product lists, and other interactive panels too.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`App`}),_jsx(_components.td,{children:`An interactive panel next to the character, such as a mini game or a product list, that viewers and the character can both use.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Performance`}),_jsx(_components.td,{children:`Content the character delivers the same way every time, such as a greeting with a wave or a song with a dance.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Share`}),_jsx(_components.td,{children:`Turns the current version into a character page that others can open and talk to.`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Agent overview","sidebarTitle":"Overview","description":null,"href":"/agent/overview"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"How it works","slug":"how-it-works","depth":2,"children":[]},{"title":"Give your character an app","slug":"give-your-character-an-app","depth":2,"children":[]},{"title":"Where to go next","slug":"where-to-go-next","depth":2,"children":[]},{"title":"Terms used in these guides","slug":"terms-used-in-these-guides","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"vivix-20d305ce","siteName":"Vivix API Platform","title":"Agent overview - Vivix API Platform","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T16:37:25.207Z","originalFileLocation":"agent/overview.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Vivix API Platform\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vivix-20d305ce/4XVG5hka1siEhate/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/vivix-20d305ce/4XVG5hka1siEhate/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vivix-20d305ce/4XVG5hka1siEhate/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/vivix-20d305ce/4XVG5hka1siEhate/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/vivix-20d305ce/4XVG5hka1siEhate/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vivix-20d305ce/4XVG5hka1siEhate/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vivix-20d305ce/4XVG5hka1siEhate/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/vivix-20d305ce/4XVG5hka1siEhate/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/vivix-20d305ce/4XVG5hka1siEhate/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agent overview - Vivix API Platform\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vivix API Platform\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vivix.ai/agent/overview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vivix-20d305ce.mintlify.site/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Agent+overview\u0026amp;theme=c0ba66fadb8405a2f081edcf\u0026amp;signature=1f90d3d386a2a2c013b3d048af6ef805d3708f61141978bf6122ac0f3a8a645a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Agent overview - Vivix API Platform\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vivix-20d305ce.mintlify.site/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Agent+overview\u0026amp;theme=c0ba66fadb8405a2f081edcf\u0026amp;signature=1f90d3d386a2a2c013b3d048af6ef805d3708f61141978bf6122ac0f3a8a645a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/vivix-20d305ce/4XVG5hka1siEhate/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vivix API Platform\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#202124\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vivix.ai/agent/overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/agent/overview.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vivix.ai/#organization\",\"name\":\"Vivix API Platform\",\"url\":\"https://docs.vivix.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vivix-20d305ce/_pH0P9NPGXmrYjpb/logo/light.svg?fit=max\u0026auto=format\u0026n=_pH0P9NPGXmrYjpb\u0026q=85\u0026s=baf0ff5242cbe15c7109578472ce97da\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vivix.ai#website\",\"name\":\"Vivix API Platform\",\"url\":\"https://docs.vivix.ai\",\"publisher\":{\"@id\":\"https://docs.vivix.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vivix.ai/agent/overview#webpage\",\"url\":\"https://docs.vivix.ai/agent/overview\",\"name\":\"Agent overview\",\"dateModified\":\"2026-11-06T16:37:25.207Z\",\"isPartOf\":{\"@id\":\"https://docs.vivix.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vivix.ai/agent/overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vivix.ai/agent/overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Vivix API Platform\",\"item\":\"https://docs.vivix.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agent overview\",\"item\":\"https://docs.vivix.ai/agent/overview\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.vivix.ai/agent/overview#article\",\"headline\":\"Agent overview\",\"name\":\"Agent overview\",\"url\":\"https://docs.vivix.ai/agent/overview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vivix.ai/agent/overview#webpage\"},\"dateModified\":\"2026-11-06T16:37:25.207Z\",\"publisher\":{\"@id\":\"https://docs.vivix.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vivix.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vivix API Platform\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Vivix API Platform\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/agent/overview.md","siteName":"Vivix API Platform","nav":{"global":null,"tabs":[{"tab":"API","icon":"code","pages":[{"title":"API","href":"/overview/introduction"}]},{"tab":"Agent","icon":"robot","groups":[{"group":"Get started","pages":[{"title":"Agent overview","sidebarTitle":"Overview","href":"/agent/overview"}]},{"group":"Create a character","pages":[{"title":"Start from a template","description":null,"href":"/agent/create-character/from-template"},{"title":"Start from scratch","href":"/agent/create-character/from-scratch"}]},{"group":"Character capabilities","pages":[{"title":"Build an app the character can use","sidebarTitle":"Build an app","href":"/agent/capabilities/app"},{"title":"Perform specific content","sidebarTitle":"Perform specific content","href":"/agent/capabilities/performance"}]}]}]},"basePath":"","title":"Agent overview - Vivix API Platform","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D2acuaLg.js","DynamicMarkdown-Co5nikxh.js","zoom-image-lightbox-BbK2OBGL.js","lightbox-handle-r17bVUz3.js"]}
