Files · Multi-Agent Observability for Small Business Support

# Multi-Agent Observability for Small Business Support
 
Get a unified dashboard of every AI agent your business runs, tracking latency, cost, and failure patterns so you never lose a customer conversation.
 
## Architecture
 
```
┌─────────────────────────────────────────────────────────────┐
│                    Small Business Support                    │
├─────────────────────────────────────────────────────────────┤
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐  │
│  │  Support Bot  │  │Lead Qualifier│  │Appointment Setter│  │
│  └──────┬───────┘  └──────┬───────┘  └───────┬──────────┘  │
│         │                  │                  │             │
│  ┌──────┴──────────────────┴──────────────────┴──────────┐ │
│  │              REAA Observability Layer                  │ │
│  │  agent-runbook-obs  |  eval-harness-obs  |  mesh-obs  │ │
│  │  budget-otel-bridge |  replay-core                     │ │
│  └──────────────────────────┬─────────────────────────────┘ │
│                             │                               │
│  ┌──────────────────────────┴─────────────────────────────┐ │
│  │              OpenTelemetry Collector                    │ │
│  └──────────────────────────┬─────────────────────────────┘ │
│                             │                               │
│  ┌──────────────────────────┴─────────────────────────────┐ │
│  │                    Langfuse                             │ │
│  │              Traces | Observations | Costs              │ │
│  └──────────────────────────┬─────────────────────────────┘ │
│                             │                               │
│  ┌──────────────────────────┴─────────────────────────────┐ │
│  │              Next.js Dashboard                          │ │
│  │          Cost/Latency charts | Replay viewer            │ │
│  └─────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
```
 
## Setup
 
1. Clone the repository.
2. Copy `.env.example` to `.env` and fill in your values.
3. Install dependencies:
   ```bash
   pnpm install
   ```
4. Start the development server:
   ```bash
   pnpm dev
   ```
 
## Environment Variables
 
| Variable | Description |
|----------|-------------|
| `LANGFUSE_PUBLIC_KEY` | Langfuse project public key |
| `LANGFUSE_SECRET_KEY` | Langfuse project secret key |
| `LANGFUSE_HOST` | Langfuse host URL (self-hosted or cloud) |
| `OTEL_EXPORTER_OTLP_ENDPOINT` | OpenTelemetry Collector endpoint |
| `SLACK_WEBHOOK_URL` | Slack webhook URL for alerting |
| `CRON_SECRET` | Secret for cron job authentication |
| `LOG_LEVEL` | Pino log level (default: info) |
 
## Running Tests
 
```bash
pnpm test              # Run tests
pnpm test:coverage      # Run tests with coverage
pnpm typecheck          # TypeScript type checking
pnpm lint               # ESLint
```
 
## License
 
MIT