DemoAgent Documentation

DemoAgent lets you deploy an AI agent that gives every website visitor a live, personalized product demo. No scheduling, no pre-recorded tours.

Quick Start

  1. Create an account at app.iraa.ai and get your API key (pk_live_...)
  2. Define your product with a PDP YAML file or use auto-discovery from the dashboard
  3. Add the widget to your site:
<script
  src="https://cdn.iraa.ai/widget.js"
  data-api-key="pk_live_YOUR_KEY"
  async>
</script>

Or initialize programmatically:

DemoAgent.init({
  apiKey: 'pk_live_YOUR_KEY',
  theme: 'auto',           // 'light' | 'dark' | 'auto'
  position: 'bottom-right' // 'bottom-right' | 'bottom-left'
});

Documentation

Widget Integration

Embed the DemoAgent chat widget on any website with a single script tag or framework component.

REST API Reference

Session management, PDP upload, authentication, analytics, and discovery endpoints.

PDP Schema

Product Discovery Protocol — the YAML spec that defines screens, flows, and demo behavior.

WebSocket API

Real-time bidirectional chat protocol for live demo sessions.

Key Concepts

PDP (Product Discovery Protocol)
A YAML file that describes your product's screens, UI elements, demo flows, FAQ knowledge, and agent configuration. This is the single source of truth for how DemoAgent interacts with your product.
Sessions
Each visitor gets a unique demo session with its own conversation history, agent state, and lead capture flow.
Flows
Scripted step-by-step product walkthroughs (navigate, click, type, highlight) that the AI agent can execute in the live product iframe.
Multi-Agent System
A Router agent classifies visitor intent and delegates to specialized agents: Demo (product showcase), Q&A (knowledge base), Discovery (product exploration), and Docs (technical documentation).

API & Resources

API Base URL: https://api.iraa.ai

Widget CDN: https://cdn.iraa.ai/widget.js

Dashboard: https://app.iraa.ai

Machine-readable docs: /llms.txt | /llms-full.txt