Agenten konfigurieren

Die gesamte Agenten-Konfiguration erfolgt im Customer Portal unter portal.connector.mateit.de/agents.

Agent erstellen

Schritt 1: Agent-Typ wählen

Klicken Sie auf „Neuen Agent erstellen" und wählen Sie den gewünschten Typ:

Typ Aufgabe
Optimizer Produkttexte optimieren und verbessern
Translator Inhalte in Zielsprachen übersetzen
Categorizer Produkte in Kategorien einordnen
E-Commerce HTML-Shop-Beschreibungen erstellen

Schritt 2: Felder auswählen

Wählen Sie, welche Produktfelder dieser Agent bearbeiten soll. Die verfügbaren Felder hängen vom Agent-Typ ab.

Beispiele:

  • Optimizer: Produktname, Kurzbeschreibung
  • Translator: Alle textbasierten Felder
  • E-Commerce: Shop-Beschreibung (HTML)

Schritt 3: Name und Beschreibung

Geben Sie Ihrem Agent einen aussagekräftigen Namen (z.B. „Marketing-Optimizer" oder „DE→EN Translator").

Optional können Sie eine Beschreibung hinzufügen, um den Zweck des Agents zu dokumentieren.

Schritt 4: Erstellen

Klicken Sie auf „Erstellen". Der Agent ist sofort aktiv und beginnt, neue Produkte automatisch zu verarbeiten.

Agent konfigurieren

Custom Instructions

Unter dem Tab „Prompts" können Sie individuelle Anweisungen für jeden Agent hinterlegen:

  • Custom Instructions: Ihre eigenen Anweisungen, die der Agent bei jeder Verarbeitung berücksichtigt

Beispiele für gute Instructions:

Agent-Typ Beispiel-Anweisung
Optimizer „Schreibe Beschreibungen für technische Einkäufer, nicht für Endverbraucher"
Translator „Verwende ‚Sie’ statt ‚Du’. IT-Fachbegriffe nicht übersetzen."
Categorizer „Peripheriegeräte immer unter ‚Zubehör’ einordnen"
E-Commerce „Nutze Bullet-Points für technische Daten. Maximal 3 Absätze."

Abhängigkeiten konfigurieren

Unter „Konfiguration" können Sie festlegen, welche anderen Agenten vor diesem Agent ausgeführt werden müssen.

Typisches Beispiel:

  • Der Translator-Agent hängt vom Optimizer-Agent ab → Der Optimizer optimiert zuerst den Text, dann übersetzt der Translator das Ergebnis.

So konfigurieren Sie eine Abhängigkeit:

  1. Agent öffnen → Tab „Konfiguration"
  2. Im Bereich „Abhängigkeiten" die vorausgesetzten Agenten auswählen
  3. Speichern

!!! warning “Hinweis”
Zirkuläre Abhängigkeiten (Agent A wartet auf B, Agent B wartet auf A) werden automatisch verhindert.

Agent aktivieren / pausieren

Jeder Agent kann jederzeit pausiert werden:

  • Aktiv: Agent verarbeitet neue Produkte automatisch
  • Pausiert: Agent ist inaktiv, bereits verarbeitete Daten bleiben erhalten

Klicken Sie auf den Status-Button im Agent-Header, um zwischen aktiv und pausiert zu wechseln.

Agent testen

Im Tab „Konfigurieren" finden Sie eine Test-Oberfläche:

  1. Öffnen Sie den gewünschten Agent
  2. Wechseln Sie zum Tab „Konfigurieren"
  3. Nutzen Sie das Chat-Interface, um den Agent mit Beispieldaten zu testen
  4. Prüfen Sie das Ergebnis, bevor Sie den Agent auf alle Produkte anwenden

Ausführungshistorie

Im Tab „Runs" sehen Sie eine chronologische Liste aller Ausführungen:

  • Datum — Wann wurde der Agent ausgeführt?
  • Status — Erfolgreich, In Bearbeitung oder Fehlgeschlagen
  • Felder verarbeitet — Welche Produktfelder wurden bearbeitet?
  • Credits verbraucht — Kosten dieser Ausführung

Sie können nach Status filtern und Details zu einzelnen Ausführungen einsehen.

Best Practices

  1. Klein starten — Beginnen Sie mit einem Agent und wenigen Feldern
  2. Testen — Nutzen Sie die Test-Oberfläche, bevor Sie Live gehen
  3. Instructions anpassen — Je spezifischer Ihre Anweisungen, desto bessere Ergebnisse
  4. Abhängigkeiten nutzen — Lassen Sie den Translator auf optimierte Texte arbeiten
  5. Monitoring — Prüfen Sie regelmäßig die Runs-Historie auf Fehler

Häufige Fragen

Kann ich mehrere Agenten desselben Typs erstellen?
Ja. Sie können z.B. separate Optimizer-Agenten mit unterschiedlichen Instructions für verschiedene Produktgruppen erstellen.

Was passiert, wenn ich einen Agent lösche?
Bereits verarbeitete Produktdaten bleiben erhalten. Der Agent verarbeitet lediglich keine neuen Produkte mehr.

Wo aktiviere ich die KI-Funktion grundsätzlich?
Die grundsätzliche Aktivierung erfolgt in Odoo unter Einstellungen → ITscope Connector → KI-Optimierung. Die detaillierte Agent-Konfiguration dann im Portal.

!!! info “Support”
Bei Fragen zur Agenten-Konfiguration wenden Sie sich an support@mateit.de.