@iraaai/sdk

Headless TypeScript/JavaScript SDK for DemoAgent by iraa.ai. Run AI-powered product demos programmatically -- from any agent, bot, or automation.

Install

npm install @iraaai/sdk

Quick Start

import { DemoAgent } from '@iraaai/sdk';

const agent = new DemoAgent({
  apiKey: 'sk_live_YOUR_KEY',
  baseUrl: 'https://api.iraa.ai', // optional, this is the default
});

// Start an interactive session
const session = await agent.createSession({
  productId: 'your-product-id',
  visitorMeta: { name: 'Jane', company: 'Acme' },
});

console.log(session.greeting?.text);

// Chat with the demo agent
const reply = await session.chat('Show me the reporting dashboard');
console.log(reply.text);
console.log(reply.suggestions);

// Capture a lead
await session.captureLead({ email: '[email protected]', company: 'Acme' });

// End the session
await session.end();

Headless Mode

Run a full demo conversation with no UI -- perfect for other AI agents:

const result = await agent.headless({
  productId: 'your-product-id',
  messages: [
    'Show me the reporting features',
    'How does billing work?',
    'Can I export to CSV?',
  ],
  visitorContext: {
    name: 'Jane',
    company: 'Acme',
    needs: ['reporting', 'billing'],
  },
});

console.log(result.transcript);
console.log(result.summary.featuresShown);
console.log(result.summary.discoveredNeeds);

Generate Demo Links

Create pre-seeded demo URLs for prospects:

const link = await agent.createDemoLink({
  productId: 'your-product-id',
  visitorContext: {
    name: 'Jane',
    email: '[email protected]',
    needs: ['enterprise reporting'],
  },
  options: {
    flow: 'enterprise-demo',
    expiresIn: 86400, // 24 hours
  },
});

console.log(link.demoUrl); // Send this to the prospect

API Reference

DemoAgent

| Method | Description | |--------|-------------| | createSession(opts) | Start a new interactive demo session | | createDemoLink(opts) | Generate a pre-seeded demo URL | | headless(opts) | Run a complete demo programmatically | | listProducts() | List all available products |

DemoSession

| Method | Description | |--------|-------------| | chat(message) | Send a message, get agent response | | captureLead(data) | Capture lead information | | end() | End the session |

What is DemoAgent?

DemoAgent is an AI-powered live demo platform for SaaS companies. It deploys conversational AI agents on websites that guide visitors through interactive product demos.

Learn more at iraa.ai.