Events

React to agent lifecycle events

Agents emit events you can listen to – track progress, log activity, and extend behavior.

Quick Start

1. Simple Usage

   import { Agent } from 'praisonai';
   
   const agent = new Agent({
     instructions: 'You are a helpful assistant'
   });
   
   agent.on('message', (event) => {
     console.log('Agent said:', event.content);
   });
   
   agent.on('tool_call', (event) => {
     console.log('Tool used:', event.name);
   });
   
   await agent.chat('Search for weather');

2. With Configuration

   agent.on('*', (event) => {
     console.log(`[${event.type}]`, event.data);
   });

User Interaction Flow

Configuration Levels

// Level 1: Method - Simple listener
agent.on('message', (e) => console.log(e));

// Level 2: Array - Multiple events
agent.on(['start', 'complete'], (e) => {
  console.log(`${e.type} at ${e.timestamp}`);
});

// Level 3: Instance - Event bus
import { AgentEventBus } from 'praisonai';

const bus = new AgentEventBus();

bus.subscribe('agent.*', (event) => {
  sendToAnalytics(event);
});

const agent = new Agent({ eventBus: bus });

Event Types

API Reference

Best Practices

Related