Areti Core — KI-Anreicherung (OpenAI)

Dieser Leitfaden erklärt, was die KI-gestützte Lead-Anreicherung in Areti Core macht, wie du deinen eigenen OpenAI-API-Key einrichtest, was wir damit übertragen und wie du die Integration wieder entfernst. Die Integration läuft über OpenAI Ireland Ltd. (EU).

Was die Integration leistet

Areti Core bietet eine optionale Funktion „Daten-Anreicherung": Du gibst eine Unternehmens-URL an, und Areti zieht öffentlich zugängliche Inhalte der Website, lässt sie von einem OpenAI-Modell analysieren und befüllt anschließend Lead-Felder automatisch — Branche, Firmengröße, Produktkategorie, Ansprechpartner, kurzer Pitch.

Typische Einsätze:

Eingehende Intake-Webhooks — sobald ein neuer Lead aus einem Formular, einem Chat-Bot oder einer Ad-Kampagne in Areti landet, startet die KI-Anreicherung automatisch.
Massen-Anreicherung — du markierst mehrere Leads in der Lead-Tabelle und löst die Anreicherung per Batch aus.
Einzelner Lead — auf einem Lead-Detail-Screen kannst du Anreicherung jederzeit manuell starten.

Die Anreicherung ist kein LLM-Gimmick oben drauf. Sie läuft als klar definierter Workflow in der CORTEX Engine, mit Vorverarbeitung, strukturierter Schema-Validierung und automatischem Merge in bestehende Lead-Felder.

Was du brauchst

Ein Areti-Core-Workspace mit Admin-Rechten.
Ein OpenAI-Account unter https://platform.openai.com.
Zahlungsmethode bei OpenAI hinterlegt. Die Nutzung der Anreicherung verbraucht Tokens in deinem OpenAI-Account. Aktuelle Preise: https://openai.com/api/pricing/
Ein API-Key aus deinem OpenAI-Account.

Hinweis zur Datenresidenz: Wenn du eine EU-Datenverarbeitung wünschst, wähle bei OpenAI einen europäischen Organizations-Standort (Dashboard → Settings → Organization → Data residency → Europe). Bei EU-residency werden API-Anfragen ausschließlich in EU-Rechenzentren verarbeitet.

API-Key bei OpenAI erstellen

Melde dich bei https://platform.openai.com an.
Öffne Dashboard → API keys (https://platform.openai.com/api-keys).
Klicke Create new secret key.
Gib einen sprechenden Namen ein, z.B. ares-production.
(Optional) Wähle ein Projekt, wenn du Usage pro Projekt tracken willst.
(Empfohlen) Schränke die Rechte auf Restricted ein und erlaube nur die Scopes, die Areti benötigt: Model capabilities → Write für Text-Generierung.
Klicke Create secret key. OpenAI zeigt den Key genau einmal an. Kopiere ihn sofort.

Wichtig: Der API-Key gibt jedem, der ihn besitzt, Zugriff auf deinen OpenAI-Account und verursacht Kosten. Gib ihn niemals weiter, committe ihn nicht in Git-Repos und poste ihn nicht in Chats.

Key in Areti Core hinterlegen

Melde dich in Areti Core als Administrator an.
Öffne Einstellungen → Integrationen → OpenAI.
Füge den API-Key in das Feld OpenAI API Key ein.
(Optional) Wähle das zu verwendende Modell. Standard ist ein aktuelles kosteneffizientes Modell; Power-User können auf ein größeres Modell umstellen.
(Optional) Setze ein Monats-Budget in USD. Wenn das Budget erreicht ist, stoppt Areti alle weiteren Anreicherungs-Calls bis zum nächsten Monat.
Klicke Verbinden.

Areti testet den Key mit einem minimalen Probe-Call gegen models.list. Bei Erfolg wird der Key verschlüsselt in der EU-gehosteten Supabase-Datenbank gespeichert und die Integration ist aktiv.

Tägliche Nutzung

Manuelle Anreicherung eines Leads

Öffne einen Lead im Lead-Detail-Screen.
Klicke KI-Anreicherung starten.
Areti zeigt einen Vorschlag für jedes Feld an, das es vorschlägt zu befüllen.
Du kannst Vorschläge einzeln akzeptieren, ablehnen oder manuell editieren, bevor sie gespeichert werden.

Automatische Anreicherung eingehender Leads

In Einstellungen → Intake → Auto-Anreicherung kannst du festlegen, dass neu eingehende Leads automatisch durch die Anreicherung laufen sollen. Das passiert im Hintergrund — Vertriebler sehen den Lead erst, wenn er angereichert ist.

Massen-Anreicherung

Öffne Leads.
Markiere die gewünschten Zeilen per Checkbox.
Klicke Bulk-Aktionen → KI-Anreicherung.
Areti verarbeitet die Leads seriell und zeigt Fortschritt und Kosten an.

Welche Daten an OpenAI übertragen werden

An OpenAI übermittelt:

Die vom Nutzer angegebene Unternehmens-URL
Textinhalt der öffentlich zugänglichen Seiten dieser URL (Homepage, About, Impressum, Produkt-Seiten)
Ein Prompt mit dem strukturierten Schema der Lead-Felder

Nicht an OpenAI übermittelt:

Lead-Namen, E-Mail-Adressen oder Telefonnummern aus der Areti-Datenbank
Interne Notizen, Aktivitäten, Termine, Angebote
Daten anderer Leads oder Kunden im selben Workspace

OpenAI Ireland Ltd. ist Vertragspartner für EU-Kunden. API-Daten werden nicht zum Training der OpenAI-Modelle verwendet (Zero-Data-Retention-Modus).

Kosten und Budget-Kontrolle

Die Anreicherung verursacht Kosten in deinem OpenAI-Account. Die Höhe hängt vom gewählten Modell und der Länge der verarbeiteten Website ab, liegt aber typischerweise im niedrigen Cent-Bereich pro Lead.

Monats-Budget — in Einstellungen → Integrationen → OpenAI kannst du ein hartes monatliches Limit in USD setzen. Bei Erreichen stoppt Areti alle Anreicherungen bis zum nächsten Monat.
Usage-Dashboard — unter Einstellungen → Integrationen → OpenAI zeigt Areti die im aktuellen Monat verbrauchten Tokens und den USD-Betrag.
Rate-Limiting — Areti drosselt Massen-Anreicherungen, um OpenAI-Rate-Limits und deine Rechnung unter Kontrolle zu halten.

API-Key ersetzen oder entfernen

Ersetzen (z.B. nach Rotation)

Öffne Einstellungen → Integrationen → OpenAI.
Klicke Key ersetzen.
Füge den neuen Key ein und speichern.

Entfernen

Öffne Einstellungen → Integrationen → OpenAI.
Klicke Verbindung trennen.
Bestätige.

Areti löscht den gespeicherten Key sofort aus der Datenbank. Laufende Anreicherungs-Jobs brechen ab. Künftige Anreicherungs-Versuche zeigen einen Hinweis, dass kein Key hinterlegt ist.

Zusätzlich: Widerrufe den Key auch bei OpenAI unter https://platform.openai.com/api-keys, falls du dir nicht sicher bist, wo er sonst noch im Einsatz sein könnte.

Fehlerbehebung

„Ungültiger API-Key"

Der Key ist abgelaufen, wurde in OpenAI widerrufen oder falsch eingefügt. Lösung: neuen Key erstellen und in Areti einfügen.

„Rate Limit erreicht"

Dein OpenAI-Account ist aktuell über dem zulässigen Request-Limit. Ursachen: zu viele parallele Anreicherungen oder ein Limit deines OpenAI-Plans. Lösung: warte einige Minuten, reduziere die Batch-Größe oder upgrade deinen OpenAI-Plan.

„Budget überschritten"

Das in Areti gesetzte Monats-Budget ist erreicht. Erhöhe das Budget oder warte auf den nächsten Monat.

„Anreicherung liefert keine Ergebnisse"

Mögliche Ursachen:

Die Ziel-URL ist nicht erreichbar oder hat eine leere Startseite.
Die Website blockiert Bot-Crawler (User-Agent-Filter).
Der OpenAI-Response war unerwartet und konnte nicht gegen das Schema validiert werden.

Öffne im Lead den Anreicherungs-Log für die exakte Fehlermeldung. Bei wiederkehrenden Problemen: support@areti.de.

Support

Bei Problemen, die hier nicht beschrieben sind, schreib uns an support@areti.de mit Workspace-Namen, Lead-ID und der genauen Fehlermeldung aus dem Anreicherungs-Log.

Anbieter

Areti Core wird von der ARETI GmbH entwickelt und betrieben. Die KI-Anreicherung läuft über OpenAI Ireland Ltd., 1st Floor, The Liffey Trust Centre, 117-126 Sheriff Street Upper, Dublin 1, Irland. Details zur Datenverarbeitung findest du in unserer Datenschutzerklärung.

Firma: ARETI GmbH Adresse: Saarstraße 7, 80797 München, Deutschland Handelsregister: Amtsgericht München, HRB 248858 Support: support@areti.de