Agenten-Einstieg

Agenten und ihre Auftraggeber finden hier den sicheren Rechercheweg durch die öffentliche Workspace-Dokumentation. Die Seite zeigt, welche Quellen zuerst zu lesen sind, wie Laufzeitverträge geprüft werden und welche Daten niemals in öffentliche Antworten oder Artefakte gehören.

Das Ergebnis ist eine belegbare, auf Public Docs und veröffentlichte Runtime-Verträge begrenzte Recherche. Interner Quellcode, Rohlogs und Zugangsdaten sind dafür weder nötig noch zulässig.

In drei Schritten starten

Lesen Sie /llms.txt und danach diese Einstiegsseite.
Wählen Sie unten die passende Rollen- oder Fachseite.
Prüfen Sie technische Aussagen über Discovery, Ressourcen-Meta oder nucli, bevor Sie sie als Laufzeitvertrag verwenden.

Startpunkte nach Aufgabe

Aufgabe	Startpunkt
Produktbereiche und Rollen verstehen	Überblick
Eine bestehende Systemlandschaft einordnen	Integratoren
Eine technische Integration planen	Integration
Laufzeitfähigkeiten und Ressourcen prüfen	Discovery und Ressourcen
API-Aufrufe reproduzierbar testen	CLI und API
Bereitstellung und lokale Demo einordnen	Bereitstellung: Erste Schritte
Einen laufenden Server administrieren	nucli
Lokale Offline-Wartung einordnen	numin
Staff Teams, Rechte und Personalstrukturen trennen	Teams im Personalbereich
Eine öffentliche Storefront prüfen	Katalog, Preise und Produktdarstellung
OpenAPI sicher verwenden	OpenAPI verwenden
Fähigkeiten oder Begriffe nachschlagen	Fähigkeiten und Prozesslandkarte und Glossar

Maschinenlesbare Quellen

Artefakt	Zweck
`/llms.txt`	Kompakter Einstieg mit Agenten-Hinweis und Seitenliste.
`/agent/manifest.json`	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.

Verwenden Sie Raw-Markdown aus /agent/pages/..., wenn Sie Inhalte zusammenfassen oder vergleichen. Die HTML-Seite bleibt der sichtbare Lesekontext für Nutzer.

Sichere Recherchegrenzen

Zulässig	Nicht zulässig
Links auf Public-Docs-Seiten	Passwörter, API-Key-Werte, Tokens, Cookies oder Session-Werte
Veröffentlichte API-Pfade aus kuratierten Seiten	Interner Server-Quellcode sowie interne Modul-, Paket- oder Dateistrukturen
Platzhalter wie `<tenant>`, `<email>` oder `<entrypoint-id>`	Interne Hostnamen, lokale Pfade oder Arbeitsverzeichnisse
Allgemeine Fehlerklassen und Statuscodes	Stacktraces, rohe Datenbank- oder Treiberfehler
Fachliche Fähigkeiten und Prozessbereiche	Vollständige OpenAPI-, Log-, Diagnose-, Profil- oder Response-Dumps
Bereinigte, für die Aufgabe nötige Diagnosewerte	Kunden-, Personen-, Zahlungs- oder Kommunikationsdaten

Wenn eine Aufgabe geschützte Rohdaten voraussetzt, fordern Sie eine bereinigte Zusammenfassung an. Übernehmen Sie solche Daten nicht in öffentliche Dokumentation, Tickets oder Agentenantworten.

Laufzeit und Werkzeuge

Nutzen Sie Discovery vor angenommenen API-Pfaden. Für einen erreichbaren Server ist nucli der Referenzclient: Es verwendet Server-Authentisierung, Berechtigungen, Tenancy und veröffentlichte Fachverträge.

numin ist ausschließlich für dokumentierte lokale Offline-Wartung in einer privilegierten Umgebung vorgesehen. Es ersetzt weder Serverberechtigungen noch nucli. Verändernde Wartung beginnt immer als Dry-Run und erhält --apply nur nach ausdrücklicher Freigabe.

Zwei häufige Grenzfälle

Staff Teams

Beginnen Sie bei Teams im Personalbereich. Teamrollen wie lead oder deputy sind keine IAM-Rollen. Rechte stammen aus IAM-Rollen und AccessGroups; Arbeitszeit und Urlaub folgen nicht der Teamliste. Öffentliche Antworten enthalten keine vollständigen Mitgliederlisten oder Personendaten.

Docker-Demo und Storefront

Für lokale Demos gilt die kuratierte Docker-Anleitung, nicht eine Vermutung aus Rohlogs. Eine öffentliche Storefront benötigt eine aktive Site, Domain, einen Sales Channel sowie passende Commerce-, Preis-, Locale- und Produktveröffentlichung. STOREFRONT_UNAVAILABLE ist ein Konfigurationsbefund; interne Admin- oder PIM-Endpunkte sind kein Ersatz für öffentliche Storefront-Verträge.

Die Recherche ist abgeschlossen, wenn …

jede zentrale Aussage auf eine öffentliche Seite oder einen veröffentlichten Laufzeitvertrag zurückgeht,
Zielgruppe und Produktbereich eindeutig sind,
technische Annahmen über Discovery oder nucli geprüft wurden,
Antworten nur die nötigen bereinigten Informationen enthalten und
offene Punkte als solche benannt sind.