Trillet AI Web SDK

Official Web SDK for integrating Trillet AI voice agents into your web applications. This SDK enables real-time voice communication with Trillet AI agents directly in your frontend application.

Installation

npm install @trillet-ai/web-sdk

Quick Start

React Integration

import { TrilletAgent } from '@trillet-ai/web-sdk';
import { useState } from 'react';

function VoiceAgent() {
  const [agent] = useState(() => new TrilletAgent({
    apiKey: 'your-api-key',
    workspaceId: 'your-workspace-id',
    agentId: 'your-agent-id'
  }));

  return (
    <div>
      <button onClick={() => agent.startCall()}>Start Call</button>
      <button onClick={() => agent.endCall()}>End Call</button>
      <button onClick={() => agent.toggleMicrophone(false)}>Mute</button>
    </div>
  );
}

Vanilla JavaScript

import { TrilletAgent } from '@trillet-ai/web-sdk';

const agent = new TrilletAgent({
  apiKey: 'your-api-key',
  workspaceId: 'your-workspace-id',
  agentId: 'your-agent-id'
});

// Add event listeners
agent.on('connected', () => console.log('Connected to agent'));
agent.on('disconnected', () => console.log('Disconnected from agent'));
agent.on('error', (error) => console.error('Error:', error));

// Control the call
await agent.startCall();
await agent.endCall();
agent.toggleMicrophone(false); // mute

Required Parameters

• apiKey: Your Trillet API key for authentication
• agentId: The unique identifier of the Trillet AI agent you want to connect to
• workspaceId: Your Trillet workspace identifier

Features

• 🎯 Frontend-only integration - no backend required
• 🔒 Secure WebRTC communication
• 🎤 High-quality audio streaming
• ⚛️ React support out of the box
• 📱 Mobile browser support
• 🔊 Audio device control (mute/unmute)

Events

The SDK emits several events you can listen to:

agent.on('connected', () => {});        // Call connected
agent.on('disconnected', () => {});     // Call ended
agent.on('error', (error) => {});       // Error occurred
agent.on('assistantStartedSpeaking', () => {}); // AI started speaking
agent.on('assistantStoppedSpeaking', () => {}); // AI stopped speaking

Documentation

For detailed documentation and integration examples, visit:

• API Documentation
• Example Repository

License

MIT License - see LICENSE file for details