Kafka-Betrugserkennung

Überblick

Ein Agent liest Transaktionen aus einem Kafka-Topic und bewertet ihr Betrugsrisiko anhand der Transaktionshäufigkeit, geografischer Anomalien und des Abgleichs mit Mustern aus dem Retrieval. Eine Bedingung beschränkt den Zugriff auf das Tool admin_override abhängig vom Kontext. Transaktionen mit derselben customer_id werden nacheinander verarbeitet, um Race Conditions zu verhindern. Warnmeldungen zu hohen Risiken werden von einem Tool-Agenten formatiert und in einem ausgehenden Kafka-Topic veröffentlicht.

Use Cases

Architektur

Wichtige Template-Dateien

Installiere diese Dateien mit connic init my-project --templates=kafka-fraud-detector. Die CLI legt die Agentendefinitionen unter agents/ in einem Ordner mit dem Namen des Templates ab.

kafka-fraud-detector/
  agents/
    fraud-scorer.yaml
    fraud-escalator.yaml
  tools/
    fraud_tools.py
  middleware/
    fraud-scorer.py
  schemas/
    fraud-assessment.json
  requirements.txt
  README.md

Loslegen

Installiere das Template, erstelle ein Connic-Projekt und starte das Deployment über ein verbundenes Git-Repository oder die CLI.

1. 1

   Installieren und Projekt anlegen

   Installiere das SDK und erstelle aus diesem Template ein Projekt.

   terminal

   Copy

   pip install connic-composer-sdk
   connic init my-project --templates=kafka-fraud-detector

   Danach cd my-project

2. 2

   Bereitstellen

   Wähle eine Deployment-Methode. Bei einem verbundenen Git-Repository startet jeder Push ein Deployment. Nutze die CLI für Projekte ohne verbundenes Git-Repository.

   Git-Integration

   1. 1

      Verbinde in Connic unter Projekt Settings → Git & Environments das GitHub-Repository

   2. 2

      Ordne auf derselben Seite den Branch (z. B. main) der Produktivumgebung zu

   3. 3

      Pushe das erzeugte Projekt in dieses Repository

   terminal

   Copy

   git add .
   git commit -m "Kafka-Betrugserkennung Template hinzufügen"
   git push origin main

   CLI Deployment

   1. 1

      Erstelle in Connic unter Projekt Settings → API Keys & MCP Auth einen API Key und kopiere die Projekt-ID

   2. 2

      Führe im Projektverzeichnis connic login aus

   3. 3

      Teste mit connic dev und Hot Reload, führe mit connic test Testsuiten aus oder starte mit connic deploy das Deployment für den Produktivbetrieb

   terminal

   Copy

   connic login
   connic dev     # Temporäre Entwicklungsumgebung mit Hot Reload
   connic test    # Deklarative Test Suites ausführen
   connic deploy  # In den Produktivbetrieb deployen

3. 3

   Verbinden und konfigurieren

   Füge eine eingehende Kafka-Verbindung für das Transaktions-Topic und eine ausgehende Kafka-Verbindung für Betrugswarnungen hinzu. Konfiguriere Bootstrap Server und optional die SASL-Authentifizierung. Ein connic/* KI-Modell nutzen oder BYOK-Zugangsdaten unter Projekt Settings → LLM Provider hinterlegen.

   Vollständiger Einrichtungsleitfaden für VerbindungenQuickstart GuideDocs zu Verbindungen