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. The agent operates your real product, driven by a Product Discovery Protocol (PDP) — the YAML spec you author once per product.

Quick Start

  1. Create an account at iraa.ai/signup 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

What is PDP?

Plain-English explainer of Product Discovery Protocol — iraa.ai's open YAML spec for AI demo agents. Start here.

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 Reference

Full schema reference for the YAML spec that defines screens, flows, demo journey, and agent 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://iraa.ai/dashboard

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