@agent-native/core 0.76.5 → 0.76.6

package/corpus/core/docs/content/locales/de-DE/template-dispatch.md

@@ -0,0 +1,220 @@
+---
+title: "Versand"
+description: "Dispatch ist die Steuerungsebene des Arbeitsbereichs – zentraler Posteingang, App-übergreifende Orchestrierung, Geheimspeicher, Slack/Telegram-Integration und geplante Jobs."
+---
+
+# Versand
+
+> **Siehe auch:** Eine konzeptionelle Übersicht darüber, was Dispatch tut und wann Sie es benötigen, finden Sie unter [Dispatch](/docs/dispatch). Diese Seite ist die vorlagenspezifische Referenz.
+
+Dispatch ist die **Arbeitsbereich-Steuerungsebene**. Wo andere Vorlagen Domänen-Apps sind (Mail, Kalender, Analytics, Brain), ist Dispatch die App, die Sie _neben_ ihnen ausführen, um alles zu koordinieren: einen zentralen Posteingang, einen Geheimspeicher, geplante Jobs, Slack/Telegram-Integration und einen Orchestrator-Agenten, der Domänenarbeit über [A2A](/docs/a2a-protocol) an die richtige Spezial-App delegiert.
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Dispatch</h1><span class='wf-pill accent'>Overview</span><span class='wf-pill'>Inbox</span><span class='wf-pill'>Secrets</span><span class='wf-pill'>Approvals</span><div style='flex:1'></div><button>Schedules</button></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>What should we do next?</strong><div class='wf-box'>Ask Analytics for this week's signups and draft a Slack update.</div><button class='primary'>Delegate</button></div><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:10px'><div class='wf-card'><strong>Mail</strong><br/><small>/mail</small></div><div class='wf-card'><strong>Calendar</strong><br/><small>/calendar</small></div><div class='wf-card'><strong>Analytics</strong><br/><small>/analytics</small></div><div class='wf-card'><strong>Slides</strong><br/><small>/slides</small></div><div class='wf-card'><strong>Forms</strong><br/><small>/forms</small></div><div class='wf-card'><strong>Create app</strong><br/><small>+</small></div></div><div class='wf-card' style='display:grid;grid-template-columns:repeat(3,1fr);gap:8px'><div class='wf-box'>Slack DM needs reply</div><div class='wf-box'>A2A task completed</div><div class='wf-box'>Approval required</div></div></div>"
+}
+```
+
+Wenn Sie einen [multi-app workspace](/docs/multi-app-workspace) mit vielen Apps betreiben, ist Dispatch der Kleber.
+
+```an-diagram title="Orchestrate, don't specialize" summary="Messages from every channel land in one inbox; the orchestrator triages and delegates domain work to the right specialist app over A2A — secrets, resources, and approvals stay central."
+{
+  "html": "<div class=\"diagram-dispatch\"><div class=\"diagram-col\"><div class=\"diagram-node\">Slack · Telegram</div><div class=\"diagram-node\">Email</div><div class=\"diagram-node\">A2A requests</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill accent\">Orchestrator</span><small class=\"diagram-muted\">central inbox · triage · route</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">Mail agent</div><div class=\"diagram-node\">Analytics agent</div><div class=\"diagram-node\">Brain · Slides &hellip;</div></div></div><div class=\"diagram-shared\"><span class=\"diagram-pill\">Secrets vault</span><span class=\"diagram-pill\">Workspace resources</span><span class=\"diagram-pill warn\">Approvals</span><span class=\"diagram-pill\">Scheduled jobs</span></div>",
+  "css": ".diagram-dispatch{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-dispatch .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-dispatch .diagram-box{display:flex;flex-direction:column;gap:4px}.diagram-dispatch .diagram-arrow{font-size:20px;line-height:1}.diagram-shared{display:flex;gap:8px;flex-wrap:wrap;margin-top:12px}"
+}
+```
+
+## Was es tut {#what-it-does}
+
+- **Zentraler Posteingang.** Slack DMs, Telegram-Nachrichten, E-Mail-Benachrichtigungen, A2A Anfragen von anderen Agenten – alles landet an einem Ort. Der Dispatch-Agent führt eine Triage durch und erledigt sie entweder selbst oder delegiert sie. Unter [Messaging](/docs/messaging) erfahren Sie, wie Sie Slack, E-Mail und Telegram in Ihren Arbeitsbereich integrieren.
+- **Orchestrator, kein Spezialist.** Dispatch versucht _nicht_, die E-Mail-App oder die Analyse-App zu sein. Wenn jemand fragt: „Anmeldungen der letzten Woche zusammenfassen“, ruft Dispatch den Analyseagenten über A2A an und gibt die Antwort zurück. Wenn jemand fragt: „Entwerfen Sie eine Antwort an Alice“, ruft Dispatch den E-Mail-Agenten an.
+- **Steuerungsebenen-Shell.** Chats, Projekte, Ausführungen, Workspace-Apps, Agenten und Automatisierungen leben in einer einzigen operativen Shell, mit Status-First-Listen und Drilldowns anstelle von einmaligen Dashboards.
+- **Secrets Vault.** Ein zentraler Speicher für API-Schlüssel, OAuth-Tokens und gemeinsame Anmeldeinformationen. Apps im Arbeitsbereich lösen Geheimnisse aus Dispatch auf, anstatt sie in jedem `.env` zu duplizieren. Anfragen + Genehmigungen für vertraulichen Zugriff.
+- **Workspace-Ressourcen.** Globale skills, Leitplankenanweisungen, benutzerdefinierte Agentenprofile, Referenzressourcen und HTTP MCP-Server können einmal in Dispatch erstellt werden. Alle App-Ressourcen werden zur Laufzeit von jeder App geerbt, ohne dass ein Kopieren oder ein manueller Synchronisierungsschritt erforderlich ist. Ausgewählte Zuschüsse gelten für App-spezifische Ausnahmen.
+- **Wiederverwendbare Integrationen.** Ein Ort zum Verbinden von Anbieterkonten und zum Verfolgen
+  Anmeldeinformationsreferenzen und gewähren Sie Apps Zugriff. Dispatch besitzt die Anbieteridentität und
+  App-Zuschüsse; Domänen-Apps verfügen weiterhin über app-spezifische Quelloptionen wie die von Brain
+  Slack Kanal-Zulassungsliste oder Analytics-Metrik-/Dashboard-Konfiguration.
+- **Hub für geplante Jobs.** App-übergreifend [recurring jobs](/docs/recurring-jobs) hier live: „Jeden Wochentag um 7 Uhr die wichtigsten Kennzahlen von gestern aus der Analyse abrufen und morgens eine zusammenfassende E-Mail verfassen.“
+- **Dreams.** Dispatch kann aktuelle Agentenläufe, Fehler, Rückmeldungen und Erfolgsmuster überprüfen, um Verbesserungen in Bezug auf Gedächtnis, Fähigkeiten, Arbeit und Anweisungen vorzuschlagen, bevor etwas Dauerhaftes angewendet wird.
+- **Genehmigungsfluss.** Zerstörerische oder externe actions (Geld senden, eine ausgehende E-Mail versenden, in großem Umfang an Slack posten) können ein Administrator-OK erfordern, bevor sie ausgelöst werden. Dispatch ist Eigentümer der Warteschlange.
+
+## Wann sollte es verwendet werden? {#when-to-use}
+
+Verwenden Sie Dispatch, wenn:
+
+- Sie haben **zwei oder mehr** agentennative Apps in einem Arbeitsbereich und möchten, dass sie an einem Ort koordiniert werden.
+- Sie benötigen **zentralisierte Geheimnisse** mit Gewährung pro App und einem Audit-Trail.
+- Sie möchten einen **Messaging-Hub**, der Slack oder Telegram an den richtigen Domain-Agenten weiterleitet.
+- Sie möchten **geplante Jobs**, die Daten aus mehreren Apps abrufen.
+
+Überspringen Sie es für ein Einzel-App-Gerüst – verwenden Sie direkt [Chat template](/docs/template-chat) oder eine der Domänenvorlagen.
+
+Live-Demo: [dispatch.agent-native.com](https://dispatch.agent-native.com).
+
+## Was Sie damit machen werden {#what-youll-do}
+
+Tag für Tag ist Dispatch der Ort, an dem Administratoren und Betriebsmitarbeiter offen sind, um den Arbeitsbereich am Laufen zu halten:
+
+- **Verbinden Sie Slack, E-Mail und Telegram**, damit die Leute Ihrem Agenten von jedem Ort aus, an dem sie bereits arbeiten, Nachrichten senden können. Die Verdrahtungsschritte finden Sie unter [Messaging](/docs/messaging).
+- **Speichern Sie gemeinsame Geheimnisse einmal.** API-Schlüssel, OAuth-Tokens und Dienstanmeldeinformationen befinden sich im Tresor und die anderen Apps in Ihrem Arbeitsbereich ziehen von dort, anstatt dass jedes Teammitglied mit seinem eigenen `.env` jonglieren muss.
+- **Anbieter einmalig verbinden.** Wiederverwendbare Integrationen speichern sichere Kontometadaten
+  und Anmeldeinformationsreferenzen und gewähren Sie dann Apps wie Brain, Analytics, Mail oder
+  Verteilen Sie den Zugriff, ohne rohe Geheimnisse zu kopieren. App-spezifische Quelle
+  Konfiguration bleibt in der App, die den Anbieter verwendet.
+- **Einen MCP-Anschluss freilegen.** Hinzufügen
+  `https://dispatch.agent-native.com/_agent-native/mcp` in Claude, ChatGPT,
+  Codex, Cursor oder ein anderer MCP-Host und wählen Sie dann aus, welche Workspace-Apps verwendet werden sollen
+  -Connector kann über die **Agents**-Seite von Dispatch erreicht werden. Verwenden Sie eine direkte App URL
+  nur wenn dieser Host auf eine App isoliert werden soll.
+- **Automatisierungen verwalten.** Die Ansicht „Automatisierungen“ zeigt den aktivierten Status und die letzte Ausführung an.
+  nächster Lauf und letzter Fehler aus den zugrunde liegenden `jobs/*.md`-Zeitplänen und Lets
+  Sie aktivieren oder deaktivieren einen Job, ohne Dateien manuell bearbeiten zu müssen.
+- **Halten Sie den Unternehmenskontext global.** Fügen Sie Personas, Positionierung, Nachrichten, Unternehmensfakten, Markenrichtlinien und Leitplanken einmal in Dispatch Resources ein und zeigen Sie dann eine Vorschau des effektiven Arbeitsbereichs -> App/Organisation -> persönlichen Stapels für jede App/jeden Benutzer an oder überprüfen Sie den Stapel aus der Kontextansicht einer App-Karte.
+- **Richten Sie wiederkehrende Jobs ein.** „Fragen Sie jeden Montag um 7 Uhr den Analyseagenten nach den Anmeldungen der letzten Woche und senden Sie mir eine Zusammenfassung per E-Mail.“ Siehe [Recurring Jobs](/docs/recurring-jobs).
+- **Traumvorschläge überprüfen.** Dispatch Dreams prüft frühere Agentenläufe und erstellt quellengestützte Vorschläge dafür, was sich der Arbeitsbereich merken sollte, welche veralteten Notizen bereinigt werden sollten und welche wiederholten Lektionen zu skills oder Jobs werden sollten.
+- **Genehmigen Sie ausgehende actions, bevor sie ausgelöst werden.** Das Senden von Geld, das Versenden von Massen-E-Mails an Kunden oder das Posten in einem öffentlichen Slack-Kanal kann hinter einem Administrator-OK geschützt werden.
+- **Sehen Sie, wer Zugriff auf was hat.** Gewährungen pro App, Anforderungswarteschlange und ein Prüfprotokoll darüber, wer wann welches Geheimnis verwendet hat.
+- **Nachrichten an den richtigen Spezialisten weiterleiten.** Eine Slack DM über Analysen geht an den Analyseagenten; Eine über E-Mail geht an den Postagenten – Versandauswahl.
+
+## Architektur auf einen Blick {#architecture}
+
+_Wie es unter der Haube funktioniert (für Entwickler)._
+
+- **Orchestrator-Agent.** Der Chat ist als Router eingerichtet: Er liest `AGENTS.md`, `LEARNINGS.md` und leitet an spezialisierte Unteragenten oder entfernte A2A-Agenten weiter.
+- **Remote-Agent-Registrierung.** A2A-Agent-Manifeste sind Workspace-Runtime-Einträge (kein eingecheckter Vorlagenquellordner): In einem Multi-App-Arbeitsbereich werden gleichgeordnete Apps unter `apps/` automatisch als A2A-Peers erkannt – eine manuelle Registrierung ist nicht erforderlich. Dispatch ruft sie mit der Aktion `call-agent` auf.
+- **Vault-Schema.** Drizzle-Tabellen für Geheimnisse, Gewährungen, Anforderungen, Genehmigungen und Prüfprotokolle. Diese befinden sich im `@agent-native/dispatch`-Paket (`packages/dispatch/src/db/schema.ts`) und werden über `templates/dispatch/server/db/index.ts` erneut in die Vorlage exportiert – es gibt kein template-lokales `server/db/schema.ts`. Die Dispatch-Laufzeit wird im Paket und nicht in der Vorlagenquelle geliefert (im Einklang mit dem Hinweis unten, dass `@agent-native/dispatch` Eigentümer der Shell, der Seitenleiste und der integrierten Seiten ist).
+- **Slack / Telegram-Plugins.** Server-Plugins, die webhooks registrieren und eingehende Nachrichten an den Orchestrator-Agenten weiterleiten.
+- **Workspace MCP-Ressourcen.** Fügen Sie HTTP MCP-Serverdefinitionen unter `mcp-servers/*.json` in „Ressourcen“ hinzu und beschränken Sie sie dann auf „Alle Apps“ oder „Ausgewählte App-Zuweisungen“, genau wie „skills“ und „Kontext“.
+
+```an-schema title="Secrets vault schema" summary="Secrets are stored once; grants give a named app access; requests + reviews gate sensitive access; the audit log records who used which secret when. Defined in @agent-native/dispatch (packages/dispatch/src/db/schema.ts)."
+{
+  "entities": [
+    { "id": "secrets", "name": "vault_secrets", "note": "Stored credential values", "fields": [
+      { "name": "id", "type": "text", "pk": true },
+      { "name": "owner_email", "type": "text" },
+      { "name": "org_id", "type": "text", "nullable": true },
+      { "name": "name", "type": "text" },
+      { "name": "credential_key", "type": "text" },
+      { "name": "value", "type": "text", "note": "secret value" },
+      { "name": "provider", "type": "text", "nullable": true }
+    ] },
+    { "id": "grants", "name": "vault_grants", "note": "Per-app access grant", "fields": [
+      { "name": "id", "type": "text", "pk": true },
+      { "name": "secret_id", "type": "text", "fk": "vault_secrets.id" },
+      { "name": "app_id", "type": "text" },
+      { "name": "granted_by", "type": "text" },
+      { "name": "status", "type": "text" }
+    ] },
+    { "id": "requests", "name": "vault_requests", "note": "Access request + review", "fields": [
+      { "name": "id", "type": "text", "pk": true },
+      { "name": "credential_key", "type": "text" },
+      { "name": "app_id", "type": "text" },
+      { "name": "reason", "type": "text", "nullable": true },
+      { "name": "status", "type": "text" },
+      { "name": "reviewed_by", "type": "text", "nullable": true }
+    ] },
+    { "id": "audit", "name": "vault_audit_log", "note": "Who used which secret when", "fields": [
+      { "name": "id", "type": "text", "pk": true },
+      { "name": "secret_id", "type": "text", "fk": "vault_secrets.id", "nullable": true },
+      { "name": "app_id", "type": "text", "nullable": true },
+      { "name": "action", "type": "text" },
+      { "name": "actor", "type": "text" }
+    ] }
+  ],
+  "relations": [
+    { "from": "secrets", "to": "grants", "kind": "1-n", "label": "granted via" },
+    { "from": "secrets", "to": "audit", "kind": "1-n", "label": "use recorded by" }
+  ]
+}
+```
+
+- **MCP-Hub-Modus.** Dispatch kann weiterhin als [MCP hub](/docs/mcp-clients#hub) des Arbeitsbereichs fungieren, sodass jede andere App im Arbeitsbereich dieselbe MCP-Serverliste im Organisationsbereich abruft. Unabhängig davon ist der `/_agent-native/mcp`-Endpunkt von Dispatch der empfohlene externe MCP-Anschluss für Claude, ChatGPT und andere Hosts, die mehrere Workspace-Apps erreichen sollen.
+
+## Träume {#dreams}
+
+Träume sind die Überprüfungsschleife von Dispatch für das Agentengedächtnis. Ein Dream Pass untersucht vorhandene Agentenläufe, Thread-Debug-Daten, Feedback, Auswertungen und wiederholte Toolfehler und schreibt dann einen Bericht mit vorgeschlagenen Änderungen. Die Vorschläge können auf persönliches Gedächtnis, freigegebenes `LEARNINGS.md`, Arbeitsbereichsanweisungen, Arbeitsbereich skills, Arbeitsbereichswissen, Arbeitsbereichsagenten oder wiederkehrende Jobs abzielen, aber gemeinsame Änderungen und Änderungen auf Arbeitsbereichsebene bleiben überprüfbar und werden nicht stillschweigend angewendet.
+
+Traumvorschläge werden vor dem Speichern mit dem persönlichen Speicherindex, vorhandenen `memory/*.md`-Dateien und freigegebenen `LEARNINGS.md` überprüft. Doppelte Lektionen werden im Bericht übersprungen, während möglicherweise veraltete persönliche Erinnerungen an Ort und Stelle aktualisiert werden, anstatt parallele Notizen zu erstellen. Innerhalb eines Berichts dedupliziert Dreams außerdem wiederholte Beweise nach Thread, Signaltyp und normalisiertem Zitat, entzieht eingefügten Kontext der Benutzerkorrekturerkennung und fasst rohe Bewertungs-/Toolzeilen in für Menschen lesbaren Aufzählungszeichen zusammen, bevor sie im Vorschlagstext erscheinen. Wenn ein Pass Signale findet, aber absichtlich keine Vorschläge erstellt, enthält der Bericht Leitplankenhinweise, in denen erläutert wird, welche Beweise unterdrückt wurden.
+
+Wenn die Dispatch-Genehmigungsrichtlinie aktiviert ist, wird beim Anwenden eines gemeinsamen oder teamweiten Traumvorschlags eine ausstehende Genehmigungsanfrage erstellt, anstatt sofort zu schreiben. Durch das Erstellen, Aktualisieren oder Löschen einer All-App-Workspace-Ressource wird ebenfalls eine Genehmigungsanfrage in die Warteschlange gestellt. Persönliche Erinnerungsvorschläge und nur ausgewählte Ressourcenbearbeitungen können weiterhin direkt nach der Überprüfung angewendet werden.
+
+Verwenden Sie Dreams, wenn Sie Fragen beantworten möchten wie „Was haben Agenten diese Woche immer wieder falsch gemacht?“, „Woran sollten wir uns erinnern?“ oder „Welche wiederholte Lektion verdient eine Fertigkeit?“ Eingehende Slack-, E-Mail-, Telegram-, WhatsApp- und aus dem Internet abgeleitete Beweise werden als nicht vertrauenswürdige Eingaben behandelt. Daher müssen Vorschläge aus diesen Quellen überprüft und überprüft werden, bevor sie sich auf den gemeinsamen Speicher auswirken. Vorschläge für Arbeitsbereichsanweisungen erfordern dauerhafte Beweise, die sich über mindestens zwei Threads oder zwei Quell-Apps erstrecken; Nur-Bewertungsstörungen, Probleme bei der Kontoeinrichtung, Kontingentbeschränkungen und UI-Textkorrekturen für einzelne Apps bleiben in allgemeinen Anweisungen außen vor.
+
+### Dream-Eingabevalidierungsgrenzen
+
+Da Beweise aus externen, nicht vertrauenswürdigen Quellen gesammelt werden (z. B. Chat-Transkripte, webhooks und Integrationen von Drittanbietern), erzwingt der Dream-Prozessor strenge Eingabevalidierungsgrenzen, um Prompt-Injection- und Payload-Size-Angriffe zu verhindern:
+
+- **Byte-Größenbeschränkungen:** Einzelne Thread-Nutzlasten sind auf maximal 10 KB Textinhalt pro Nachricht begrenzt, und Kandidatenscans werden abgeschnitten, wenn sie insgesamt 100 KB überschreiten, um eine Kontexterschöpfung zu verhindern.
+- **Bereinigung:** Alle Texteingaben werden bereinigt, um Steuerzeichen, binäre Nutzdaten und nicht druckbare Unicode-Bereiche zu entfernen.
+- **Schemavalidierung:** Eingehende Debugdaten und Thread-Verlauf werden anhand strenger Zod-Schemas analysiert, bevor sie in LLM-Eingabeaufforderungen kompiliert werden. Jede Kandidatenstruktur, die die Schemavalidierung nicht besteht, wird sofort aus dem Verarbeitungsstapel verworfen.
+- **Escaping:** Alle vom Benutzer bereitgestellten Textblöcke werden dynamisch maskiert, wenn sie in die Eingabeaufforderungsvorlagen formatiert werden, um Eingabeaufforderungsinjektionen zu verhindern (z. B. den Versuch, die Dream-Schleife zu kapern, um beliebige Anweisungen zu schreiben).
+
+Öffnen Sie im Dispatch UI **Dreams**, um einen manuellen Durchgang durchzuführen, Kandidatenthreads zu überprüfen, den Bericht zu prüfen und das Überprüfungsblatt jedes Vorschlags zu öffnen, bevor Sie ihn anwenden oder ablehnen. Verwenden Sie **Einstellungen**, um den wiederkehrenden Cron-Zeitplan, den Quellbereich, die Zeitüberschreitungs-/Gleichzeitigkeitsgrenzen, die Kandidatengrenze und den Mindestkandidatenschwellenwert zu bearbeiten. Verwenden Sie **Zeitplan sicherstellen** nach dem Speichern, wenn der wiederkehrende `jobs/dispatch-dream.md`-Auftrag aus diesen Einstellungen materialisiert werden soll. Das Überprüfungsblatt zeigt das Genehmigungsverhalten, den aktuellen Zielinhalt, den vorgeschlagenen Inhalt und die Quellennachweise. Agenten verwenden denselben Workflow über actions:
+
+- `list-dream-candidates` findet aktuelle Threads mit begründeten Signalen wie explizite Benutzerkorrekturen, fehlgeschlagene Ausführungen, Toolfehler, Feedback, Bewertungsfehler und erfolgreiche Checkpoint-Workflows. Übergeben Sie `sourceId: "all"` oder `sourceIds`, um mehrere Thread-Debug-Quellen zu scannen. `sourceTimeoutMs`, `sourceConcurrency`, `sourceStartStaggerMs`, `threadConcurrency` und `threadTimeoutMs` sorgen für partielle und begrenzte Produktionsscans, und die Antwort umfasst den Zustand pro Quelle.
+- `create-dream-report` erstellt den Bericht und ausstehende Vorschläge. Multi-Source-Berichte enthalten einen Abschnitt „Source Health“, sodass Teilscans während der Überprüfung sichtbar sind. Wiederholte Korrekturen und wiederkehrende Fehler können zu Vorschlägen für Arbeitsbereichsressourcen wie `workspace-instruction` werden. Wiederholte erfolgreiche Checkpoint-Workflows können zu `workspace-skill`-Vorschlägen werden.
+- `get-dream-settings` und `set-dream-settings` lesen und aktualisieren den wiederkehrenden Traumplan, den Quellbereich, die Zeitüberschreitungs-/Parallelitätskontrollen, das Limit und den Mindestkandidatenschwellenwert.
+- `get-dream`-, `preview-dream-proposal`-, `apply-dream-proposal`- und `reject-dream-proposal`-Handle-Überprüfung.
+- `ensure-dream-job` erstellt den sicheren wiederkehrenden Traumjob, sobald manuelle Berichte nützlich sind.
+
+Der lokale Aktionsläufer der Dispatch-Vorlage macht auch den gepackten Dispatch actions verfügbar, sodass Sie in der Entwicklung denselben Workflow von `apps/dispatch` aus ausführen können:
+
+```bash
+pnpm action get-dream-settings
+pnpm action set-dream-settings --enabled true --schedule "0 9 * * 1" --allSources true --limit 8
+pnpm action create-dream-report --allSources true --sourceTimeoutMs 30000 --limit 8
+```
+
+## Gerüst {#scaffolding}
+
+```bash
+npx @agent-native/core@latest create my-platform
+# pick "Dispatch" in the multi-select picker, plus whichever domain apps you want
+```
+
+Wenn Sie die Vorlage lieber direkt benennen möchten, anstatt die Auswahl zu verwenden:
+
+```bash
+npx @agent-native/core@latest create my-platform --template dispatch
+# add more apps in the same workspace as you go
+```
+
+Dispatch ist normalerweise zusammen mit den von ihm koordinierten Apps in einen Arbeitsbereich integriert. Für einen Arbeitsbereich werden die gemeinsame Authentifizierung, Datenbank und Marke von Dispatch vom Arbeitsbereichskern geerbt – siehe [Multi-App Workspace](/docs/multi-app-workspace).
+
+Es gibt keinen sinnvollen `--standalone`-Versand: Eine Kontrollebene, die nichts zu koordinieren hat, ist nur ein leerer Posteingang. Integrieren Sie es in einen Arbeitsbereich mit mindestens einer Domänen-App, damit es über Agents verfügt, an die es über A2A weiterleiten kann. (Das Flag funktioniert weiterhin und erzeugt eine ausführbare App, aber der Orchestrator hat keine Spezialisten, an die er delegieren kann, bis Sie Geschwister-Apps hinzufügen.)
+
+## Erster lokaler Lauf {#first-local-run}
+
+Aus dem Arbeitsbereichsstamm:
+
+```bash
+pnpm install
+pnpm dev
+```
+
+Öffnen Sie den vom Entwicklungsserver gedruckten Dispatch URL. Die lokale Entwicklung verwendet denselben Better Auth-Anmeldeablauf wie die Produktion. Erstellen Sie ein lokales Konto mit E-Mail + Passwort; Die E-Mail-Verifizierung wird in der Entwicklung übersprungen und das Passwort wird nur in Ihrer lokalen App-Datenbank gespeichert. Im Standardgerüst wird keine Authentifizierungsumgehung unterstützt, da der Agent, die Arbeitsbereichsressourcen, der Tresor und das Freigabemodell alle auf einer echten Benutzersitzung basieren.
+
+Sie können nach der Anmeldung durch den Dispatch UI klicken. Um den Chat-Composer zu verwenden oder Agentenaufgaben auszuführen, verbinden Sie zunächst einen LLM-Anbieter:
+
+1. Öffnen Sie **Einstellungen**.
+2. In **LLM** verbinden Sie entweder Builder.io oder fügen Sie Ihren eigenen Anbieterschlüssel hinzu, z. B. `ANTHROPIC_API_KEY`.
+3. Kehren Sie zur **Übersicht** zurück und probieren Sie den Composer aus.
+
+## Anpassen {#customize}
+
+Dispatch ist eine vollständige Vorlage wie jede andere – siehe [Templates](/docs/cloneable-saas). Bitten Sie den Agenten, „eine neue Integration für Datadog hinzuzufügen“ oder „Slack-DMs von Kanal
+
+Für arbeitsplatzspezifische Verwaltungsbildschirme fügen Sie lokale React Router-Seiten und hinzu
+registrieren Sie sie in `app/dispatch-extensions.tsx`. Der generierte Arbeitsbereich besitzt
+nur die zusätzliche Registerkarte und Route; `@agent-native/dispatch` bleibt Eigentümer der Shell
+Seitenleiste, integrierte Seiten und zukünftige Paketaktualisierungen.
+
+## Was kommt als nächstes?
+
+- [**Messaging**](/docs/messaging) – verbindet Slack, E-Mail und Telegram, sodass Sie von überall aus mit Ihrem Agenten sprechen können
+- [**Multi-App Workspace**](/docs/multi-app-workspace) – Dispatch neben mehreren Apps ausführen
+- [**A2A Protocol**](/docs/a2a-protocol) – wie Dispatch an spezialisierte Agenten delegiert
+- [**MCP Clients — Hub Mode**](/docs/mcp-clients#hub) – gemeinsame Nutzung von MCP-Servern im gesamten Arbeitsbereich
+- [**Recurring Jobs**](/docs/recurring-jobs) – geplante Aufgaben-Dispatch-Ausführungen

package/corpus/core/docs/content/locales/de-DE/template-forms.md

@@ -0,0 +1,178 @@
+---
+title: "Formulare"
+description: "Agent-nativer Formularersteller – Erstellen, Bearbeiten, Veröffentlichen und Weiterleiten von Formulareinsendungen über natürliche Sprache und einen visuellen Editor."
+---
+
+# Formulare
+
+Forms ist ein agentennativer Formularersteller. Beschreiben Sie das gewünschte Formular, verfeinern Sie es im Editor und veröffentlichen Sie ein öffentliches Formular, das Einreichungen in Ihrer eigenen SQL-Datenbank speichert.
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px;padding:14px 16px;border-bottom:1.4px solid var(--wf-line)'><strong>Beta signup</strong><span class='wf-pill accent'>published</span><div style='flex:1'></div><button>Share</button><button class='primary'>Unpublish</button></div><div style='display:flex;gap:8px;padding:12px 16px;border-bottom:1.4px solid var(--wf-line)'><span class='wf-pill accent'>Edit</span><span class='wf-pill'>Results 187</span><span class='wf-pill'>Settings</span><span class='wf-pill'>Integrations</span></div><div style='display:flex;flex-direction:column;gap:12px;padding:30px 78px;overflow:hidden'><h2 style='margin:0'>Beta signup</h2><p class='wf-muted' style='margin:0'>Reserve a spot in the upcoming private beta cohort.</p><div class='wf-card'><strong>Full name</strong><input value='Ada Lovelace'/></div><div class='wf-card'><strong>Work email</strong><input value='you@company.com'/></div><div class='wf-card'><strong>Your role</strong><input value='Select...'/></div><div class='wf-card'><strong>Team size</strong><input value='Select...'/></div></div></div>"
+}
+```
+
+Wenn Sie die App öffnen, sehen Sie Ihre Formulare, den aktuellen Editor und eine Live-Vorschau. Der Agent kann aus einer Eingabeaufforderung heraus ein Formular erstellen, Feldbeschriftungen und Optionen aktualisieren, die Validierung ändern und Übermittlungsziele mit demselben actions verbinden, den UI verwendet.
+
+```an-diagram title="Build, publish, collect" summary="The agent and the visual editor edit one SQL-backed form definition. The public fill page is unauthenticated, and submissions route server-side to your destinations."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">Agent prompt<br><small class=\"diagram-muted\">\"add an NPS question\"</small></div><div class=\"diagram-node\">Visual editor<br><small class=\"diagram-muted\">labels, validation, order</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">create-form · update-form</span><small class=\"diagram-muted\">fields JSON, settings JSON</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">forms table<br><small class=\"diagram-muted\">SQL via Drizzle</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Public fill page<br><small class=\"diagram-muted\">unauthenticated</small></div><div class=\"diagram-box\">responses<br><small class=\"diagram-muted\">+ Slack / webhook / Sheets</small></div></div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## Was Sie damit machen können
+
+- **Erstellen Sie Formulare im Dialog.** „Erstellen Sie ein Kontaktformular“, „fügen Sie eine NPS-Bewertungsfrage hinzu“, „machen Sie das E-Mail-Feld zu einem Pflichtfeld.“ Der Agent aktualisiert das Formularschema und die Vorschauaktualisierungen aus dem durch SQL gesicherten Zustand.
+- **Optische Feinabstimmung.** Bearbeiten Sie Beschriftungen, Platzhalter, erforderlichen Status, Optionen und Feldreihenfolge im Builder UI, wenn Sie eine direkte Steuerung wünschen.
+- **Verwenden Sie die mitgelieferten Feldtypen.** Text-, E-Mail-, Nummern-, Langtext-, Auswahl-, Mehrfachauswahl-, Kontrollkästchen-, Radio-, Datums-, Bewertungs- und Skalenfelder werden standardmäßig unterstützt.
+- **Antworten sammeln.** Jede Einreichung wird in SQL mit einer Detailansicht pro Antwort und einem Dashboard zum Überprüfen von Einträgen gespeichert.
+- **Einreichungen weiterleiten.** Senden Sie Einreichungsnutzlasten mithilfe der integrierten Integrationen an webhooks, Slack, Discord oder Google Sheets.
+- **Öffentliche Formulare veröffentlichen.** Geben Sie ein öffentliches Formular URL frei und zeigen Sie nach dem Absenden eine Dankesnachricht an.
+
+## Erste Schritte
+
+Live-Demo: [forms.agent-native.com](https://forms.agent-native.com).
+
+1. **Erstellen Sie ein Formular aus einer Eingabeaufforderung.** Fragen Sie nach dem gewünschten Formular, einschließlich
+   Zielgruppe und was nach der Einreichung passieren soll.
+2. **Im Editor verfeinern.** Beschriftungen, Validierung, Auswahlmöglichkeiten und Reihenfolge anpassen in
+   der visuelle Builder, wenn die direkte Bearbeitung schneller ist.
+3. **Veröffentlichen und teilen.** Verwenden Sie das öffentliche Formular URL für Befragte und schauen Sie dann zu
+   Ergebnisse werden in der Ansicht „Antworten“ angezeigt.
+4. **Ziele verbinden.** Neue Einsendungen an Slack, Discord, Google weiterleiten
+   Sheets, webhooks oder Ihr eigener Erweiterungspunkt.
+
+### Nützliche Eingabeaufforderungen
+
+- „Erstellen Sie ein Beta-Anmeldeformular mit Rolle, Teamgröße und vorrangigem Anwendungsfall.“
+- „Fügen Sie eine erforderliche NPS-Frage und eine Freitext-Nachfrage hinzu.“
+- „Posten Sie jede neue Antwort im Produkt-Slack-Kanal.“
+- „Fassen Sie die Einsendungen dieser Woche zusammen und gruppieren Sie sie nach Kundensegment.“
+- „Machen Sie dieses Formular kürzer, ohne die Felder zu verlieren, die wir für die Weiterleitung benötigen.“
+
+## Für Entwickler
+
+Der Rest dieses Dokuments richtet sich an alle, die die Forms-Vorlage verzweigen oder erweitern.
+
+### Schnellstart
+
+```bash
+npx @agent-native/core@latest create my-forms --standalone --template forms
+cd my-forms
+pnpm install
+pnpm dev
+```
+
+Für einen Arbeitsbereich mit Forms neben anderen Apps:
+
+```bash
+npx @agent-native/core@latest create my-platform
+```
+
+Wählen Sie bei der Einrichtung des Arbeitsbereichs Formulare und andere gewünschte Vorlagen aus.
+
+### Hauptfunktionen {#key-features}
+
+**JSON Formulardefinitionen.** Felder befinden sich in einer `fields` JSON Spalte, sodass der Agent für jeden Feldtyp chirurgische Änderungen ohne Schemaänderungen vornehmen kann.
+
+**Öffentliche Ausfüllseiten.** Befragte können nicht authentifizierte Formulare einreichen, während private Einstellungen entfernt werden, bevor Daten den Browser erreichen.
+
+**Serverseitige Ziele.** Slack, Discord, Google Sheets und Webhook-Integrationen leben in den Formulareinstellungen und werden nach der Übermittlung ausgeführt.
+
+### Datenmodell
+
+Alle Daten leben in SQL über Drizzle ORM. Schema: `templates/forms/server/db/schema.ts`. Formulare enthalten den Standard `ownableColumns` und eine passende Framework-Freigabentabelle, sodass sie in das Freigabemodell pro Benutzer/pro Organisation passen.
+
+| Tabelle       | Was es enthält                                                                                                                                                                                                                       |
+| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `forms`       | Eine Formulardefinition – `title`, `description`, eindeutiges `slug`, `fields` (JSON-Array von `FormField`), `settings` (JSON `FormSettings`), `status` (`draft` / `published` / `closed`) und ein vorläufig gelöschter `deleted_at` |
+| `responses`   | Eine Einreichung pro Zeile – `form_id`, `data` (JSON `{ fieldId: value }`), `submitted_at`, optional `ip` und `submitter_email`                                                                                                      |
+| `form_shares` | Framework teilt Tabellenzuordnungsprinzipale (Benutzer oder Organisationen) zu Rollen (Betrachter, Bearbeiter, Administrator) pro Formular                                                                                           |
+
+Die Formen `fields` und `settings` JSON sind in `templates/forms/shared/types.ts` (`FormField`, `FormSettings`) definiert. Besitzerprivate Einstellungen wie Integrations-Webhooks URLs und zulässige Ursprünge werden entfernt, bevor Daten über `toPublicFormSettings` die öffentliche Füllseite erreichen.
+
+```an-schema title="Forms data model" summary="Three tables. Fields and integrations are JSON columns on forms, so the agent's edits are surgical patches rather than cross-table row changes."
+{
+  "entities": [
+    {
+      "id": "forms",
+      "name": "forms",
+      "note": "A form definition (ownable)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "title", "type": "string" },
+        { "name": "description", "type": "string", "nullable": true },
+        { "name": "slug", "type": "string", "note": "unique; public URL" },
+        { "name": "fields", "type": "json", "note": "FormField[] — all field types" },
+        { "name": "settings", "type": "json", "note": "FormSettings — integrations, etc." },
+        { "name": "status", "type": "enum", "note": "draft | published | closed" },
+        { "name": "deleted_at", "type": "datetime", "nullable": true, "note": "soft delete" },
+        { "name": "owner_email", "type": "string" },
+        { "name": "org_id", "type": "id", "nullable": true }
+      ]
+    },
+    {
+      "id": "responses",
+      "name": "responses",
+      "note": "One submission per row",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "form_id", "type": "id", "fk": "forms.id" },
+        { "name": "data", "type": "json", "note": "{ fieldId: value }" },
+        { "name": "submitted_at", "type": "datetime" },
+        { "name": "ip", "type": "string", "nullable": true },
+        { "name": "submitter_email", "type": "string", "nullable": true }
+      ]
+    },
+    {
+      "id": "form_shares",
+      "name": "form_shares",
+      "note": "Framework shares table — principals to roles per form",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "form_id", "type": "id", "fk": "forms.id" },
+        { "name": "principal", "type": "string", "note": "user or org" },
+        { "name": "role", "type": "enum", "note": "viewer | editor | admin" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "forms", "to": "responses", "kind": "1-n", "label": "has responses" },
+    { "from": "forms", "to": "form_shares", "kind": "1-n", "label": "has share grants" }
+  ]
+}
+```
+
+### Schlüssel actions
+
+Jeder Vorgang ist eine TypeScript-Datei in `templates/forms/actions/`, die automatisch unter `POST /_agent-native/actions/:name` gemountet wird:
+
+- `create-form` – ein neues Formular erstellen (Titel, Beschreibung, Felder, Einstellungen)
+- `update-form` – Felder, Einstellungen oder Status aktualisieren
+- `get-form` – ein Formular nach ID oder Slug abrufen
+- `list-forms` – barrierefreie Formulare auflisten
+- `delete-form` – vorläufiges Löschen (setzt `deleted_at`)
+- `restore-form` – ein vorläufig gelöschtes Formular wiederherstellen
+- `list-responses` – Einreichungen für ein Formular mit optionalen Filtern auflisten
+- `export-responses` – Antworten als CSV oder JSON exportieren
+
+### Anpassen
+
+Fragen Sie zuerst den Agenten nach dem Versandverhalten:
+
+- „Fügen Sie ein erforderliches Funkfeld für die bevorzugte Kontaktmethode hinzu.“
+- „Jede neue Einreichung an Slack posten.“ Verbinden Sie zuerst Slack über [Messaging](/docs/messaging).
+- „Fügen Sie ein Webhook-Ziel für unser CRM hinzu.“
+- „Erstellen Sie ein Kundenfeedback-Formular mit einer Skala von 1 bis 10 und einem langen Nachfasstext.“
+- „Machen Sie einige Formulare öffentlich und andere nur für die Anmeldung.“
+
+Wenn Sie neue Funktionen wie Datei-Uploads, Signaturen oder benutzerdefinierte Feld-Widgets benötigen, behandeln Sie diese als Vorlagenerweiterungen: Fügen Sie die SQL-Form, die Editor-Steuerelemente actions, UI, die Unterstützung für öffentliche Renderer und Agentenanweisungen zusammen hinzu. Das aktuelle Build-Muster finden Sie unter [Creating Templates](/docs/creating-templates).
+
+## Was kommt als nächstes?
+
+- [**Templates**](/docs/cloneable-saas) – das Modell zum Klonen und Besitzen
+- [**Actions**](/docs/actions) – das Aktionssystem, das den Builder antreibt
+- [**Messaging**](/docs/messaging) – Slack und andere Übermittlungsziele