lindy-reference-architecture

# Lindy Reference Architecture ## Overview Production-ready architecture patterns for integrating Lindy AI agents into applications. Covers webhook integration, multi-agent societies, event-driven pipelines, and high-availability patterns. ## Prerequisites - Understanding of Lindy agent model (triggers, actions, skills) - Familiarity with webhook-based architectures - Production requirements defined (throughput, latency, reliability) ## Architecture 1: Simple Webhook Integration Single agent triggered by your application, results sent via callback. ``` ┌─────────────┐ POST (webhook) ┌──────────────┐ │ Your App │ ─────────────────────────→ │ Lindy Agent │ │ │ │ │ │ /callback │ ←───────────────────────── │ HTTP Request │ │ │ POST (callback) │ Action │ └─────────────┘ └──────────────┘ ``` **Implementation**: - Your app sends webhook with `callbackUrl` field - Lindy agent processes and responds via Send POST Request to Callback - Your app receives results asynchronously **Best for**: Simple automations (email triage, lead scoring, content generation) ## Architecture 2: Event-Driven Pipeline Multiple event sources feed agents through a central webhook router. ``` ┌──────────┐ │ Stripe │──webhook──┐ └──────────┘ │ ▼ ┌──────────┐ ┌───────────┐ ┌──────────────┐ │ Shopify │──→ │ Router │──→ │ Lindy A...