> ## Documentation Index
> Fetch the complete documentation index at: https://opinionai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Setup Your First Agent
> Setup your first agent guide
# Setup Your First Agent
Build your first AIVAH agent in five short steps. This walkthrough mirrors the live product flow: create an agent, give it a face and a voice, test it in the Playground, share it publicly, and wire it up to your tools.
## Step 1: Create Your Agent
Open **Agents** in the side navigation (`/agents`) and click the **+** button to start a fresh agent at `/agents/create`.
### Configure the basics
* **Name** – becomes the slug shown next to the heading (`@my-agent`).
* **Agent Capabilities → Presenter** – leave **off** for a knowledge-base agent that accepts URLs, files, and text. Turn **on** for a presenter that takes a single PDF or video and produces slide-aligned answers with a built-in **Quiz** overlay.
* **Agent Prompt** – freeform instructions that shape behaviour.
* **Persona** – a short label of your agent's tone (for example *witty and casual*).
### Add knowledge content
Click **Add document** to attach knowledge sources. Knowledge-base agents accept any mix of URL / Files / Text; presenter agents accept a single PDF or video.
Paste any publicly accessible link – website pages, blog posts, YouTube/Vimeo videos, or documentation. Aivah fetches and indexes the page automatically.
Drag-and-drop or pick files (up to 21 MB each). Supported types include `.pdf`, `.docx`, `.txt`, `.csv`, `.xlsx`, `.html`, `.md`, `.epub`, `.json`, `.xml`, `.mp4`, `.mp3`, `.jpg`, `.png`.
Paste raw text content – ideal for FAQs, policies, or short snippets.
Presenter agents accept only a single PDF or a single video at a time. Delete the existing file to replace the deck.
### Finalise
Click **Create Agent**. The agent enters `processing`, you're redirected to the agents list, and Aivah polls every few seconds until the status flips to `completed`. If a single source fails, open the agent detail view and hit the inline refresh on just that item.
***
## Step 2: Pick a Persona – Avatar, Character, and Voice
Aivah keeps everything visual in one workspace: `Side nav → Customization`.
### Avatars (3D)
Browse the full Ready Player Me-based avatar library and set defaults from `Customization → Avatars`.
For step-by-step avatar creation, see [Create Avatar](/avatars/create-avatar).
### Characters (2D)
Characters are lightweight image-based personas – upload a photo, crop it, name it, and it's instantly selectable everywhere a character can be picked.
Open `Customization → Characters` and pick a photo. JPG, PNG, and WEBP are supported.
The **Crop Character Image** modal opens. Pick an aspect ratio (1:1, 3:4, 4:5, or Custom), name the character, then save.
The pencil icon reopens an Edit modal where you can change the name, **Agent Prompt**, and **Agent Idle Prompt** that describe how the character behaves when speaking or idle.
### Voices
`Customization → Voices` lists every built-in voice plus any clones you've made. Click **+ Create** to add your own.
Click **+ Create** to launch the dialog.
Choose from English, French, German, Spanish, Portuguese, and more.
Use **Upload File** for a clean mono recording (up to 10 MB) or **Record Audio** in the browser (up to 1 minute).
Click **Add to my voice**. Once processed, the voice appears wherever voices can be picked.
***
## Step 3: Test in the Playground
Open the **Chat** workspace from the side navigation. New chats start at `/new-playground/new-chat`; existing conversations live at `/{conversationId}/chat` and `/{conversationId}/avatar-chat`.
### Configure the conversation from the composer pills
Every important option is one click away from the composer:
### Try the three modes
Type your message, attach files with the paper-clip, ask for an image or video, or trigger a web search inline.
The 3D avatar fills the canvas and the side panel keeps the transcript + composer in view.
Click the mic to start a voice-first session. The voice orb expands while the avatar listens and responds.
### Generate media right from the composer
Ask the agent to draw, animate, or research – the chat composer routes the request to the right model automatically.
### Tune the avatar and scene from Preferences
The palette icon next to the composer opens **Preferences**. Use it to set the default avatar and the 3D scene the avatar chat opens in.
***
## Step 4: Share Your Agent
Open **Shared** in the side navigation to publish a public link, bubble, or iframe.
### Create a shared agent
Click the **+** button to open the two-step create flow.
Choose the **Link Type** that fits your distribution plan:
* **Direct Link** – a clean URL you can post anywhere.
* **Iframe** – an embeddable widget for your website.
* **Chat Bubble** – a floating bubble script for any site.
Click **Add lead capture form** inside the Persona step. Configure title, consent text, and one or more fields (name, email, phone, custom). Mark each as required or optional.
Switch tabs between **Companion Avatars** (3D) and **Characters** (2D), pick a scene, and decide what logo appears in the embed.
Click **Publish**. The agent appears in the Shared list with a copy button for its public URL.
### Pick the right distribution
After publishing, the **Share Options** dialog gives you every distribution snippet for that agent:
A simple URL plus a Direct Link With Voice variant.
Two iframe variants – companion (avatar only) and companion-scene (full scene).
A drop-in `