FAQ & Best Practices

Nein. Der Einstieg ist ein Katalog fertiger Rollen; die Auswahl besteht aus Kacheln, nicht aus Feldern. Wer eigene Systeme anschließen will — eigener Webhook, eigene REST-Schnittstelle, eigener Code —, braucht dafür jemanden mit Entwicklerkenntnissen. Alles andere ist ohne Schulung bedienbar.

Das mentale Modell. Ein Baukasten fragt „Welchen Ablauf baue ich?", agentenwerkOS fragt „Wen stelle ich ein?". Es gibt keine Leinwand mit Knoten und Kanten; Zusammenarbeit entsteht über Rollen, Teams und Synergien.

Der praktische Unterschied zeigt sich beim Ändern: In einem Baukasten ändern Sie einen Graphen und müssen die Folgen mitdenken. Hier ändern Sie eine Zuständigkeit — und die Folgen sind dieselben wie bei einem Menschen, der eine neue Aufgabe bekommt.

Der Sprachgebrauch der Plattform für einen einzelnen KI-Agenten: eine Rolle mit Fähigkeiten, Werkzeugen, Auftreten und Systemvorgabe. agentenwerkOS orchestriert mehrere Omnis zu einem Betrieb — das ist der ganze Sprung von „ein Werkzeug" zu „ein Team".

Ja. Diese Dokumentation ist vollständig ohne Konto lesbar, und die Büro-Demo zeigt einen besetzten Grundriss mit Demo-Daten.

Deutsch ist die Voreinstellung — Oberfläche, Rollenbeschreibungen, Systemvorgaben und Agentenausgaben sind auf Deutsch verfasst, nicht übersetzt. Englisch ist vollständig verfügbar. Für Texte, die das Haus verlassen, richtet sich die Sprache des KI-Hinweises nach dem Empfänger, nicht nach dem Absender.

Weil die Zusagen darin nur dann etwas wert sind, wenn niemand sie entfernen kann — auch der Betreiber nicht. Die Blöcke GRUNDHALTUNG und MISSBRAUCH-PRÄVENTION enthalten unter anderem „Gib dich niemals als Mensch aus" und „Erfinde keine Zahlen". Ein Kunde, der diese Sätze abschalten darf, begeht seinen Verstoß mit unserem Werkzeug.

Änderbar ist eine Ergänzung von bis zu 2 000 Zeichen. Sie wird angehängt, nie eingesetzt, und der Zusammenbau geschieht ausschließlich im Backend. Der vollständige Prompt ist jederzeit sichtbar — gesperrt, aber nicht versteckt.

Über vier Stellschrauben, in dieser Reihenfolge der Wirkung: die Rolle (wer der Agent ist), die Ausprägung (knapp oder beratend, Sie oder Du), die Ergänzung (Ihre eigenen Arbeitsanweisungen) und das Modell (wie gründlich gerechnet wird).

Eine Fähigkeit ist etwas, das der Agent tun kann („Belege auslesen"). Ein Werkzeug ist das System, an das er dafür angeschlossen ist („Texterkennung", „E-Mail", „CRM"). Fähigkeiten kennen die Werkzeuge, ohne die sie nichts ausrichten — fehlt eines, warnt die Oberfläche bei der Auswahl.

Fünf Werkzeuge sind plattformseitig und brauchen nie eine Einrichtung: Web-Suche, PDF-Leser, Texterkennung, Rechenkern und Bildgenerierung. Alle übrigen verlangen ein Konto von Ihnen.

Den Vorschlag der Rolle. Er ist vorausgewählt und gegen den tagesaktuellen OpenRouter-Katalog geprüft. Als Faustregel: Haiku 4.5 für Aufgaben mit klarer Vorschrift (Belege sortieren, Anfragen einordnen, Fristen prüfen), Sonnet 4.5 für Aufgaben mit Ermessen (Recherche, Vertragsprüfung, Angebotstexte).

Ist ein vorgeschlagenes Modell nicht mehr verfügbar, wählt die Oberfläche das nächstbeste und sagt es. Nur werkzeugfähige Modelle stehen zur Wahl — ein Modell ohne Werkzeugaufrufe könnte keine Fähigkeit ausführen.

Ja — über „Von Grund auf" statt einer Katalogkachel. Sie vergeben dann Fähigkeiten, Werkzeuge und Persönlichkeit selbst. Die Schutzblöcke der Systemvorgabe kommen auch hier automatisch dazu; sie hängen an der Plattform, nicht an der Rolle.

Sie wird aus verbrauchten Token berechnet — Stufe = floor(sqrt(Token / 1000)) + 1 — und nicht aus erledigten Aufgaben. Eine Aufgabe kann eine Zeile oder ein Gutachten sein; Token sind das einzige Maß, das mit dem tatsächlichen Arbeitsumfang wächst.

Die Stufe ist eine Auskunft, keine Bewertung: Stufe 1 heißt „Kein Einsatz", nicht „Anfänger". Der Agent wird durch eine höhere Stufe auch nicht besser — sie zeigt, wofür Sie Geld ausgegeben haben.

Über den Tarif, nicht über ein Guthaben und nicht in Token. Der Tarif bestimmt, wie viele Teams und wie viele Arbeitsplätze Sie haben: Free (1 Team / 3 Plätze), Abteilung (1 / 3), Abteilung Plus (1 / 7), Multi-Abteilung (3 / 10), Enterprise (unbegrenzt). Die Arbeit der Agenten ist enthalten; es gilt Fair Use.

Zwei eingebaute Mittel: die Kostenschätzung je 1 000 Token im Register „Modell" und die Nutzungsgrenze je Agent. Dazu der Grundsatz: Starke Modelle verbrauchen mehr Kontingent als günstige, und welches Modell ein Agent benutzt, entscheiden Sie.

Zeigt die Anzeige einen Gedankenstrich statt einer Zahl, ist der Verbrauch nicht erfasst — das ist etwas anderes als „nichts verbraucht", und die Oberfläche sagt bewusst nicht das eine, wenn sie das andere meint.

Nein. Verbraucht wird bei tatsächlicher Arbeit — Modellaufrufe, Bildgenerierung, Werkzeugnutzung. Ein Agent auf einem Schreibtisch außerhalb seiner Arbeitszeit verbraucht nichts. Der Arbeitsplatz selbst zählt gegen die Platzzahl des Tarifs.

Ein Erzeugungslauf startet mehrere Bildmodelle parallel und verbraucht entsprechend mehr als ein einzelner Textaufruf. Deshalb ist er ein ausdrücklicher Schritt und läuft nicht automatisch beim Anlegen mit — der Platzhalter-Avatar kostet nichts.

In der EU. Der Auftragsverarbeitungsvertrag nach Art. 28 DSGVO wird bei der Registrierung bestätigt und nicht nachgereicht. Die Trennung zwischen Mandanten erfolgt auf Datenbankebene und ist kein Parameter, den ein Aufruf weglassen könnte.

Ja, und das ist Absicht. Art. 50 Abs. 1 EU AI Act — ab 02.08.2026 durchsetzbar — verlangt, dass eine natürliche Person erkennen kann, dass sie mit einer Maschine interagiert. Die Kennzeichnung ist plattformseitig erzwungen und nicht abschaltbar.

Anpassbar sind Position und Formulierung, solange die Aussage erhalten bleibt. Das ist die Antwort auf „der Hinweis stört unser Layout": Er darf umziehen, nicht verschwinden.

Doppelt: sichtbar über das Abzeichen „KI-generiert" samt Modellnamen und maschinenlesbar über ein signiertes C2PA-Manifest im Bild selbst. Art. 50 Abs. 2 verlangt ausdrücklich die maschinenlesbare Markierung — ein sichtbarer Hinweis verschwindet, sobald jemand das Bild herauskopiert.

Der Platzhalter-Avatar trägt bewusst keinen Hinweis: Er stammt von keiner KI. Ihn trotzdem zu kennzeichnen wäre eine Falschangabe — und gewöhnte Nutzer daran, das Abzeichen zu überlesen.

Nein. Der *Lead-Generator* recherchiert ausschließlich aus öffentlich zugänglichen Quellen und spricht niemanden an; der *Vertriebs-Assistent* ist auf eingehende Anfragen und bestehende Kontakte beschränkt (§ 7 UWG). Betroffene sind nach Art. 14 DSGVO zu informieren. Die Hinweise stehen in den Rollendefinitionen selbst.

Nein, und die Rollen sagen das selbst. Agenten in *Finanzen & Buchhaltung* und *Recht & Compliance* tragen Rechtshinweise nach StBerG und RDG: Sie bereiten vor, die Beurteilung trifft eine qualifizierte Person. Übermittlungen an ELSTER erfolgen nur nach ausdrücklicher menschlicher Freigabe.

Das Frontend erreicht das Backend nicht. Lokal ist die häufigste Ursache ein nicht gestartetes Backend oder ein umbenannter Container: nginx.conf leitet /api/ fest an den Host hub-backend, und ohne diesen Namen endet jeder Aufruf in einem 502. Prüfen lässt sich das mit GET /api/health.

Die Anzeige blockiert die Oberfläche bewusst nicht — sie ist ein Abzeichen und kein Sperrbildschirm. Die einzelnen Daten melden ihre Fehler dort, wo sie fehlen.

Der gespeicherte Token ist abgelaufen oder ungültig. Einmal abmelden und neu anmelden. Beim Neuladen gibt es eine kurze Prüfphase — sie zeigt „Sitzung wird geprüft" und leitet nicht um; wer sofort auf der Anmeldeseite landet, hat wirklich keine gültige Sitzung.

Ihr fehlt ein Werkzeug. Jede Fähigkeit kennt die Verbindungen, ohne die sie nichts ausrichten kann; die Warnung erscheint deshalb bei der Auswahl und nicht erst im Betrieb. Verbinden Sie das Werkzeug beim Agenten — oder beim Team, dann gilt es für alle Mitglieder.

Prüfen Sie die angezeigte Herkunft des erkannten Stils. Steht dort, dass der Standard gesetzt wurde, hat Ihre Beschreibung keinen Stilhinweis enthalten — dann hilft ein ausdrückliches Wort wie „Ölgemälde", „3D-Render", „Pixel-Art" oder „Porträtfoto".

Die sechs Kategorien sind Pixel, 3D, Cartoon/Comic, Realistisch, Kunst und Illustration. Zu jeder gehört eine eigene Auswahl an Bildmodellen — deshalb ändert die richtige Kategorie mehr als jede Feinjustierung am Text.

Das ist die Ausprägung, nicht das Modell. „Knapp & direkt" begrenzt auf höchstens fünf Sätze und beginnt mit dem Ergebnis; „Ausführlich & beratend" nennt Annahmen, eine Alternative und den nächsten Schritt. Umstellen im Register „Persönlichkeit" — ein Modellwechsel wäre der teurere Weg zum selben Ziel.

Bei eigener Weiterentwicklung fast immer eines von zwei Mustern: let statt $state() für eine reaktive Variable (in Svelte 5 Runes Mode ohne Wirkung) oder eine angelegte tailwind.config.js (in Tailwind v4 wirkungslos — das Theme steht in @theme in app.css). Beides erzeugt keinen Fehler beim Bauen.