Back to documentation

Advanced Technical Documentation

CTO Edition v2.0
Active

Multi-Agent Business Intelligence System

Complete technical documentation of the Sergenta AI Lead Intelligence Platform. Architecture, agent inventory, scaling strategy and roadmap for horizontal extension.

1. Executive Summary

Die Plattform ist eine Multi-Agent Intelligence & Automation Platform, die entwickelt wurde, um wissensintensive Vertriebs-, Markt- und Geschäftsentwicklungsprozesse weitgehend zu automatisieren.

Im Gegensatz zu klassischen CRM-, Lead-Management- oder Reporting-Systemen speichert die Plattform nicht lediglich bestehende Informationen, sondern generiert kontinuierlich neue Erkenntnisse, Geschäftschancen und Handlungsempfehlungen aus einer Vielzahl strukturierter und unstrukturierter Datenquellen.

Der technologische Kern besteht aus einer Event-Driven Multi-Agent Architecture, in welcher spezialisierte KI-Agenten Informationen erkennen, anreichern, validieren, klassifizieren, priorisieren und in konkrete Geschäftsmöglichkeiten umwandeln.

Signale werden zu Informationen.
Informationen werden zu Wissen.
Wissen wird zu Geschäftschancen.

Der aktuell demonstrierte Anwendungsfall basiert auf Bauprojekten und öffentlichen Publikationen. Die Plattform selbst ist jedoch nicht auf einzelne Datenquellen, Branchen oder Anwendungsfälle beschränkt. Die zugrunde liegende Architektur kann für unterschiedliche Geschäftsbereiche eingesetzt werden, darunter:

Vertrieb & Geschäftsentwicklung
Markt- und Wettbewerbsintelligenz
Partner- und Netzwerkausbau
Lieferanten- und Beschaffungsmanagement
Projekt- und Opportunity-Management
Export- und Markterschliessung
Branchen- und Marktmonitoring
Wissensmanagement

Produktivitätsziele für die Sergenta AI

Für die Sergenta AI steht insbesondere die Produktivitätssteigerung des Vertriebs im Mittelpunkt. Mitarbeitende im Aussendienst investieren heute rund 40 % ihrer Arbeitszeit in Recherche, Projektidentifikation, Informationsbeschaffung, Vorqualifikation und Kontaktfindung – Zeit, in der keine Kundengespräche, Projektbesuche oder direkten Umsatzaktivitäten entstehen.

Die Plattform wurde entwickelt, um diesen Anteil von heute rund 40 % auf künftig 3–5 % zu reduzieren. Dadurch entsteht zusätzliche Kapazität für Kundenkontakte, Projektbesuche, Beratung, Angebotswesen, Verhandlungen, Geschäftsentwicklung und Abschlüsse.

40%
Recherche-Anteil heute
der Arbeitszeit
3–5%
Recherche-Anteil künftig
der Arbeitszeit
CHF 4 Mio
Umsatz heute / MA
pro Jahr
CHF 6 Mio
Umsatz-Potenzial / MA
pro Jahr (+50%)

Der eigentliche Wettbewerbsvorteil entsteht dabei nicht durch einzelne Datenquellen oder einzelne Agenten, sondern durch den kontinuierlichen Aufbau eines unternehmensspezifischen Wissens- und Intelligence-Systems, welches mit jeder Interaktion, jedem Projekt, jedem Kontakt und jeder Marktinformation intelligenter wird.

Unternehmen, die solche Systeme frühzeitig einsetzen, schaffen sich einen nachhaltigen Informations-, Geschwindigkeits- und Produktivitätsvorsprung gegenüber Mitbewerbern, die weiterhin überwiegend manuell recherchieren, analysieren und qualifizieren.

Die Plattform ist deshalb weder als CRM noch als isoliertes Lead-Management-System zu verstehen. Sie ist als intelligentes Betriebssystem für datengetriebene Vertriebs-, Markt- und Geschäftsentwicklung konzipiert.

2. System Architecture

Das System ist in vier logische Schichten unterteilt. Jede Schicht ist entkoppelt und über Entity-Events asynchron verbunden.

Architecture Overview: 4-Layer Model
Layer 1
Data Sources
Öffentliche Publikationsportale
XML / REST Feeds
Handels- & Unternehmensregister
Registry APIs
OpenData
Geodata & Public Datasets
Layer 2
Ingestion & Enrichment
Import Agents
Data Pull & Parse
Enrichment Agents
XML / HTML Processing
Validation Agents
Quality Checks
Layer 3
Orchestration
Event Bus
Entity-Triggered Automations
Pipeline Coordinator
Status-Based Flow Control
Layer 4
Entities
Lead Intelligence
Structured Records
Knowledge Base
Accumulated Intelligence

Layer 1: Data Sources

Öffentliche Publikationsportale (XML/REST), Handels- & Unternehmensregister, Web-Scraper, PDF-Dokumente, OpenData. Alle Quellen sind public-sector APIs ohne Authentifizierung oder mit einfachem API-Key.

Layer 2: Ingestion & Enrichment

Import- und Enrichment-Agenten ziehen Rohdaten, parsen XML, extrahieren strukturierte Felder und legen Entities an. Voll asynchron, fehlerisoliert.

Layer 3: Orchestration

Base44 Automations fungieren als Event-Bus. Entity-Statusänderungen (create/update) triggern automatisch die nächsten Agenten. Kein zentraler Orchestrator-Service nötig.

Layer 4: Entities

Single-Source-of-Truth. Strikt typisierte JSON-Schema-Entities (Lead, IntelligenceCompany, KnowledgeEntry etc.) mit Built-in Realtime-Subscriptions für UI-Updates.

3. Agent Pipeline: Data-to-Lead Flow

Die Kernpipeline verarbeitet ein rohes Baugesuch in 6 Stufen zum qualifizierten Lead. Jede Stufe ist ein unabhängiger Agent, der über den data_research_status des Leads kommuniziert.

Pipeline Flow: 6 Stages
Agent Pipeline Flowchart - 6 stages from OpenData Ingest to Qualified Lead with Feedback Loop
1
openDataImportAgent
Neu

REST/XML-Pull vom Amtsblattportal, legt OpenDataPublication + Lead an.

2
openDataEnrichAgent
In Recherche

XML-Parsing, extrahiert Bauherrschaft/Projektverfasser, aktualisiert Lead.

3
researchAgent
In Recherche

LLM-Web-Recherche für Website, E-Mail, Telefon, LinkedIn.

4
zefixAutoCheck
Teilweise qualifiziert

ZEFIX-Lookup: UID, Rechtsform, Gründungsjahr, Adresse.

5
calculateOpportunityValue
Teilweise qualifiziert

Berechnet Materialwert, Opportunity-Score, Hot/Warm/Cold.

6
Final Status Update
Qualifiziert

Pipeline schließt ab mit finaler Status-Setzung basierend auf Datenqualität.

4. Agent Inventory (20+)

Alle registrierten Backend-Functions mit Typ, Trigger-Modell und Status. Agenten sind in Domain-Logik (Bau/Architektur) und Utility-Logik (Sync, Scoring) unterteilt.

openDataImportAgent
Ingestion
Produktiv

Pullt Baugesuchs-Publikationen vom Amtsblattportal via REST/XML-API und legt Rohdaten als OpenDataPublication-Entities ab.

Deno · fetch · XML-ParserScheduled / Manuell
openDataEnrichAgent
Enrichment
Produktiv

Parst Amtsblatt-XML, extrahiert Bauherrschaft & Projektverfasser, reichert Lead an und triggert Research + ZEFIX Pipeline synchron.

Deno · XML Regex · SDKEntity-Automation / HTTP
researchAgent
Research
Produktiv

LLM-gestützte Web-Recherche für Architekturbüros & Bauherrschaften: Website, E-Mail, Telefon, LinkedIn.

Deno · InvokeLLM · Web-SearchPipeline / Manuell
zefixAutoCheck
Validation
Produktiv

Automatischer ZEFIX-Handelsregister-Lookup: UID, Rechtsform, Gründungsjahr, Sitz für Architekt & Bauherrschaft.

Deno · ZEFIX REST APIPipeline / Manuell
validationAgent
Validation
Produktiv

Plausibilitätsprüfung: Validiert extrahierte Kontaktdaten gegen Quelldaten und markiert Dubletten.

Deno · SDKEntity-Automation
intelligenceSearchAgent
Intelligence
Produktiv

Durchsucht Branchenverzeichnisse und Websites nach Firmen im Bau/Architektur-Umfeld und legt IntelligenceCompany-Records an.

Deno · Web-Crawl · LLMManuell / Scheduled
intelligenceWebsiteAnalyzer
Intelligence
Produktiv

Analysiert Firmenwebsites: extrahiert Kontaktdaten, Spezialisierungen, Referenzprojekte und LinkedIn-Profile.

Deno · InvokeLLM · HTMLEntity-Automation
intelligenceCrmSync
Sync
Produktiv

Synchronisiert IntelligenceCompany-Daten mit CustomerRecord-Entities für CRM-Matching.

Deno · SDKScheduled / Manuell
intelligenceDuplicateCheck
Quality
Produktiv

Erkennt Dubletten in IntelligenceCompany über Domain- und UID-Matching und markiert diese.

Deno · Hash-MatchingEntity-Automation
architectAgent
Research
Produktiv

Spezialisierter Recherche-Agent für Architekten: ZEFIX-Lookup, Website-Analyse, Kontaktdaten-Extraktion.

Deno · ZEFIX · LLMManuell
architectIntelligenceAgent
Intelligence
Produktiv

Erweiterte Architekten-Analyse: Projekte, Referenzen, Spezialisierungen, Mitarbeiterzahl.

Deno · Web-Crawl · LLMManuell
builderAgent
Research
Produktiv

Recherche-Agent für Bauherrschaften: ZEFIX-Daten, Unternehmenshintergrund, Entscheidungsfindungsstruktur.

Deno · ZEFIX · LLMManuell
outreachAgent
Output
Produktiv

Generiert personalisierte B2B-Kommunikationsentwürfe (E-Mail, Brief) basierend auf Lead-Daten und Knowledge Base.

Deno · InvokeLLM · KnowledgeBaseManuell
knowledgeAgent
Knowledge
Produktiv

Verarbeitet hochgeladene Dokumente (PDF, URL) zu strukturierten KnowledgeEntry-Records mit KI-Zusammenfassung.

Deno · ExtractData · LLMEntity-Automation
escalationAgent
Monitoring
Produktiv

Überwacht Pipeline auf Eskalationsfälle (Hot-Lead unbehandelt, Fristen, unbeantwortete Antworten) und erstellt Escalation-Records.

Deno · SDK · Rule-EngineScheduled
calculateOpportunityValue
Scoring
Produktiv

Berechnet Materialwert, Opportunity-Score und Kategorie (Hot/Warm/Cold) basierend auf Gebäudedaten.

Deno · FormelnEntity-Automation
searchAgent
Discovery
Produktiv

Durchsucht municipale Quellen (Gemeinde-Websites, Amtsblätter) nach neuen Baugesuchen.

Deno · Web-Crawl · LLMManuell / Scheduled
sourceDiscoveryAgent
Discovery
Produktiv

Findet und validiert Baugesuch-Quellen für Gemeinden und legt MunicipalitySource-Records an.

Deno · Web-Search · LLMManuell
openDataDailyImport
Scheduled
Produktiv

Täglicher automatisierter Import neuer Baugesuchs-Publikationen vom Amtsblattportal.

Deno · AutomationScheduled (täglich)
openDataLeadEnrichTrigger
Automation
Produktiv

Entity-Automation: Reagiert auf neue OpenData-Leads und triggert die Enrichment-Pipeline automatisch.

Deno · SDKEntity (create)

5. Scalability & Design Principles

Die Architektur folgt bewährten verteilten System-Prinzipien. Skalierung erfolgt horizontal ohne architektonische Anpassungen.

Event-Driven Architecture

Agenten kommunizieren über Entity-Statusänderungen, nicht über direkte API-Calls. Jede Statusänderung löst den nächsten Pipelineschritt aus.

Serverless (Deno Deploy)

Alle Agenten laufen als isolierte Deno-Functions. Horizontale Skalierung ohne Server-Management.

Schema-First Data Model

Strikte JSON-Schema-Validierung auf Entity-Ebene garantiert Datenkonsistenz über die gesamte Pipeline.

Service-Role Isolation

Trennung von User-Scope und Service-Role. Agenten operieren mit elevated permissions, User-Aktionen sind scoped.

Implicit Queueing

Entity-Events fungieren als natürliche Queue. Bei Überlastung wächst die 'Neu'-Liste = Backpressure ohne Deadlocks.

Observability via AgentRun

Jede Agenten-Ausführung wird mit Log, Status, Duration und Error in der AgentRun-Entity persistiert.

6. Data Model & Entity Strategy

Die Plattform nutzt 15+ Entity-Typen, die über Fremdschlüssel (String-IDs) verknüpft sind. Jede Entity hat Built-in-Attribute: id, created_date, updated_date, created_by_id.

Pipeline Entities

  • • OpenDataPublication
  • • OpenDataSource
  • • OpenDataImportJob
  • • Lead
  • • LeadArchive

Intelligence Entities

  • • IntelligenceCompany
  • • IntelligenceContact
  • • IntelligenceProject
  • • IntelligenceSource
  • • IntelligenceAgentRun

System Entities

  • • AgentRun (Observability)
  • • Activity (Audit Log)
  • • Escalation
  • • Notification
  • • KnowledgeEntry / Source
  • • Task, Municipality, OutreachDraft

7. Security & Governance

Authentication & Authorization

JWT-basierte Authentifizierung über Base44 Auth. Rollenmodell: admin (Vollzugriff, User-Management) und user (eingeschränkter Zugriff). ProtectedRoutes leiten unauthentifizierte User zum Login weiter.

Service-Role Isolation

Agenten nutzen base44.asServiceRole für elevated Operations (Entity-Creations, Updates). User-Aktionen nutzen den User-Scope (base44.entities...). Strikte Trennung verhindert Privilege-Escalation.

External API Handling

Externe APIs (Amtsblattportal, ZEFIX) werden mit AbortSignal.timeout(20000) abgesichert. Errors werden pro Agent isoliert und im AgentRun.log persistiert. Pipeline bricht bei Einzelfehler nicht global ab.

8. Technology Stack

LayerTechnology
FrontendReact 18 · Vite · Tailwind CSS · shadcn/ui · TanStack Query · Recharts · Framer Motion
BackendDeno Deploy (Serverless Functions) · Base44 BaaS SDK @0.8.x
DatenbankBase44 Entity Store (JSON-Schema-basiert, NoSQL)
AuthBase44 Auth (JWT, Email-Verification, Role-based Access)
LLM / AIInvokeLLM Integration (GPT-4o-mini, Claude Sonnet, Gemini Flash)
External APIsÖffentliche Publikationsportale (REST/XML) · Handels- & Unternehmensregister · Web-Search
AutomationsEntity-Triggered · Scheduled (Cron) · Connector-Webhooks
File ProcessingUploadFile · ExtractDataFromUploadedFile (PDF, Excel, CSV, JSON)

9. Roadmap & Extension Potential for Sergenta AI

1

Phase 1 – Vertriebsintelligenz & Markttransparenz (0–6 Monate)

Ziel:

Reduktion des manuellen Rechercheaufwands von heute rund 40 % auf unter 5 %.

Umsetzung:

Automatische Erkennung von Neubau-, Umbau- und Sanierungsprojekten
Identifikation von Bauherrschaften, Architekten und Generalunternehmern
Automatische Anreicherung von Entscheidern und Kontaktdaten
Personalisierte Kontaktaufnahme durch den Knowledge Agent
Opportunity-Scoring nach Projektpotenzial
Frühzeitige Identifikation relevanter Projekte
Automatische Einladungen zu Erstgesprächen, Events und Fachveranstaltungen
Integration in bestehende Vertriebsprozesse

Nutzen:

Mehr Kundentermine
Höhere Marktabdeckung
Kürzere Reaktionszeiten
Weniger Rechercheaufwand
Höhere Produktivität pro Aussendienstmitarbeiter
2

Phase 2 – Markt- und Partnerintelligenz (6–12 Monate)

Ziel:

Aufbau eines vollständigen Markt- und Partnernetzwerks.

Erweiterung um:

Fassadenbauer
Holzbauunternehmen
Gebäudehüllenspezialisten
Dachdecker
Planungsbüros
Ingenieurbüros
Installationsbetriebe
GU/TU
Projektentwickler

Agentenfunktionen:

Partneridentifikation
Partnerbewertung
Marktpotenzialanalyse
Gebietsanalyse
Wettbewerbsanalyse
Umsatzpotenzial je Region

Nutzen:

Höhere Marktdurchdringung
Zusätzliche Absatzkanäle
Frühzeitige Projektinformationen
Bessere Zusammenarbeit in der Wertschöpfungskette
3

Phase 3 – Produkt- und Projektintelligenz (12–18 Monate)

Ziel:

Automatische Erkennung von Produktpotenzialen innerhalb von Projekten.

Funktionen:

Analyse von Projektgrössen
Schätzung von Materialbedarf
Zuordnung geeigneter Produktgruppen
Priorisierung nach Umsatzpotenzial
Erkennung von Fassadenprojekten
Erkennung von Holzbauprojekten
Erkennung von Sanierungsprojekten
Erkennung von energetischen Modernisierungen

Nutzen:

Gezielter Vertrieb
Höhere Abschlusswahrscheinlichkeit
Bessere Ressourcenplanung
Fokus auf Projekte mit hohem Deckungsbeitrag
4

Phase 4 – Export & Internationale Geschäftsentwicklung (18–24 Monate)

Ziel:

Aufbau neuer Absatzmärkte ausserhalb der Schweiz.

Funktionen:

Identifikation von Generalimporteuren
Identifikation von Distributoren
Identifikation von Vertriebspartnern
Identifikation von Generalunternehmern
Marktanalysen Europa
Marktanalysen Nordamerika
Marktanalysen Asien
Automatisierte Partneransprache

Nutzen:

Neue Absatzmärkte
Höhere Marktpräsenz
Internationale Skalierung
Schnellere Markterschliessung
5

Phase 5 – Unternehmensweites Intelligence Operating System (24–36 Monate)

Ziel:

Zentrale Wissens- und Entscheidungsplattform für die gesamte Sergenta AI.

Integration von:

Vertrieb
Marketing
Produktmanagement
Geschäftsleitung
Marktbeobachtung
Projektmonitoring

Agenten unterstützen bei:

Marktveränderungen
Wettbewerbsbeobachtung
Projektfrühwarnungen
Chancenidentifikation
Wissensmanagement
Strategischen Entscheidungen

Nutzen:

Unternehmensweites Wissen
Einheitliche Datenbasis
Schnellere Entscheidungen
Nachhaltiger Wettbewerbsvorteil

Langfristige Vision

Die Plattform entwickelt sich von einer Projekt- und Vertriebsintelligenz-Lösung zu einem digitalen Intelligence Operating System der Sergenta AI.

Jeder neue Kontakt, jedes Projekt, jede Interaktion und jede Marktinformation erweitert den Wissensbestand der Plattform.

Dadurch entsteht ein strategischer Daten- und Wissensvorsprung, der sich über Jahre hinweg kontinuierlich vergrössert und nur schwer von Mitbewerbern reproduziert werden kann.

Das Ziel ist nicht die Digitalisierung bestehender Prozesse.

Das Ziel ist die Schaffung eines intelligenten, datengetriebenen Betriebssystems für Marktbearbeitung, Geschäftsentwicklung und Wachstum der Sergenta AI.

Sergenta AI Agent · Multi-Agent Business Intelligence System · Technical Documentation v2.0

Privacy & Cookies

We use cookies to optimise your experience, analyse performance, and enhance AI-powered features. You can manage your preferences at any time.

Privacy PolicyVersion 2.0