Gestalten · C3 · 6 Stufen

AI-Services und Parameter definieren

Eine wiederkehrende Aufgabe als Schablone: Eingaben rein, strukturiertes Ergebnis raus. Wir bauen die Hülle des Übersetzungs-Service — den Workflow dahinter baut C4.

Was du in diesem Tutorial baust

Wir legen den „Übersetzungs-Service" des Helpdesk-Assistenten an: Stammdaten, Parameter (Eingabefelder), Einstellungen und Veröffentlichung. Bau-Modus mit echten Reitern und Feldern als Konfigurations-Mockups.

Voraussetzung: C1 (Agent). C2 ist hilfreich, wenn dein Service Wissen nutzt. Der konzeptuelle Unterschied Chatbot ↔ Service steckt in B2; hier geht es ums Definieren. Den 4-Schritt-Workflow baut C4.

Quellen und Stand

Geprüft gegen das AuxData-Administrator-Handbuch (Stand Juni 2026), Kapitel 5 (AI-Services erstellen); Beispiel-Parameter angelehnt an Schritt-Tutorial 18.

Stufe 1 von 6

AI-Service-Manager

Wo Services entstehen.

1Die Verwaltungsseite

Der AI-Service-Manager zeigt alle Services des Agenten als Karten (Name, Kategorie, Icon). (AH 5.1)

Oben das Filterfeld und „Service anlegen"; pro Karte ein Drei-Punkte-Menü: Bearbeiten, Duplizieren, Löschen, Feedback, Service-Historie. (AH 5.1)

2Service-Typen über Flags

Services unterscheiden sich nicht formal, sondern über Flags in ihrer Konfiguration:

Background
läuft asynchron; der Nutzer bekommt einen Link in „Laufende Services".
Mail
Ergebnis wird zusätzlich per E-Mail versandt.
Intern
nur innerhalb von Workflows aufrufbar, nicht im Cockpit sichtbar.
Wiederholbar
im Cockpit als planbar markiert.
Demo: Wir legen den „Übersetzungs-Service" an — ein klassischer Vordergrund-Service mit Formular.
✎ Bauaufgabe: Welche wiederkehrende Helpdesk-Aufgabe eignet sich gut als AI-Service?

✓ Das hast du jetzt erledigt

Stufe 2 von 6

Stammdaten & Workflow-Bezug

Identität und die eine Logik dahinter.

1Reiter „Stammdaten"

StammdatenEinstellungenKategorieParameter
Stammdaten
AI-Service-Name
Übersetzungs-Service
BeschreibungCockpit-Tooltip & Marktplatz
Übersetzt Texte mit Stil- und Qualitätssicherung.
AI-Workflow
Übersetzung (4 Schritte) — wird in C4 gebaut
BildIcon für Karte & Marktplatz
Symbol wählen …
Echter AI-Service-Editor (Demo-Instanz): Stammdaten (Name, Beschreibung), Einstellungen (Mail, intern, wiederholbar), Kategorie-Baum und Parameter-Tabelle
C3-S01 · AI-Service-Editor an der Demo-Instanz — Stammdaten, Einstellungen, Kategorie und Parameter in einer Ansicht
AI-Service-Editor (offizielle Abbildung aus dem Admin-Handbuch)
Offizielle Abbildung aus dem Admin-Handbuch (Kap. 6) — der AI-Service-Editor.

2Ein Service = genau ein Workflow

Jeder AI-Service ist mit genau einem Workflow verknüpft. Für einen einzelnen LLM-Aufruf nimmst du einen Single-Step-Workflow. Wechselst du den Workflow, fragt der Editor, ob die bisherigen Parameter durch die Workflow-Parameter ersetzt werden. (AH 5.2)

Den Workflow selbst — die mehrstufige Logik — baust du in C4. Hier definierst du die Hülle.
✎ Bauaufgabe: Wie nennst du den Workflow hinter deinem Service?

✓ Das hast du jetzt erledigt

Stufe 3 von 6

Parameter definieren

Die Eingabefelder des Formulars.

1Was ein Parameter hat

Pro Eingabefeld legst du fest: Schlüssel (Prompt-Zugriff via ${parameterName}), Anzeige (Label), Typ, Pflichtfeld und Zusatzoptionen (Default, Min/Max, Regex). Die Reihenfolge änderst du per Drag-&-Drop. (AH 5.2/5.3)

StammdatenEinstellungenKategorieParameter
Parameter
${sourceText}Langtext · der zu übersetzende Text
Pflicht
${sourceLang}Auswahlliste · Default Deutsch
optional
${targetLang}Auswahlliste
Pflicht
${style}Auswahlliste · Default Neutral
optional
Parameter-Karte des AI-Service-Editors (offizielle Abbildung aus dem Admin-Handbuch)
Offizielle Abbildung aus dem Admin-Handbuch (Kap. 6) — die Parameter-Karte (Eingabefelder des Services).
Im Workflow-Prompt (C4) greifst du dann über ${sourceText}, ${targetLang} usw. auf die Eingaben zu. (AH 5.3)
Namensregel: Nutze für Schlüssel technische Namen wie sourceText oder target_lang: Buchstabe am Anfang, keine Leerzeichen, keine Bindestriche. Sichtbare deutsche Begriffe gehören ins Feld „Anzeige". (AH 5.2/5.3; AH 6.9)
✎ Bauaufgabe: Welche Parameter braucht dein eigener Service — und welche sind Pflicht?

✓ Das hast du jetzt erledigt

Stufe 4 von 6

Parametertypen im Detail

Das richtige Feld für die Eingabe.

1Die Typen

Kurztext
einzeilig, max. Länge einstellbar.
Langtext
mehrzeilig — ideal für Prompt-Eingaben.
Datei
Base64-Upload; bei Bildern optional Vision-Flag & Bild-Limit.
Mehrere Dateien (MultiFile)
bis zu 20 Dateien auf einmal; der Text jeder Datei wird extrahiert und mit Trennern === datei1.pdf === verkettet.
Auswahlliste
Key-Value-Dropdown, z. B. „Angebot / Rechnung / Mahnung".
Zahl
Int/Float mit Min/Max-Grenzen.
Datum / Uhrzeit
Picker.
Checkbox
true/false.

2Validierung

Pro Parameter steuerst du Default, Min/Max, Regex und Abhängigkeiten zu anderen Parametern — so kommen saubere Eingaben in den Workflow. (AH 5.3)
MultiFile & Intervalle: Im Intervall-Plan lassen sich MultiFile-Parameter nicht vorbelegen — solche Services taugen nicht für geplante Ausführung. Scheitert das Auslesen einer Datei, bricht der gesamte Lauf ab. (AH 6.3)
✎ Bauaufgabe: Welcher Typ für eine PDF-Rechnung, welcher für „Sprache wählen"?

✓ Das hast du jetzt erledigt

Stufe 5 von 6

Einstellungen, Flags & Versionierung

Verhalten und sauberes Weiterentwickeln.

1Reiter „Einstellungen"

StammdatenEinstellungenKategorieParameter
Einstellungen
Im Hintergrund ausführenfür lang laufende Aufgaben
aus
Ergebnis per Mail senden
aus
Interner Servicenur als Workflow-Baustein
aus
Als wiederholend konfigurierbar
aus
Kategorieeigene Kategorie-Karte / Tree-View
Sprache / Übersetzung

2Sauber versionieren

Achtung: Es gibt kein automatisches Versioning. Für eine v2 den Service duplizieren („Übersetzungs-Service v2") oder den Agenten als JSON exportieren. Speichern erzeugt einen serviceusage-Datensatz fürs Tracking. (AH 5.4)
Kategorie: Die Kategorie ist eine eigene Karte mit Tree-View. Sie sortiert den Service im Cockpit; neue Kategorien werden global auf Plattformebene gepflegt. (AH 5.2, 5.7)
✎ Bauaufgabe: Welche Flags braucht ein nächtlicher Report-Service, der das Ergebnis mailt?

✓ Das hast du jetzt erledigt

Stufe 6 von 6

Qualität, Beispiele & Freigabe

Den Service kontrolliert nutzbar machen.

1Prompt-Optimierer richtig einordnen

Der Button „Prompts optimieren" sitzt im Workflow-Schritt-Editor, nicht in der reinen Service-Hülle. (AH 5.6)

Er liefert drei verbesserte Prompts: System-, Ausführungs- und Knowledge-DB-Suche-Prompt. „Promptoptimierung rückgängig machen" stellt den vorherigen Zustand wieder her. In C3 merkst du dir das Werkzeug; praktisch nutzt du es in C4 beim Workflow.

2Feedback als Kontrollpunkt

Nach Ausführungen bündelt aiservicefeedback.html Bewertung, Kommentar, Benutzer-E-Mail, Zeitpunkt sowie den Link zu „Aufruf und Ergebnis". Schlechte Bewertungen prüfst du zuerst dort und gehst dann in den Workflow-Schritt. Die systematische Auswertung vertieft C6. (AH 5.5)

3Was sich als Service eignet

Marketing-Text
Produktname + Zielgruppe → Text in drei Varianten.
Rechnungserkennung
PDF → JSON (Betrag, Datum, Absender), nutzt Vision.
Marktpreis-Analyse
Background-Service mit HTTP-Abruf, Ergebnis per Mail.
Rechts-Check
mit aktiver Anonymisierung und GDPR-Analyzer.

Beispiele aus AH 5.8.

4Freigabe prüfen

Ein nicht-interner Service wird im Cockpit sichtbar einsortiert; wer ihn ausführen darf, hängt an den Agent-Rechten. Anwender-Rechte am Agenten erlauben Chat und AI-Service-Ausführung, Administrator-Rechte erlauben Pflege. Kapitel 5 beschreibt keine separate Service-Rechte-Matrix; falls deine Instanz eine zusätzliche UI dafür zeigt, gegen die Instanz prüfen. (AH 1.2, 5.1, 5.2, 5.7)

Service-Schablone steht!

Stammdaten, Parameter, Einstellungen und Veröffentlichung sind gesetzt — die Hülle des Übersetzungs-Service ist fertig. Mach das Quiz und geh dann weiter zu C4 — Workflows bauen, wo der 4-Schritt-Workflow dahinter entsteht.

✎ Bauaufgabe: Welche Gruppen brauchen Anwender-Rechte am Agenten, damit sie deinen Service nutzen können?

✓ Das hast du jetzt erledigt

Kurz-Quiz

Sitzt das Definieren?

6 Szenariofragen aus den Stufen 1–6. Kein Zertifikat — zur Selbstkontrolle. Beliebig oft wiederholbar.

Frage 1 von 6
Lade Frage…