# Seminara Documentation

> Complete documentation corpus for Seminara AI, optimized for LLM agents, developer integrations, and RAG retrieval.

## Table of Contents

- [Welcome to Seminara](https://seminara.online/docs/welcome): Getting Started documentation.
- [Account & Billing](https://seminara.online/docs/account-billing): Getting Started documentation.
- [Frequently Asked Questions](https://seminara.online/docs/frequently-asked-questions): Getting Started documentation.
- [Your First Session](https://seminara.online/docs/your-first-session): Getting Started documentation.
- [Uploading & Formatting Slides](https://seminara.online/docs/uploading-slides): Managing Sessions documentation.
- [Editing the Outline](https://seminara.online/docs/editing-the-outline): Managing Sessions documentation.
- [Setting up the CTA](https://seminara.online/docs/setting-cta): Managing Sessions documentation.
- [Test Session Feedback](https://seminara.online/docs/test-session-feedback): Managing Sessions documentation.
- [Host Dashboard](https://seminara.online/docs/host-dashboard): Managing Sessions documentation.
- [Follow-Up Engine](https://seminara.online/docs/follow-up-engine): Managing Sessions documentation.
- [Defining Persona](https://seminara.online/docs/defining-persona): Customizing Aura documentation.
- [Voice Selection](https://seminara.online/docs/voice-selection): Customizing Aura documentation.
- [The Knowledge Base](https://seminara.online/docs/knowledge-base): Customizing Aura documentation.
- [The Intent Engine](https://seminara.online/docs/intent-engine): Customizing Aura documentation.
- [Agent Capabilities & API](https://seminara.online/docs/agent-capabilities): API & Agents documentation.
- [API Overview & Authentication](https://seminara.online/docs/api-overview): API & Agents documentation.
- [Creating Sessions (API)](https://seminara.online/docs/api-sessions): API & Agents documentation.
- [Webhooks (Coming Soon)](https://seminara.online/docs/webhooks): API & Agents documentation.
- [Joining a Session](https://seminara.online/docs/joining-session): Attendee Experience documentation.
- [The Live Room Experience](https://seminara.online/docs/interacting-with-aura): Attendee Experience documentation.
- [Attendee Troubleshooting](https://seminara.online/docs/troubleshooting): Attendee Experience documentation.

---

## Welcome to Seminara

**Category:** Getting Started

Seminara is an AI-native platform designed to create autonomous, AI-led interactive experiences that run 24/7.

## Overview
High-value human expertise is repeatedly consumed through low-leverage delivery systems like static broadcasts and manual workshops. Seminara converts static assets (like PDF slide decks) into autonomous, guided sessions. 

The underlying orchestration engine handles real-time voice interruptions, answers questions verbally using the provided knowledge boundaries, and gracefully resumes the presentation flow. This allows you to generate and nurture leads without being tied to a live broadcast schedule.

## Key Capabilities

1. **Upload your knowledge:** You upload a PDF slide deck. Seminara parses the material and generates an interactive, reviewable session outline.
2. **Knowledge Base (KB):** Upload additional documents, text, or website URLs. Aura uses this secure vector store to answer off-script questions intelligently.
3. **Session-Level Memory:** Aura retains the full context of the ongoing conversation, allowing attendees to ask complex follow-up questions seamlessly.
4. **Interactive Presentation Controls:** Attendees can verbally barge-in to ask questions, or use natural voice commands to **skip slides, pause, or resume** the presentation.
5. **Email Follow-Up Engine:** The platform automatically captures high-intent leads and triggers personalized post-session email follow-ups based on the attendee's specific interactions.
6. **Global & Session Analytics:** Track deep engagement metrics, view question transcripts, and monitor CTA conversion rates across all your sessions or on a per-session basis.

## Frequently Asked Questions (FAQ)

**Q: Do I need to know how to code to use Seminara?**

A: Not at all! The platform is designed for non-technical users. You simply upload a PDF, and the platform handles the orchestration, state management, and real-time WebRTC connections.

**Q: Can the AI go off-topic?**

A: No. Seminara operates a strict finite-state machine (FSM) that governs conversational state. Unlike generic chatbot wrappers that easily lose focus, our orchestration layer enforces strict boundaries and always pulls the conversation back to the presentation.

**Q: How is Seminara different from a pre-recorded video?**

A: A video is static. Seminara is a live, autonomous agent. Attendees can interrupt, ask complex questions about your product, and the AI will answer them verbally in real-time using your exact knowledge base.

**Q: Can I use Seminara for internal employee onboarding?**

A: Absolutely! Many organizations use Seminara for internal compliance training, HR onboarding, and sales enablement, ensuring employees get an interactive experience at their own pace.

**Q: Do attendees need to download any software?**

A: No. Seminara runs entirely in the browser using standard WebRTC protocols. Attendees simply click your unique link and they are instantly placed in the live room.

---

## Account & Billing

**Category:** Getting Started

Seminara offers flexible subscription plans tailored to how many active sessions you intend to run.

## Overview
Seminara uses Dodo Payments to manage subscriptions securely. Your quota is determined by your active plan, which dictates how many live sessions you can host concurrently, how many test sessions you can run, and how many presentation minutes you have available.

## Subscription Tiers

### Trial Plan
The Trial Plan is designed to help you validate your workflow before committing.
- **Active Sessions:** Up to 4 active public sessions per month.
- **Test Sessions:** Up to 2 internal test sessions for validating your presentation and AI delivery.
- **Session Duration:** Up to 10 minutes per session.
- **Minute Pool:** Up to 50 total presentation minutes per month.

### Paid Plans
For agencies, consultants, and teams running high-volume lead generation.
- **Active Sessions:** Higher volume limits based on your selected tier.
- **Test Sessions:** Increased limits for iterative testing.
- **Session Duration:** Extended presentation time.
- **Features:** Priority voice generation, advanced email drip campaigns, and custom agent notes.

## Managing Your Plan
You can upgrade your plan directly from the Dashboard. Upgrades take effect immediately.

## Frequently Asked Questions (FAQ)

**Q: What happens if I hit my session limit on the Trial plan?**

A: You will not be able to create new sessions until you upgrade your plan.

**Q: Are payments secure?**

A: Yes. All payments are processed securely through Dodo Payments. Seminara does not store your credit card information directly on our servers.

**Q: Can I upgrade or downgrade my plan in the middle of a billing cycle?**

A: Yes. If you upgrade, the new limits are applied immediately and you'll be charged a prorated amount. Downgrades take effect at the start of your next billing cycle.

**Q: Do unused sessions or attendee limits roll over to the next month?**

A: No, session and attendee quotas reset at the beginning of each billing cycle to ensure maximum availability on our real-time infrastructure.

**Q: Is there a discount for annual billing?**

A: Yes! You can save 20% on all premium plans by switching to an annual billing cycle from your Host Dashboard.

---

## Frequently Asked Questions

**Category:** Getting Started

Here are some of the most common questions we receive about Seminara AI. If you need further assistance, please contact support.

### What is Seminara AI?
Seminara (or Seminara AI) is an agentic hosting and presentation platform developed by omniai.club. It uses Aura, an agentic host, to deliver interactive, real-time autonomous sessions that feel responsive and alive, eliminating the need for a live human host while maintaining high engagement.

### What exactly does Seminara do?
Seminara lets you run always-on sessions where your content is presented, questions are answered, and attendees are guided toward action without you being live every time.

### Is this a live presentation or a recording?
It’s neither a traditional live presentation nor a prerecorded video. Aura hosts the session in real time, presents your content, responds to attendees, and adapts the flow as the session progresses.

### Do I need to be on camera or present during the session?
No. You don’t need to be on camera, on a call, or even online. Once you set up a session, Aura handles the presentation and interaction.

### How do attendees interact during a session?
Attendees can ask questions by voice or text. Aura responds using the session content and your knowledge base, keeping the session moving naturally.

### What is test mode and why does it matter?
Test mode lets you see Aura rehearse a session before sharing it. You can watch Aura present, simulate attendee questions, interrupt, give feedback, and refine the session until it feels right.

### Can attendees have private or group experiences?
Yes. Attendees can have private sessions or as part of a multi-attendee session, while still receiving responses that feel personal and contextual.

### What happens after a session ends?
Seminara tracks engagement, unanswered questions, and session performance. You get insights and follow-up context so you know what resonated and what needs attention.

### Is Seminara replacing human hosts?
No. Seminara supports human hosts by handling delivery and interaction. You stay in control of the message, outcomes, and follow-ups.

### How do I customize the Aura agent?
You can customize Aura's voice, persona, and intent engine from your host dashboard, ensuring it aligns perfectly with your brand's tone and presentation style.

### What kind of content can I present?
Seminara supports uploading slides (PDF format) and providing custom knowledge base documents for Aura to study before the session.

### Can I integrate Seminara with my existing tools?
Yes, Seminara provides a powerful API and Webhooks system, allowing you to sync session events, leads, and attendee analytics directly into your CRM or marketing stack.

### How does the Knowledge Base work?
You can upload internal documents, FAQs, and product specs to your Knowledge Base. Aura instantly studies this material so it can confidently answer attendee questions during live sessions without hallucinating.

### Can other AI agents attend my sessions?
Yes! Seminara is built with Agentic Capabilities. Other AI agents (like ChatGPT, Claude, or custom bots) can discover your sessions via the llms.txt file and interact with your presentation via our OAuth API.

### What is the Follow-up Engine?
The Follow-up Engine tracks unanswered questions or high-intent leads during the session. It allows you to step in later and follow up with attendees personally using the exact context of their session.

### Are there any attendee limits?
Depending on your plan, you can host intimate 1-on-1 private sessions or scale up to multi-attendee broadcasts without any drop in performance or AI response quality.

### How do I drive attendees to a call-to-action?
You can configure a specific CTA (like 'Book a Demo' or 'Sign Up') in the Host Dashboard. Aura will intelligently guide the conversation toward your CTA when the attendee shows high intent.

---

## Your First Session

**Category:** Getting Started

Creating your first AI-hosted session is incredibly fast. This guide walks you through the step-by-step process.

## Step-by-Step Workflow

1. **Access the Dashboard:** Log into your Seminara account and click the **Create Session** button on your dashboard.
2. **Setup Details:** Provide a Title and Description for your session. These are visible to attendees on the Session Invitation screen.
3. **Upload Assets:** Choose a PDF slide deck. The system will automatically convert the PDF into high-quality images and extract the text.
4. **Wait for Generation:** Our AI will analyze the slide content and automatically generate an **Outline (Agent Notes)** for each slide.
5. **Review and Edit:** Review the generated outline in the setup wizard. You can edit the text to refine the talking points or emphasize specific topics.
6. **Go Live:** Click finish. You will receive a unique link (e.g., `seminara.online/join/your-slug`) to share with your audience.

## Optimizing the Presentation

Once your session is created, we highly recommend running a **Test Session**.
- From the session detail page, click the **Test** button.
- You will enter a private version of the live room.
- Listen to Aura present. If you want her to change her delivery, click the **Feedback** button in the top header.
- Type your notes (e.g., "Slow down here" or "Explain this in more detail") and click **Apply & Restart**. Seminara will automatically rewrite her script to match your instructions.

## Frequently Asked Questions (FAQ)

**Q: Can I use PowerPoint or Keynote files?**

A: Currently, Seminara only accepts PDF files. Please export your presentation to PDF before uploading.

**Q: Can I change the script after publishing?**

A: Yes! You can edit the Outline from the Host Dashboard, or use the Test Session feedback loop to refine Aura's exact wording at any time.

**Q: How long does the AI take to generate the outline?**

A: For a standard 20-slide deck, outline generation usually takes under 45 seconds. Larger, text-heavy decks may take up to 2 minutes to process fully.

**Q: Can I invite a co-host to present with Aura?**

A: Currently, Seminara sessions are single-host experiences driven entirely by the Aura agent. Multi-agent or human-AI co-hosting is planned for future updates.

**Q: Is there a limit to how many test sessions I can run?**

A: No, test sessions are completely free and unlimited. We encourage you to test iteratively until Aura sounds exactly how you want her to sound.

---

## Uploading & Formatting Slides

**Category:** Managing Sessions

The foundation of a great Seminara session is a well-formatted slide deck. Because our system converts your PDF into images and extracts text for AI context, how you format your slides matters.

## Formatting Best Practices

- **Aspect Ratio:** We highly recommend a **16:9** aspect ratio. This ensures your slides fill the screen beautifully on both desktop and mobile devices.
- **Export to PDF:** You must export your presentation from Canva, Keynote, Google Slides, or PowerPoint as a standard PDF.
- **Readable Text:** Ensure text is actual selectable text in the PDF, not an embedded image. This allows our backend to extract the text and feed it to the Intent Engine.
- **Avoid Dense Text:** Slides overloaded with text will cause the AI to generate very long, monotonous outlines. Keep slides visual and concise.

## The Extraction Workflow
When you upload a PDF, Seminara processes it directly in your browser. It converts each page into a high-quality PNG image and simultaneously extracts the text. This means your raw slides are processed securely and quickly before being sent to our servers for outline generation.

## Frequently Asked Questions (FAQ)

**Q: Why does the AI skip some information on my slide?**

A: If the text on your slide is embedded within an image (flattened), the AI cannot read it. Ensure your PDF contains live text.

**Q: Is there a file size limit?**

A: Yes, the maximum upload size for a PDF is 50MB. If your file is larger, consider compressing the images before exporting.

**Q: Can I add videos or animations to my slides?**

A: No, because Seminara converts PDFs to static PNG images for web delivery, any embedded videos, transitions, or animations in your original presentation will not be preserved.

**Q: Does Seminara support custom fonts?**

A: If you embed the fonts in your PDF export from Canva or Keynote, they will display perfectly in the live room. If fonts aren't embedded, the PDF renderer might fall back to standard system fonts.

**Q: Can I upload a slide deck in landscape instead of 16:9?**

A: You can, but a 4:3 or non-standard aspect ratio will result in black bars (letterboxing) on modern screens. We highly advise sticking to the standard 16:9 widescreen format.

**Q: Is there a file size limit?**

A: Yes, the maximum upload size for a PDF is 50MB. If your file is larger, consider compressing the images before exporting.

---

## Editing the Outline

**Category:** Managing Sessions

After you upload your slides, Seminara's AI automatically generates an **Outline** (a set of core talking points) for each slide. While the AI is highly capable of extracting the main ideas, human review ensures the focus perfectly matches your strategic goals.

## How to Review and Edit
1. Navigate to the **Session Setup** page for your newly created session.
2. You will see a list of your slides alongside the generated text boxes.
3. Click into the text box next to any slide to edit the **Outline/Talking Points**.

## Outline Optimization Tips
- **Focus on the "What", not the "How":** The outline is *not* a word-for-word script. It is a set of instructions for Aura. Write down the core concepts you want her to cover, and she will handle turning them into a natural, conversational delivery.
- **Add Strategic Pivots:** If a slide has a lot of data, use the outline to tell Aura which specific data point to focus on (e.g., "Emphasize the 40% growth metric here").
- **Handling Complex Jargon:** If your slide has complex jargon, use the outline to instruct Aura on how to explain it simply to the audience.

## Modifying the Actual Script (The Words Aura Says)
You **cannot** manually type out the exact words Aura will speak in the setup wizard. We restrict this because handwritten scripts sound robotic when fed to AI voice models. 

Instead, Seminara uses a dynamic optimization loop:
1. Finish editing your outline.
2. Launch a **Test Session**.
3. Listen to how Aura naturally interprets your outline.
4. At the end of the test, use the **Feedback Modal** to tell the AI what needs to change.

(For full details on this process, read the [Test Session Feedback](/docs/test-session-feedback) guide.)

## Frequently Asked Questions (FAQ)

**Q: Can I edit the outline after the session goes live?**

A: Yes, you can pause or archive a session, edit the outline, and resume it. However, the new outline will only apply to attendees who join after the change is saved.

**Q: How granular should my outline be?**

A: We recommend keeping outline points concise (1-2 sentences). Aura performs best when given core talking points to elaborate on naturally, rather than reading a rigid script word-for-word.

**Q: Can I reorder the outline independently of the slides?**

A: No, the outline is inherently tied to the slide order. If you want to change the flow, you must reorder the underlying PDF slides and re-upload the deck.

---

## Setting up the CTA

**Category:** Managing Sessions

The ultimate goal of education-led sales is conversion. Seminara provides built-in tools to capture high-intent leads exactly when they are most engaged.

## Configuring the Button
In the Session Setup wizard, on the Finalize step, you can define your Call to Action (CTA).
- **CTA Type:** Select from templates like "Schedule a Call" or "Download Resource".
- **Button Text:** The exact text on the button, e.g., "Schedule a Call" or "Download Now".
- **Action URL:** The link where the user will be redirected (e.g., your Calendly link or checkout page).

## How the CTA is Triggered
The Seminara FSM (Finite State Machine) has a dedicated `CLOSING` phase. 
Once Aura finishes narrating the final slide, she will seamlessly transition into the closing remarks and the CTA button will animate onto the attendee's screen.

Aura is programmed to verbally prompt the attendee to click the button on their screen.

## Lead Recovery
If an attendee completes the session but does not click the CTA, Seminara's **CTA Recovery** engine can automatically follow up with them via email (if enabled in your settings).

## Frequently Asked Questions (FAQ)

**Q: Can I have multiple CTAs?**

A: Currently, Seminara focuses on a single, high-conversion primary CTA at the end of the session to maximize click-through rates.

**Q: Can I trigger the CTA button before the presentation ends?**

A: By default, the CTA is triggered during the closing phase. However, attendees can type `/cta` in the chat at any time, or verbally ask Aura for the next steps, which will manually display the button.

**Q: Does the CTA button support deep linking into my app?**

A: Yes, you can use custom URL schemes (like `myapp://upgrade`) in the Action URL field to deep link attendees directly into your native mobile or desktop application.

**Q: How do I track which attendees clicked the CTA?**

A: The CTA clicks are tracked individually. In your Host Dashboard's analytics view, you can export the contact list and filter for leads where `cta_clicked` is true.

---

## Test Session Feedback

**Category:** Managing Sessions

Seminara uses a powerful **Iterative Improvement** loop to optimize the actual script (the exact words Aura says) rather than forcing you to type out robotic, verbatim scripts manually.

## Launching a Test Session
1. Go to your session detail page.
2. Click the **Test** button in the top-right action bar. This launches an isolated, private version of your session that does not affect your public analytics or attendee data.

## Using the Feedback Popover
In the Test Room, you will see a **Feedback** button in the top header bar. Click it to open the Iterative Improvement popover. This is your direct channel to optimize Aura.

### How It Works
1. **Type your feedback:** In the text area labeled "What should Aura do differently?", type natural language instructions. For example:
   - "Be more punchy on slide 3"
   - "Don't talk about therapy"
   - "Explain the tech stack in more detail"
   - "Slow down during the pricing section"
   - "Use less corporate jargon"
2. **Click "Apply & Restart":** This sends your feedback to Seminara's optimization engine.

## The Optimization Engine
When you click **Apply & Restart**, Seminara will:
1. Analyze your written feedback.
2. Review the current Outline and Agent Notes for every slide.
3. Dynamically re-write the underlying script instructions to fix the issues you raised (e.g., adding pauses, simplifying jargon, or expanding on a specific topic).
4. Save the optimized script to your session.
5. Automatically restart the test session so you can hear the changes immediately.

## Frequently Asked Questions (FAQ)

**Q: Can I submit feedback multiple times?**

A: Yes! The loop is iterative. Run the test, give feedback, click Apply & Restart, and repeat until you are satisfied with Aura's delivery.

**Q: Does giving feedback change my written outline?**

A: No, your visible outline remains untouched. The feedback engine adjusts the hidden semantic instructions that govern how Aura interprets your outline points.

**Q: What if I make a mistake and want to undo my feedback?**

A: You can view the feedback history in the session settings and click "Revert" on any previous adjustment to restore Aura's prior conversational behavior.

**Q: Can I provide feedback on Aura's voice tone rather than just the script?**

A: Absolutely. If she sounds too monotone or too excited, simply type "Speak more calmly" or "Increase your energy level" in the Feedback modal, and the voice generation parameters will automatically adjust.

---

## Host Dashboard

**Category:** Managing Sessions

The Host Dashboard is your mission control. From here, you can manage all your active sessions, view test environments, and analyze engagement metrics.

## Key Features

1. **Session Management:** View all Draft, Active, and Archived sessions. Click into any session to edit the outline, change the slides, or grab the share link.
2. **Analytics Overview:** Track total visitors, average view duration, and CTA conversion rates.
3. **Lead Capture:** View the contact information (emails, names) of attendees who have raised their hands or interacted deeply with your sessions.
4. **Test Sandboxes:** Launch a private, isolated version of your session to test the voice and optimize the script without affecting your public metrics.

## Understanding Engagement Scores
Our background AI agents (specifically the *Analyst* agent) monitor sessions in real-time. Attendees who ask highly relevant, specific questions receive a higher Engagement Score. You can view these scores in the dashboard to prioritize which leads to follow up with manually.

## Frequently Asked Questions (FAQ)

**Q: Can I see what questions attendees asked during the session?**

A: Yes! The interaction logs in the dashboard display transcripts of the questions asked by attendees and the answers provided by Aura.

**Q: Can I export the engagement analytics?**

A: Yes, you can export session data, attendee logs, and Q&A transcripts as a CSV file directly from the Session Analytics tab in the dashboard.

**Q: How long does it take for analytics to populate?**

A: Engagement metrics, including the AI-calculated Engagement Score, populate in real-time as the session is happening. You can literally watch attendees interact live.

**Q: Is there a limit to how many archived sessions I can keep?**

A: No, archived sessions are stored indefinitely on our secure servers, allowing you to retain all historical lead data and transcripts for future reference.

---

## Follow-Up Engine

**Category:** Managing Sessions

Seminara doesn't just present; it nurtures. The Follow-Up Engine automates email campaigns based on attendee behavior during the session.

## How it Works
When creating a session, you can enable **Post-Session Drip** and **CTA Recovery** from the Email Follow-ups card on the session detail page.

1. **Trigger Events:** The system listens for specific session events, such as completing the presentation, raising a hand, or abandoning the session early.
2. **Dynamic Generation:** Aura drafts follow-up emails based on the specific questions the attendee asked during the session, making the outreach highly personalized.
3. **Delivery:** Emails are sent automatically on your behalf. Any replies from attendees are routed directly to your account's email address.

## Customizing the Assistant Tone
In your global settings (or per session), you can define the tone Aura uses when writing follow-up emails. The available options are:
- **Professional & Helpful:** Direct, polite, and corporate.
- **Enthusiastic & Hype:** High energy, perfect for product launches.
- **Casual & Conversational:** Relaxed, friendly, and approachable.
- **Direct & Scarcity-Driven:** Focused on immediate next steps and limited-time offers.

## Frequently Asked Questions (FAQ)

**Q: Can I integrate this with my own CRM like HubSpot or Salesforce?**

A: Currently, we offer Webhooks that allow you to pipe these events directly into Zapier or your CRM of choice.

**Q: Does Aura send follow-up emails instantly?**

A: You can configure the delay in the Host Dashboard. By default, emails are sent 15 minutes after the attendee leaves the session to simulate a natural response time.

**Q: What happens if an attendee doesn't ask any questions?**

A: If the attendee was silent but completed the presentation, the Follow-Up Engine will send a generic "Thank you for attending" email with the Call-to-Action link included.

**Q: Can I review the drafted follow-up emails before they are sent?**

A: Yes, if you enable "Draft Mode" in the Follow-Up settings, the emails will be queued in your Dashboard for manual review and approval before dispatching.

---

## Defining Persona

**Category:** Customizing Aura

Aura's behavior is fundamentally driven by the Custom Instructions you provide. This prompt acts as the ultimate set of rules governing how Aura interprets questions and generates answers.

## Where to Edit the Persona
Navigate to the **Aura Customization** section in your dashboard. Here you can edit the **Custom Instructions (Optional)**, which applies to all your sessions by default.

## Best Practices for Prompting

**Do:**
- Give Aura a clear role. (e.g., "You are Alex, a senior technical sales engineer at Acme Corp.")
- Define the tone. (e.g., "Speak concisely, confidently, and avoid using corporate buzzwords.")
- Set strict boundaries. (e.g., "If asked about pricing, state that pricing starts at $99/mo, but a custom quote is required for enterprise.")

**Don't:**
- Write vague instructions. (e.g., "Be helpful.")
- Give Aura permission to guess. Instead, instruct her: "If you do not know the answer based on the knowledge base, politely state that a human representative will follow up via email."

## The Intent Engine Connection
Your persona prompt is injected directly into the ContextManager of our AI Multi-Agent System. When a user asks a question, the LLM uses your persona to format the final verbal response.

## Frequently Asked Questions (FAQ)

**Q: Does Aura have a memory of previous sessions?**

A: No. Each session is isolated. However, Aura remembers the context of the *current* session perfectly.

**Q: Will Aura break character if an attendee asks a totally unrelated question?**

A: No. By defining strict boundaries in your Custom Instructions (e.g., "Always bring the conversation back to the product"), Aura will politely deflect off-topic questions and maintain her persona.

**Q: Can I set a different persona for different sessions?**

A: The Custom Instructions in your dashboard apply globally to all new sessions. However, you can provide session-specific nuance by uploading specific PDF slide decks tailored to different audiences.

**Q: Is there a character limit for Custom Instructions?**

A: Yes, Custom Instructions are currently limited to 2,000 characters to ensure the LLM's system prompt remains highly focused and responsive during live WebRTC sessions.

---

## Voice Selection

**Category:** Customizing Aura

Aura relies on state-of-the-art Text-to-Speech (TTS) models to deliver human-like, low-latency audio.

## Supported Providers

Seminara uses a multi-provider architecture for maximum reliability and lowest latency:
1. **Primary Voice Provider:** Optimized for ultra-low latency conversational agents. This is the default provider.
2. **Fallback Voice Provider:** Used if the primary provider experiences downtime or if a highly specific emotive voice is required.

## Selecting a Voice
In the **Aura Customization** settings, you can preview the available voices. 
We provide a curated list of voices optimized for presentations. Currently available voices:
- **Female 1 (Thalia)** - Female, US
- **Male 1 (Orion)** - Male, US

## Latency Considerations
Our orchestration engine is tuned to achieve 1200ms - 2000ms response times. Voice selection can slightly impact this. Our primary provider generally offers the lowest time-to-first-byte (TTFB), which is critical for making interruptions feel natural.

## Frequently Asked Questions (FAQ)

**Q: Can I clone my own voice?**

A: Voice cloning is currently available exclusively on the Ultra tier. Contact support to enable this feature.

**Q: Does the voice support different accents?**

A: Yes, while the default voices are US English, you can explicitly instruct Aura in the Custom Instructions to adopt a British or Australian accent, and the generation model will adapt accordingly.

**Q: Can I change the speed of the voice?**

A: While hosts cannot set a global speed multiplier, attendees can verbally ask Aura to "speak a bit slower" or "speed up" during the session, and she will dynamically adjust her pacing.

**Q: What if the voice mispronounces my company name?**

A: You can provide phonetic spellings in your Custom Instructions (e.g., "Pronounce Seminara as Sem-in-ARR-ah"). Aura will strictly follow this phonetic guide when speaking.

---

## The Knowledge Base

**Category:** Customizing Aura

While your slides provide the primary narrative, attendees will inevitably ask questions that aren't covered on the screen. The Knowledge Base (KB) gives Aura the context needed to answer them intelligently.

## How it Works
When you upload documents to the Knowledge Base, Seminara chunks the text and stores it in a secure Vector Store. 
When an attendee asks a question, our Intent Engine performs a semantic search (RAG - Retrieval-Augmented Generation) against this vector store to fetch relevant facts before generating Aura's response.

## Add to Knowledge Base
You can manage your KB by clicking **Add to Knowledge Base** in the dashboard.
You can add context in three ways:
- **File:** Upload PDF or TXT files.
- **Text:** Paste raw text directly into the dashboard.
- **URL:** Provide a website link and we will automatically scrape the article.
- **Best Practices:** Upload your company FAQ, technical data sheets, or standard objection-handling scripts.

## Boundaries and Hallucinations
Aura is strictly instructed via our internal System Prompts to *only* answer questions based on the provided slides and the Knowledge Base. If an attendee asks an irrelevant question (e.g., "What is the capital of France?"), Aura will gracefully deflect and steer the conversation back to the presentation.

## Frequently Asked Questions (FAQ)

**Q: Is my Knowledge Base data used to train public AI models?**

A: Absolutely not. Your data is isolated to your organization and is never used to train foundational LLMs.

**Q: What is the maximum file size I can upload to the KB?**

A: You can upload PDF or TXT files up to 50MB per document. For larger datasets, we recommend breaking them into smaller, topic-specific files.

**Q: How long does it take for Aura to process new KB documents?**

A: Document processing and vectorization happen in the background and typically complete within 30 seconds. You'll see a "Ready" badge in your dashboard when it's done.

**Q: Can I prioritize certain KB documents over others?**

A: Yes. You can pin essential documents in the KB manager. The semantic search algorithm assigns a higher weight to pinned documents when fetching context for Aura's answers.

---

## The Intent Engine

**Category:** Customizing Aura

The Intent Engine is the core intelligence layer of Seminara. It is responsible for parsing user speech in real-time and deciding how Aura should react.

## The Finite State Machine (FSM)
Seminara does not use a generic "chatbot" loop. Instead, it relies on a strict 6-phase Orchestrator FSM (Initialization, Narration, Interruption, Evaluation, Generation, Resumption). 

This ensures that the presentation maintains structural integrity. The session will always progress toward the Call to Action, regardless of how many times the attendee interrupts.

## Handling Interruptions
When an attendee speaks:
1. **Voice Activity Detection (VAD):** Aura immediately stops speaking to listen.
2. **Transcription:** Our ultra-low latency models transcribe the speech in milliseconds.
3. **Intent Classification:** The Intent Engine determines if the user made a COMMAND (e.g., "Stop"), a QUERY (e.g., "How much does it cost?"), or noise.
4. **Contextual Generation:** The LLM generates a grounded response using the Knowledge Base.
5. **Resumption:** Aura answers the question, then seamlessly resumes the presentation from the exact bookmark where she was interrupted.

## Frequently Asked Questions (FAQ)

**Q: What happens if two people speak at once?**

A: Currently, Seminara sessions are optimized for 1-on-1 or small group interactions where turn-taking is managed by the host agent. The VAD will trigger on the loudest distinct speech.

**Q: Can the Intent Engine handle multiple languages?**

A: Currently, Seminara officially supports English (US, UK, AUS). While the transcription model can detect other languages, Aura's generation and voice models are highly optimized for English.

**Q: Does the Intent Engine support custom hotwords?**

A: No, attendees don't need to say "Hey Aura." The engine uses continuous Voice Activity Detection (VAD) to naturally detect when an attendee is addressing the host.

**Q: How fast is the Intent Engine's response time?**

A: Our system is optimized for ultra-low latency. The round-trip time from the end of the user's speech to the start of Aura's verbal response is typically under 800 milliseconds.

---

## Agent Capabilities & API

**Category:** API & Agents

Seminara is an **Agentic Presentation Platform**. Beyond just human users interacting with our dashboard, Seminara is designed from the ground up to be fully accessible to third-party AI agents (such as Claude Code, GitHub Copilot, Codex, or custom AI assistants).

This means your AI agents can programmatically authenticate, create, and manage presentation sessions on your behalf, without you ever needing to leave your terminal or chat interface.

## 🤖 The Agent Discovery Protocol

Seminara explicitly tells other AI agents how to interact with it via our `llms.txt` and `openapi.json` files. If you point an intelligent agent at our root domain, it will automatically discover:

- Our **Agent Catalog** (`/.well-known/ai-catalog.json`)
- Our **OpenAPI Specification** (`/openapi.json`)
- The **Agent Instructions** (`/llms.txt`)

These files act as the "system prompt" for external AIs, detailing the exact API endpoints and authentication flows they must use to operate Seminara.

## 🔐 Agentic Authentication (OAuth Device Flow)

Because AI agents often run in environments without traditional web browsers (like a CLI or a headless server), Seminara supports the **OAuth Device Authorization Flow** (RFC 8628).

This allows an agent to request access to your account securely:

1. **Initiation**: The agent calls `POST /api/v1/oauth/device/code`.
2. **User Prompt**: Seminara returns a `user_code` and a `verification_uri`. The agent displays this to you in your terminal/chat.
3. **Approval**: You click the link, log into Seminara, and approve the agent's access.
4. **Token Issuance**: While you are approving, the agent polls `POST /api/v1/oauth/device/token`. Once approved, Seminara issues a short-lived `access_token` and a `refresh_token` to the agent.

The agent can now use this Bearer token to perform actions on your behalf!

## ⚡ What Can Agents Do?

Currently, authenticated agents can perform the following actions programmatically via our API:

### 1. Create Sessions
Agents can instantly spin up a new AI-hosted presentation, interactive session, or product demo.

**Endpoint:** `POST /api/v1/agent/sessions`

When you tell your agent: *"Create a Seminara session for a product demo,"* the agent will call this endpoint and return the live, shareable URL to you instantly.

### 2. Future Capabilities
We are actively expanding the agentic API. Upcoming endpoints will allow agents to:
- Upload slides and PDFs directly from your local filesystem.
- Configure Aura's voice and personality traits.
- Manage Call-to-Actions (CTAs) and session outlines.
- Retrieve engagement analytics and transcript summaries after a session concludes.

## 🛠️ Building Your Own Agent Integration

If you are building your own AI tool or LLM application and want it to leverage Seminara's Agentic capabilities natively, simply ingest our `openapi.json` specification into your framework (like LangChain or LlamaIndex) and configure Bearer authentication. 

The Seminara platform will handle the rest, transforming your LLM's text output into live, interactive, voice-driven presentation experiences.

## Frequently Asked Questions (FAQ)

**Q: Which LLMs are supported via the Agent Discovery Protocol?**

A: Seminara is model-agnostic. Because we use standard `llms.txt` and OpenAPI protocols, any intelligent agent like Claude Code, ChatGPT, or custom LangChain/LlamaIndex agents can authenticate and manage sessions.

**Q: Can my agent answer attendee questions directly?**

A: The Seminara API is for session *management*. The real-time, voice-based Q&A during a live session is always handled by Aura using your configured Knowledge Base to guarantee low latency.

**Q: How do I revoke an agent's access to my account?**

A: You can instantly revoke any authorized agent's token from the Security settings in your Host Dashboard. This immediately terminates their programmatic access.

---

## API Overview & Authentication

**Category:** API & Agents

Seminara offers a programmatic API for advanced users and organizations who want to generate and manage sessions automatically.

## Base URL
All API requests should be made to:
`https://seminara.online/api/v1`

## API Keys
For server-to-server integrations, you can generate a static API key directly from the Developer Dashboard. 
Provide this key in the headers of your requests:
`Authorization: Bearer sk_live_your_api_key`

## Status Codes
All API endpoints return standard HTTP status codes. 
- `200 OK` - Success
- `400 Bad Request` - Missing parameters
- `401 Unauthorized` - Invalid API Key
- `402 Payment Required` - Quota exceeded

## Frequently Asked Questions (FAQ)

**Q: Can I use the API to upload PDFs directly?**

A: Yes, via the `POST /api/v1/agent/sessions` endpoint (detailed in the next section).

**Q: Are there rate limits on the Seminara API?**

A: Yes, the API is rate-limited to 100 requests per minute per account to prevent abuse. If you exceed this limit, the API will return a `429 Too Many Requests` error.

**Q: How do I rotate a compromised API key?**

A: You can regenerate your API key instantly from the Developer Dashboard. Once rotated, the old key immediately stops working, and any active integrations must be updated.

**Q: Can I access the API from a frontend browser application?**

A: For security reasons, the Seminara API is designed for server-to-server communication. Exposing your static API key in frontend code is not supported as it poses a major security risk.

---

## Creating Sessions (API)

**Category:** API & Agents

Third-party AI agents can programmatically generate fully-hosted Seminara sessions for their users using this endpoint.

## POST /api/v1/agent/sessions

Creates a new draft session, generates a unique join link, and applies the user's default settings (CTA recovery, follow-up tone).

### Headers
```http
Authorization: Bearer sk_live_...
Content-Type: application/json
```

### Request Body
```json
{
  "title": "string (Required)",
  "description": "string (Optional)",
  "mode": "isolated | broadcast (Optional, defaults to isolated)"
}
```

### Response (200 OK)
```json
{
  "sessionId": "uuid",
  "slug": "string",
  "code": "string",
  "shareLink": "https://seminara.online/join/slug"
}
```

## Agent & API Context
When a session is created via this API, the `source` column in the database is automatically tagged as `agent_api`. This allows hosts to track which leads were generated manually vs. generated by your external AI agent.

Please note that this endpoint enforces the user's subscription quotas. If the user has exhausted their active session limit, the API will return a `402 Payment Required` error.

## Frequently Asked Questions (FAQ)

**Q: Does this endpoint generate the slides?**

A: This endpoint initializes the session wrapper. You must subsequently use the `/api/sessions/generate-slides` endpoint (or instruct the user to upload their PDF via the UI) to populate the visual content.

**Q: Can I create a broadcast session programmatically?**

A: Absolutely. Simply set the `mode` parameter to `broadcast` in your request body to allow hundreds of attendees to join the same live session.

**Q: What happens if the title I provide is extremely long?**

A: The title is truncated to 150 characters on our end for UI consistency. It's best to keep session titles concise and engaging.

**Q: Can I update the session details after it's been created via the API?**

A: Currently, the API supports session creation. To edit the title or description, you'll need to open the session in the Host Dashboard. Update endpoints are on our roadmap.

---

## Webhooks (Coming Soon)

**Category:** API & Agents

Webhooks will allow you to build custom integrations by subscribing to real-time events that happen inside your Seminara sessions.

## Planned Event Types
- `session.started` - Fired when an attendee joins the room.
- `session.completed` - Fired when Aura concludes the presentation.
- `lead.captured` - Fired when an attendee clicks the CTA or raises their hand.

## Payload Structure (Draft)
All webhooks will be sent as `POST` requests to your configured endpoint with a JSON payload containing the event type, session ID, and relevant metadata.

## Frequently Asked Questions (FAQ)

**Q: When will Webhooks be available?**

A: We are currently finalizing the infrastructure and plan to release Webhooks shortly.

**Q: Are webhooks retried if my server is down?**

A: Yes, our planned webhook infrastructure will feature exponential backoff, automatically retrying failed deliveries for up to 72 hours before dropping the event.

**Q: How do I secure my webhook endpoint?**

A: Seminara will sign all webhook payloads using a unique secret key. You can verify the `X-Seminara-Signature` header in your backend to confirm the request is authentic.

**Q: Will webhooks trigger during Test Sessions?**

A: No, to prevent polluting your production CRM or analytics systems, webhooks are strictly suppressed during private test and sandbox sessions.

---

## Joining a Session

**Category:** Attendee Experience

Seminara provides a secure, streamlined entry process for attendees joining a live session.

## The Invitation Link
Attendees join by clicking a unique link provided by the host (e.g., `seminara.online/join/[identifier]`). 

### 1. Authentication
To ensure high-quality analytics and secure access, attendees must be authenticated. If an attendee is not logged in, they will be briefly redirected to the login/signup page before being returned to the invitation.

### 2. The Acceptance Screen
Once authenticated, attendees land on the **Session Invitation** screen. This page displays:
- The Host's Avatar and Brand Name
- The Session Title and Description
- The Scheduled Date and Time
- A secure "Authenticated Only" badge

### 3. Accepting the Invitation
Attendees click the large **Accept Session Invitation** button. Doing this:
1. Registers their RSVP in the host's analytics.
2. Adds the session to the attendee's personal Dashboard for easy access later.
3. Immediately redirects them into the Live Room.

## System Requirements
- **Browser:** We strongly recommend Google Chrome, Safari, or Microsoft Edge.
- **Connection:** A stable broadband connection is required for low-latency audio.
- **Hardware:** A working microphone and speakers/headphones.

## Frequently Asked Questions (FAQ)

**Q: Do attendees have to create an account?**

A: Yes, attendees must authenticate. This allows them to maintain a personal dashboard of sessions they've attended and ensures hosts get accurate lead data.

**Q: Do I have to turn on my camera?**

A: No. Seminara sessions are audio and slide-driven. Video streaming is not used, ensuring a low-pressure environment for attendees.

**Q: Can I join a session on my mobile phone?**

A: Yes! Seminara is fully optimized for mobile browsers, ensuring attendees get the same interactive voice experience on their phones without needing to download a dedicated app.

**Q: Is there a dial-in phone number for the session?**

A: No, Seminara relies on WebRTC through the browser to sync the visual presentation with the audio. Traditional phone dial-ins are not supported.

**Q: Can I forward my invitation link to a colleague?**

A: It depends on the host's settings. If the session is public, anyone with the link can authenticate and join. If it's a private invite, they will be blocked at the authentication step.

---

## The Live Room Experience

**Category:** Attendee Experience

Seminara is not a passive video; it's an interactive conversation. When you enter the live room, you are presented with a clean, focused environment designed to maximize learning and engagement.

## The Room Layout
1. **The Main Stage (Slides):** The center of the screen displays the host's visual presentation. Aura advances these slides automatically as she speaks.
2. **The Chat Interface:** On the side of the screen, there is a real-time transcript of the conversation and a text input box.
3. **The Control Bar:** At the bottom, you'll find your primary interaction controls.

## How to Interact

There are three primary ways to interact with Aura during a session:

### 1. Voice Interaction
You can speak to Aura just like a human presenter.
- **Natural Barge-in:** If your microphone is unmuted, you can simply start speaking. Aura's Voice Activity Detection (VAD) will hear you, immediately pause her narration, listen to your question, and answer you before resuming the presentation.
- **The "Raise Hand" Button:** If you prefer not to interrupt abruptly, click the **Raise Hand** button in the control bar. Aura will notice this, finish her current thought, and politely ask you to go ahead with your question.

### 2. Text Q&A
If you cannot use your microphone or prefer typing, you can use the **Chat Interface**. 
Type your question into the chat box and hit send. Aura reads this chat in real-time. She will verbally acknowledge your question (e.g., "I see a question in the chat...") and answer it aloud for everyone.

### 3. Interactive Polls
During the presentation, the host may trigger interactive **Poll Cards**. These will pop up over the presentation. You can click an option to submit your vote, and Aura will react to the live results.

## Presentation Controls
You have full agency over the session pacing. Using either voice commands or the Chat Interface, you can tell Aura to:
- **Skip:** "Aura, skip to the next section."
- **Pause/Resume:** "Give me a minute to read this." / "Okay, I'm ready, continue."
- **Replay:** "Can you repeat that last point?"

## Frequently Asked Questions (FAQ)

**Q: What if I accidentally cough or make a noise?**

A: Our Intent Engine filters out background noise and non-verbal sounds. If you cough, Aura will ignore it and continue presenting.

**Q: Can I type a question while Aura is speaking?**

A: Yes! You can type in the chat at any time. Aura will finish her current sentence, verbally acknowledge your written question, and answer it seamlessly.

**Q: Is there a way to mute myself permanently during the session?**

A: Absolutely. You can click the microphone icon in the Control Bar to hard-mute your input. You can still interact via the text chat or Poll Cards.

**Q: How does Aura handle offensive or inappropriate questions?**

A: Aura's underlying models have strict safety guardrails. If an attendee asks an inappropriate question, Aura will politely decline to answer and steer the conversation back to the presentation.

---

## Attendee Troubleshooting

**Category:** Attendee Experience

If you are experiencing issues during a session, follow these steps to resolve them quickly.

## Aura Can't Hear You
If you ask a question but Aura continues talking or doesn't respond, the issue is likely your microphone permissions.
- **Chrome:** Click the "lock" icon next to the URL in the address bar. Ensure the Microphone toggle is set to "Allow". Refresh the page.
- **Safari:** Go to Settings -> Websites -> Microphone, and ensure seminara.online is set to "Allow".

## You Can't Hear Aura
If you see the slides progressing and Aura's speaking indicator flashing, but you hear no sound:
- Ensure your device's volume is turned up.
- Check if your browser tab is muted (look for a speaker icon with a slash on the tab).
- In some strict corporate networks, WebRTC audio may be blocked. Try disconnecting from the VPN.

## Connection Drops
Seminara uses real-time WebSocket and WebRTC connections. If your internet briefly drops, the UI will display a "Reconnecting..." banner.
- **Do not close the tab.** The system will attempt to auto-reconnect.
- If it fails after 10 seconds, simply refresh the page. You will rejoin the session, and Aura will acknowledge your return.

## Frequently Asked Questions (FAQ)

**Q: I accidentally closed the tab. Can I get back in?**

A: Yes. Just click the original join link again. Depending on the host's settings, you may resume where you left off or start fresh.

**Q: Why is there an echo when I speak?**

A: This usually happens if you are using speakers instead of headphones at a high volume. Aura's audio feeds back into your microphone. Please lower your volume or switch to headphones.

**Q: My company firewall blocks WebRTC. What should I do?**

A: Contact your IT department to whitelist `stun.l.google.com` and ensure UDP ports 10000-60000 are open for WebRTC media traffic, which is required for Seminara's low-latency audio.

**Q: Aura keeps interrupting me before I finish my question. How do I fix this?**

A: You might be taking long pauses while speaking. If you need time to formulate your question, use the Chat Interface to type it out instead, ensuring Aura receives the complete thought.

---