E-Mail-Helpdesk

Überblick

Die Pipeline fragt ein IMAP-Postfach nach neuen E-Mails ab, filtert automatische Antworten und Spam mit StopProcessing Middleware, klassifiziert Nachrichten nach Anliegen, Dringlichkeit und Abteilung und entwirft kontextbezogene Antworten. Dazu können die Retrieval-Tools Inhalte abfragen, speichern und löschen. Antworten werden automatisch über die ausgehende SMTP-Verbindung versendet. Middleware übernimmt Absendermetadaten für personalisierte Antworten in den Context. Die Pipeline unterstützt mehrsprachige Antworten in der Sprache des Absenders.

Use Cases

Architektur

Wichtige Template-Dateien

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

email-helpdesk/
  agents/
    email-classifier.yaml
    email-responder.yaml
    helpdesk-pipeline.yaml
  tools/
    helpdesk_tools.py
  middleware/
    email-classifier.py
  schemas/
    email-classification.json
    email-reply.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=email-helpdesk

   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 "E-Mail-Helpdesk 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 E-Mail-Verbindung (IMAP) zum Abfragen des Postfachs und eine ausgehende E-Mail-Verbindung (SMTP) zum Versenden von Antworten hinzu. Hinterlege für beide die Zugangsdaten des Mailservers. Ein connic/* KI-Modell nutzen oder BYOK-Zugangsdaten unter Projekt Settings → LLM Provider hinterlegen.

   Vollständiger Einrichtungsleitfaden für VerbindungenQuickstart GuideDocs zu Verbindungen