Agenten-Einstieg

Nutzen Sie diese Seite, wenn ein Agent öffentliche Workspace-Dokumentation schnell auswerten und sichere Integrationspfade finden soll. Beginnen Sie mit den kuratierten Startpunkten und wechseln Sie erst danach in einzelne Fachseiten.

Agenten arbeiten hier ausschließlich mit veröffentlichten Public Docs, öffentlicher Runtime-Discovery und redaktionell kontrollierten API-Hinweisen. Veröffentlichen Sie keine echten Zugangsdaten, API-Key-Werte, Tokens, Cookies, Server-Quellcode, internen Pfade, internen Serverstrukturen, Stacktraces, Datenbank- oder Treiberdetails, vollständigen OpenAPI-Dumps oder vollständigen Response-Dumps.

Schnellstart

Aufgabe	Startpunkt
Produktbereiche und Rollen verstehen	Überblick
Eine Integration planen	Integration
Laufzeitfähigkeiten und Einstiegspunkte prüfen	Discovery und Ressourcen
API-Aufrufe reproduzierbar testen	CLI und API
Lokale Docker-Demo einordnen	Docker-Demo in 10 Minuten
`nucli` in Demo- und Betriebsumgebungen nutzen	nucli
Lokale Offline-Wartung mit `numin` einordnen	numin
Staff Teams, Reporting und Rechte trennen	Teams im Personalbereich
Öffentliche Storefront prüfen	Katalog, Preise und Produktdarstellung
OpenAPI sicher einordnen	OpenAPI verwenden
Fähigkeiten fachlich einordnen	Fähigkeiten und Prozesslandkarte
Begriffe klären	Glossar

Vorgehen für Agenten

Lesen Sie zuerst den Überblick und die passende Rollen- oder Fachseite.
Nutzen Sie Discovery, bevor Sie API-Pfade oder Capabilities annehmen.
Verwenden Sie nucli als Referenzclient, wenn Sie Aufrufe gegen einen laufenden Server reproduzierbar prüfen.
Verwenden Sie numin nur für dokumentierte lokale Offline-Wartung und nur, wenn der Nutzer den privilegierten Betriebszugriff ausdrücklich freigibt.
Nutzen Sie OpenAPI nur als technische Analysehilfe. Runtime-Discovery und Ressourcen-Meta bleiben der erste Vertrag für laufende Instanzen.
Geben Sie in Antworten nur sichere Diagnosewerte weiter: Host, Zeitpunkt, Endpoint, Status, allgemeiner Fehlercode und betroffenen Produktbereich.

Maschinenlesbare Einstiege

Nutzen Sie für automatisierte Recherche die generierten Public-Docs-Artefakte in dieser Reihenfolge:

Artefakt	Zweck
`/llms.txt`	Kompakter Einstieg mit Agenten-Hinweis und Seitenliste.
`/agent/manifest.json`	Strukturierter Seitenkatalog mit ID, Sprache, Titel, Bereich, HTML-Ziel und Raw-Markdown-Ziel.
`/agent/pages/...`	Bereinigte Markdown-Seiten mit aufgelösten internen Public-Docs-Links.
`/search-index.json`	Suchindex für öffentliche Seitentexte.

Starten Sie mit /llms.txt, lesen Sie danach diese Agenten-Einstiegsseite und wechseln Sie erst dann zur passenden Fachseite. Verwenden Sie Raw-Markdown aus /agent/pages/..., wenn Sie Inhalte zusammenfassen, vergleichen oder mit anderen öffentlichen Quellen abgleichen. HTML-Seiten bleiben der sichtbare Lesekontext für Nutzer.

Staff Teams einordnen

Wenn ein Nutzer nach Teams, Teammitgliedern oder Hierarchien im Personalbereich fragt, starten Sie mit Teams im Personalbereich. Leiten Sie aus Staff-Team-Rollen keine Prozesswirkung ab:

lead und deputy sind fachliche Teamrollen, keine IAM-Rollen.
Arbeitszeit und Urlaub folgen reports_to, nicht der Teamliste.
Rechte kommen aus IAM-Rollen und AccessGroups.
Abteilungen, Organisationen, Kostenstellen und Projekte bleiben eigene Fachstrukturen.

Für reproduzierbare Prüfungen verwenden Sie nucli resources meta staff.teams und nucli resources get staff.teams. Geben Sie keine vollständigen Mitgliederlisten oder Personendaten in öffentlichen Agentenantworten aus.

Docker- und Storefront-Onboarding

Prüfen Sie bei lokalen Docker-Demos zuerst die kuratierte Anleitung, bevor Sie aus Rohlogs oder lokalen Notizen schließen. Die Docker-Demo erklärt Compose-Struktur, Container-Pfade, NUCLEUS_KEY, Volumes, TLS-Dateien, Erstzugangsdaten und Reset-Fälle.

Nutzen Sie für reproduzierbare Diagnose nucli. In Docker-Demos kann nucli im Workspace-Container laufen; für lokale Zertifikate kann ein Trust Anchor per SSL_CERT_FILE nötig sein. Geben Sie in Agentenantworten keine echten Keys, Passwörter, Tokens oder vollständigen Logblöcke weiter.

Wenn der Server für eine unterstützte Pre-Start-, Schema- oder Recovery-Aufgabe nicht laufen muss, folgen Sie numin. Verwenden Sie numin nicht als Ersatz für Serverberechtigungen und starten Sie verändernde Wartung zuerst ohne --apply.

Unterscheiden Sie beim Onlineshop zwischen laufendem Server und verfügbarer Storefront. Der öffentliche Storefront-Kontext setzt eine aktive Site, Domain, Sales Channel, Commerce-/Preis-/Locale-Konfiguration und passende Produktveröffentlichung voraus. Wenn STOREFRONT_UNAVAILABLE erscheint, ist das ein Storefront-Konfigurationsbefund, kein Grund, interne Admin- oder PIM-Endpunkte als Ersatz für öffentliche Storefront-Verträge zu verwenden.

Veröffentlichungsgrenzen

Öffentliche Agentenantworten und Artefakte dürfen enthalten:

Links auf Public-Docs-Seiten,
veröffentlichte API-Pfade aus kuratierten Seiten,
sichere Platzhalter wie <tenant>, <email> oder <entrypoint-id>,
allgemeine Fehlerklassen und Statuscodes,
fachliche Capabilities und Prozessbereiche.

Sie dürfen nicht enthalten:

echte Passwörter, API-Key-Werte, Tokens, Cookies oder Session-Werte,
serverseitigen Quellcode oder interne Modul-, Paket- und Dateistrukturen,
interne Hostnamen, lokale Pfade oder Arbeitsverzeichnisse,
Stacktraces, Datenbankfehlercodes, Tabellen-, View- oder Spaltennamen aus Fehlern,
vollständige OpenAPI-, Log-, Diagnose-, Profil- oder Response-Dumps,
Kunden-, Personen-, Zahlungs- oder Kommunikationsdaten.

Wenn eine Aufgabe solche Daten benötigt, verweisen Sie auf die passende kurierte Public-Docs-Seite und fordern Sie eine bereinigte Zusammenfassung an. Übernehmen Sie keine Rohdaten in öffentliche Dokumentation, Tickets oder Agentenantworten.

Nächste Schritte

Integration planen: Integration
Discovery und Ressourcen prüfen: Discovery und Ressourcen
CLI und API nutzen: CLI und API
OpenAPI sicher verwenden: OpenAPI verwenden
Fähigkeiten nachschlagen: Fähigkeiten und Prozesslandkarte