Wo klicken, was erwarten.

1Die ersten zehn Minuten: ein Workspace und seine Datenrichtlinie

1. Console Home → Identity → Workspaces → New workspace (oder /admin/workspaces/new).
2. Nennen Sie ihn test-<ihrname>. Setzen Sie Data sovereignty policy auf Local only (nichts darf zu einem Cloud-Modell) oder Local + cloud allowed. Wählen Sie den Default model tier.
3. Fügen Sie sich selbst unter Add member hinzu. Save changes.
4. Wechseln Sie im Workspace-Umschalter dorthin.

Das sollten Sie sehen: die Pille zeigt Ihren Workspace mit dem Hinweis „Local only · cloud blocked“ oder „Local + cloud“; Home zeigt einen leeren Workspace im Überblick.

Probieren Sie: mit Local only in Chat die Stufe Cloud Reasoning wählen und irgendetwas fragen. Sie erhalten eine Souveränitätsablehnung, keine Antwort. Governance → Audit log zeigt die Ablehnung.

2Wissen: hochladen, suchen, zitieren

1. Knowledge → Create knowledge set → benennen. Öffnen.
2. Upload documents (Dateien ablegen: PDF, DOCX, XLSX, TXT, MD, HTML) oder Ingest URL → Scrape & Index. Laden Sie auch ein gescanntes PDF hoch.
3. Warten Sie auf Indexed. Nutzen Sie Search this knowledge set….
4. Gehen Sie zu Chat und stellen Sie eine Frage, die die Dokumente beantworten.

Das sollten Sie sehen: die Antwort trägt Zitate; ein Klick öffnet die Passage. Ein gescanntes PDF wird entweder indexiert (ein Vision-Modell ist konfiguriert) oder sagt Ihnen beim Hochladen, dass die Textextraktion ein Vision-Modell braucht — nie ein stillschweigend leeres Set. Eine Kollegin, die nicht Mitglied Ihres Workspace ist, sieht das Set nicht und bekommt keine Antworten daraus.

3Chat: exakte Berechnung und Diagramme

1. Chat, beliebiger Workspace. Tippen Sie: „Was ist 2 hoch 64, exakt?“
2. Schalten Sie den Rechenmodus ein (der Composer zeigt Compute mode on — your next message is computed exactly in the sandbox) und senden Sie erneut.
3. Tippen Sie „Q1 12, Q2 18, Q3 15, Q4 22 — Balkendiagramm des Quartalsumsatzes“ und nutzen Sie Visualize data → Bar.
4. Auf dem Diagramm Pin to dashboard (braucht Build dashboards).

Das sollten Sie sehen: Schritt 1 kann eine Schätzung sein; Schritt 2 ist 18446744073709551616, in der Sandbox berechnet, und die Run-Spur (Agent Administration → Runs) zeigt den ausgeführten Code. Schritt 3 rendert ein Diagramm mit Hover-Werten und PNG/SVG-Export; Schritt 4 fragt nach einem Dashboard, und das Diagramm landet dort als Widget mit eigenem Dataset.

4Agenten: entwerfen, Werkzeuge erlauben, zertifizieren, ausführen, widerrufen

1. Agents → Create agent (oder Agent Administration → Composer). Benennen, Default persona wählen, Workspace scope auf Ihren Workspace setzen.
2. Allowed tools: Search knowledge, Show a table, chart or KPI, Append to dataset anhaken. Run code anhaken, wenn Ihre Lizenz die Sandbox enthält (sonst zeigt das Werkzeug Requires licence).
3. Posture: Sovereign / Mixed / Permissive. Model tier ceiling und Max USD / run. Create agent.
4. Für die Code-Sandbox muss der Workspace sie erlauben: Identity → Workspaces → Ihr Workspace → Agentic tool access → Run agent-written code (sandboxed) → Save changes.
5. Zertifizieren: Agent Administration → Certification → + Certify agent (braucht eine Plattform-CA; steht dort Generate a platform CA first, einmal erledigen). Agent wählen, Scope (die angehakten Werkzeuge), Klassifikationsobergrenze, Ablauf → Issue passport. Die Agentenkarte zeigt jetzt Certified. (Eine externe CA kann stattdessen signieren: Export cert request im Agent Designer, dann Import agent certification token unter Certificates.)
6. Chatten Sie mit dem Agenten: lassen Sie etwas exakt berechnen und dann als Tabelle zeigen.
7. Verlangen Sie etwas außerhalb seiner erlaubten Werkzeuge (z. B. in ein Dataset schreiben, das Sie nicht erlaubt haben). Dann widerrufen: Agent Administration → Certificates → das Zertifikat des Agenten → Revoke.

Das sollten Sie sehen: die Tabelle des Agenten erscheint als Karte im Chat mit einem Pin to dashboard-Knopf; die Anfrage außerhalb des Scope wird abgelehnt und die Run-Spur zeigt einen denied Werkzeugaufruf mit der Regel; nach dem Widerruf wird ein neues Gespräch sofort abgelehnt und ein laufendes stoppt innerhalb von 30 Sekunden. Ein Agent mit Posture Sovereign verweigert Code-Ausführung in einem souveränen Workspace unabhängig vom Schalter.

5Automationen: ein Workflow mit Freigabe und Publish-result-Schritt

1. Automations → Design workflow (Designer). Add trigger → einen wählen (z. B. Webhook oder Schedule). Add next step → AI step (Prompt, Model tier, Data classification).
2. Add next step → Approval → Approvers setzen.
3. Add next step → Code (JavaScript im sandboxed Worker), das Zeilen zurückgibt, z. B. return { rows: [{date: '2026-09-01', line: 'U1', passengers: 120}] }.
4. Add next step → Publish result → Dataset wählen oder anlegen, Schreibmodus Append, Zeilen {{code.rows}}.
5. Publish. Zurück in Automations → Active → Run now. Unter Approvals freigeben.
6. Automations → History → den Run öffnen.

Das sollten Sie sehen: Ein- und Ausgabe jedes Schritts; die Freigabe zeigt, wer wann entschieden hat; der Run hat einen Reiter Published rows; Dashboards → Datasets zeigt die neuen Zeilen. Probieren Sie ✨ Help me build im Designer: eine Automation in einem Satz beschreiben und Render on canvas.

6Hooks: auf Ereignisse reagieren

1. Legen Sie im Designer einen zweiten Workflow an, dessen Trigger When an event happens ist, Ereignis dataset.rows.published. Ein Schritt (ein AI step, der {{trigger.payload}} zusammenfasst). Publish.
2. Automations → Hooks → New hook: Titel, Event dataset.rows.published, Filter payload.datasetId eq <ihre dataset-id> (mit Test filter gegen die Beispiel-Payload prüfen), Handler = der Workflow aus Schritt 1. Enable.
3. Führen Sie den Workflow aus Kapitel 5 erneut aus (oder importieren Sie eine CSV ins Dataset).
4. Öffnen Sie Deliveries des Hooks.

Das sollten Sie sehen: 1 delivered, ein View run-Link und der Run des Handlers in History. Deaktivieren Sie den Handler-Workflow und lösen Sie erneut aus: der Hook zeigt handler paused und Zustellungen schlagen ehrlich fehl, mit Retry. In Deliveries → Replay events ein Zeitfenster wählen, Preview, dann Replay N — die wiederholten Zustellungen tragen ein replayed #n-Abzeichen und jede startet genau einen neuen Run.

7Dashboards: Datasets, Business-Modelle, Widgets, Kreuzfilter, Formulare

Datasets

1. Dashboards → Datasets → New dataset: Titel, Columns (z. B. date date, line string, passengers integer, occupancy number), Keep rows for (days) = 90. Create dataset.
2. Öffnen → Import CSV (Schreibmodus Upsert by key oder Append).

Das sollten Sie sehen: Zeilenzahl, Aufbewahrung, Kontingentbalken. Im Raster: Spaltenrand ziehen zum Verbreitern, Kopf ziehen zum Umordnen, Search in table (Strg/Cmd-F), Bereich markieren und Strg/Cmd-C in eine Tabellenkalkulation kopieren; Zahlen rechtsbündig; die erste Spalte bleibt bei breiten Tabellen stehen.

Ein Dashboard

1. Dashboards → New dashboard → Create. Sie sind im Editor.
2. Add widget: Type KPI; Business model (für jedes Dataset wird eines angelegt); eine Kennzahl anhaken; im Eigenschaftenpanel die Measure wählen; Add. Wiederholen mit Type Chart: Kennzahl und Dimension anhaken, X field / Y field aus den Auswahlen, Show values on hover anhaken. Unter Interactions Clicking a bar or slice filters other widgets by auf Ihre Dimension setzen. Beim KPI Listen to selections from other widgets anhaken.
3. Widgets am Kopf ziehen; an jeder Kante vergrößern; eines mit Pin fixieren; den Chip New widget auf eine leere Zelle ziehen, um dort ein Widget anzulegen.
4. Add filter (ein Zeitraumfilter). Save draft, dann Publish.
5. Öffnen Sie das veröffentlichte Dashboard (es steht jetzt in der linken Navigation unter Dashboards). Klicken Sie auf einen Balken.

Das sollten Sie sehen: die anderen Balken werden gedimmt, ein Chip line: U1 erscheint über dem Dashboard, der KPI fragt den gefilterten Wert neu ab, und das ✕ des Chips löscht ihn. Versions erlaubt das Zurückrollen; Retire entfernt das Dashboard aus der Navigation. Probieren Sie ✨ Help me build mit einem Satz wie „Fahrgäste je Linie für den aktuellen Monat und eine Summe“: der Vorschlag wird gegen das Modell geprüft, bevor Sie ihn sehen.

Ein Formular

1. Add widget → Type Form (Adaptive Card). Behalten Sie die Beispielkarte oder ergänzen Sie ein Input.ChoiceSet, ein Input.Number mit min/max und eine Action.ShowCard mit weiteren Feldern. Wählen Sie einen Workflow als Ziel. Add, Save draft, Publish.
2. Senden Sie das Formular auf dem veröffentlichten Dashboard leer ab, dann korrekt.

Das sollten Sie sehen: das leere Absenden wird im Browser mit den Meldungen der Karte blockiert, null Anfragen gesendet; das korrekte Absenden zeigt die Erfolgsmeldung und startet den Ziel-Workflow (Approvals oder History zeigt den Run). Share auf einem Dashboard mit Formular wird abgelehnt — Formulare sind nie öffentlich.

Teilen

1. Auf einem Dashboard ohne Formular: Share → Create link (Bezeichnung, Stunden). Öffnen Sie den Link in einem privaten Fenster.

Das sollten Sie sehen: das Dashboard rendert schreibgeschützt mit dem Namen Ihrer Organisation und dem Ablauf, ohne Login; Revoke im selben Dialog beendet ihn. (Braucht das Lizenzmerkmal resultsPublicShare und Share a result.)

8Marketplace und Vorlagen

1. Marketplace → Filter Type Solution → eine öffnen → Install → Workspace wählen → Confirm install.
2. Automations → Templates → Deploy template.

Das sollten Sie sehen: die Workflows der Lösung erscheinen unter Automations → Active; eine Lösung mit Dashboard-Bündel legt zudem ihr Dashboard, ihre Datasets und Hooks im gewählten Workspace an (Navigation Dashboards).

9Extensions: die Plattform soll aussehen und sprechen wie Sie

Alles Folgende ist ein signiertes Pack — ein Zip mit Manifest und Datendateien, signiert mit einem Schlüssel, den Sie behalten. Die Plattform führt nie Code aus einem Pack aus.

Ihr erstes Pack signieren

1. Auf Ihrem Laptop mit Node 20: node tools/aancer-pack/cli.mjs keygen --out mykey.key (aus dem Release-Bündel; erzeugt mykey.key und mykey.pub).
2. Schreiben Sie manifest.json (siehe Kundenhandbuch Authoring a pack für das minimale Beispiel; der Ordner hexad-ci im Bündel ist ein vollständiges Theme-Pack zum Kopieren).
3. node tools/aancer-pack/cli.mjs sign manifest.json content/ -o mypack-1.0.0.ancpack --key mykey.key

Installieren

1. Platform Settings → Extensions → Add trust key: Schlüssel-ID (muss publisher.keyId im Manifest entsprechen), Bezeichnung, der Inhalt von mykey.pub.
2. Import pack → das .ancpack wählen → Import. Lesen Sie die Prüfzusammenfassung und etwaige Warnungen. Configure & activate → Parameter binden (meist ein Workspace) → Activate.

Das sollten Sie sehen: ein Pack, das vor dem Hinzufügen des Vertrauensschlüssels importiert wurde, wird mit PACK_SIGNER_UNKNOWN abgelehnt; danach „Bundle verified“, die Elemente mit Status, und nach der Aktivierung erscheint alles, was das Pack deklariert: Theme angewendet, Navigationseinträge, Home-Karten, Dashboards, Hooks (managed by pack). Retire pack entfernt alles und stellt das Standardprodukt wieder her; eine neuere Version derselben Pack-ID wird als Upgrade importiert, und Sie können zurückrollen.

Was ein Pack enthalten kann

Ihr Erscheinungsbild ohne Pack

Platform Settings → Branding: Platform name, Login page tagline, Primary color, Secondary color, Logo URL, Favicon URL, Login background color, Default theme. Live preview zeigt die Login-Seite. Das ist der Weg mit sechs Feldern ohne Signatur; ein Theme-Pack kann alles davon plus Schriften, Tokens je Block und Varianten je Workspace.

10Eingebettete Apps: Ihre eigene Anwendung im Hub

1. Ergänzen Sie in Ihrem Pack ein app-Element: url (https, {{workspace}} erlaubt), origin, capabilities (z. B. read:me, read:dataset:<id>, write:dataset:<id>, navigate, notify), egress.hosts. Importieren und aktivieren wie in Kapitel 9.
2. Platform Settings → Extensions → das Pack öffnen → Manage app: Origin und Fähigkeiten lesen, die Bestätigung anhaken, Approve; jeden Egress-Host mit Approve freigeben.
3. Ihre Anwendung muss mit Content-Security-Policy: frame-ancestors <ihr Plattform-Origin> antworten und darf kein X-Frame-Options: DENY senden.
4. Dashboards → Ihre App erscheint unter ihrer Gruppe mit dem Symbol Embedded app. Öffnen.

Das sollten Sie sehen: vor der Freigabe eine ehrliche Karte Needs approval; erlaubt Ihre App das Einbetten nicht, the app has not allowed this platform to embed it mit Retry; erlaubt sie es, lädt Ihre App und erhält ein kurzlebiges Token über die Bridge (nie in der URL). Melden Sie sich in einem anderen Tab ab: der Frame zeigt innerhalb von 15 s session revoked. Rotate secret zeigt das neue Introspektionsgeheimnis einmal. Jeder Bridge-Aufruf wird unter app.capability.* auditiert.

11Governance: beweisen, dass es passiert ist

1. Governance → Audit log: nach Aktion filtern (agent.tool.call, hook.delivered, extension.pack.activated, sovereignty.*).
2. Governance → Records of processing → exportieren; Compliance → die regulatorischen Berichte.
3. Console Home → Monitoring: Runs, Kosten, Sicherheitsereignisse.

Das sollten Sie sehen: jede folgenreiche Aktion aus den Kapiteln oben, mit wer, wann, Workspace und Ergebnis; abgelehnte Aktionen als Ablehnungen; Zeilendaten nie im Protokoll. Der Endpunkt zur Kettenprüfung (/api/admin/compliance/audit-chain/verify) meldet ok: true.

12Was ablehnen sollte — absichtlich testen

Jede Ablehnung oben ist ein Feature. Melden Sie eine Ablehnung, die nicht eintrat, oder eine, die ohne Audit-Eintrag eintrat.