Social-Agent-Modus (Grobkonzept)
Stand: 2026-09-28 · Ziel: Eine Person kann die Erstellungsarbeit mehrerer Redakteur:innen übernehmen — KI-Agenten erstellen, Menschen prüfen und geben frei.
Ausgangslage
Center-Meldungen kommen über Postfach, Teams, Anruf, SMS und WhatsApp. Daraus entstehen Social-Media-Posts — heute größtenteils manuell mit leichter KI-Unterstützung. cockpitOS soll denselben Output mit deutlich weniger Personal ermöglichen.
Fünf Stufen
| Stufe | Inhalt | Ist in cockpitOS |
|---|---|---|
| 1 Intake | E-Mail-Webhook (Dispatch), Teams-Hook (Phase 6) | Dispatch-Inbound E-Mail + Teams produktiv (0.1.445) |
| 2 Zuordnung | Center aus Inhalt; Bestätigung bei Mehrdeutigkeit | Analyze-KI; kein Domain-Mapping |
| 3 Content-Agent | Caption/Entwurf mit Center-Persona (brandDna) | Caption-API nutzt brandDna; Dispatch-Analyze noch nicht |
| 4 Konfidenz | Zwei-Achsen-Score (Qualität + Risiko), min-Achse entscheidet | Neubau; bestehender Analyze-Confidence nur Triage-Hinweis |
| 5 Publish/Review | Auto-Publish oder Review-Queue | Social-Freigaben (in_review); Auto-Publish pro Pilot-Center (Phase 5, Schwellwert) |
Manuelle Kanäle (Anruf, SMS, WhatsApp) bleiben bewusst außerhalb der Automatisierung.
Entscheidungen (2026-09-28)
Freigabe-Pool statt fester Person
Kein einzelner Default-Freigeber pro Center. Stattdessen ein Pool nach dem KAM-Muster (primary / substitute), optional mit Org-Fallback. Der Agent-Modus weist Drafts automatisch dem Pool zu (approvalMode: any); Vertretung für einen Tag über substitute im Dashboard — kein Urlaubskalender in Phase 0.
Learnings mit Freigabe
Ablehnungsgründe werden nicht automatisch in Prompts übernommen. Ablauf: Ablehnung → SocialLearningProposal (pending) → Benachrichtigung an Social-Lead → Freigabe → erst dann im nächsten Prompt (Phase 4).
brandDna überall nötig
loadBrandDnaPromptSection() in Analyze (Triage/Risiko) und Caption (Output). Konfidenz-Scoring baut darauf auf (Phase 5).
Implementierungsphasen
| Phase | Lieferung | Status |
|---|---|---|
| 0 | socialPostDraftId auf DispatchItem, Status-Sync Social → Dispatch, Backfill | Erledigt (0.1.434) |
| 1 | brandDna in Analyze + Caption; Vollständigkeits-Check Pilot-Center | Erledigt (0.1.435) — Analyze: Marken-Kurzhinweis; create-draft: Caption-Refinement |
| 2 | CenterSocialReviewer (primary/substitute) + Auto-Vorbelegung | Erledigt (0.1.439) |
| 3 | Postfach-Pilot, alles → Review, Konfidenz nur anzeigen | Erledigt (0.1.440) |
| 4 | Social-Lernvorschläge + Freigabe-Inbox | Erledigt (0.1.441) |
| 5 | Konfidenz-Routing + Auto-Publish pro Center | Erledigt (0.1.444) |
| 6 | Teams-Hook bei Dispatch-Intake (AgencyOS-Muster) | Erledigt (0.1.445) |
| 7 | Auto-Entwurf nach KI-Analyse (ohne Auto-Publish) | Erledigt (0.1.585) |
Phase 5 — Technik
- Routing: KI-Analyse liefert
contentQualityScore+contentRiskScore. Gate = min(Qualität, 1 − Risiko). - Auto-Publish: Schalter im Center-Tab Social-Freigabe-Pool (nur bei aktivem Pilot). Schwellwert default 75 %, konfigurierbar.
- Entscheidung: Pilot + Auto-Publish an + Gate ≥ Schwellwert → direkt veröffentlichen; sonst → Freigabe (
in_review). Fehlende Scores → sicher Freigabe. - Lib:
social-agent-confidence-routing.ts—resolveSocialAgentDraftRouting,applySocialAgentAutoPublish.
Phase 7 — Auto-Entwurf nach KI (ohne Auto-Publish)
Ziel: Nach erfolgreicher Dispatch-Analyse automatisch einen Social-Entwurf anlegen — immer zur menschlichen Freigabe, nie stilles Live-Schalten.
| Baustein | Beschreibung |
|---|---|
| Trigger | POST /api/dispatch/[id]/analyze ruft intern maybeTriggerDispatchAutoDraft auf |
| Schalter | dispatchAutoDraftEnabled (Organisation oder Center-Abweichung) im Freigabe-Pool-Tab, unabhängig vom Social-Agent-Pilot |
| Bedingungen | Auto-Entwurf an, Center eindeutig zugeordnet, Content-Kanal erkennbar, Konfidenz-Gate ≥ Schwellwert, Freigabe-Pool vorhanden |
| Konfidenz | min(contentQualityScore, 1 − contentRiskScore) oder Legacy-confidence; Schwellwert: Center socialAgentAutoPublishMinGate, Env DISPATCH_AUTO_DRAFT_MIN_GATE (Default 0,65) |
| Ergebnis | Mit Pool: Social-Entwurf in_review. Ohne Pool oder ohne Bild: Fall bleibt in der Dispatch-Prüfung, nächster Schritt im selben Fall. Audit autoDraftTriggeredAt |
| Freigabe | forceReviewOnly — Auto-Publish wird auf diesem Pfad nie ausgeführt |
| Steuerung | Dispatch-Detail ↔ Redaktions-Steuerzentrale (?highlight=dispatch:{id}); Badge „Entwurf offen“ auf Home/Dispatch |
Manueller Button Entwurf erstellen bleibt unverändert (inkl. optionalem Auto-Publish bei manuellem Anlegen).
Phase 6 — Technik
Ziel: Teams als Intake-Kanal für Dispatch — gleiche Pipeline wie E-Mail (POST /api/dispatch/inbound → Analyze → Entwurf/Freigabe).
Scope V1
| Baustein | Beschreibung |
|---|---|
| Inbound | AgencyOS (oder Teams-Workflow) leitet normalisierte Payload an Cockpit: Absender, Betreff/Text, Anhänge-URLs, optional teamsMessageId / conversationId |
| Route | POST /api/dispatch/inbound/teams (Webhook) und POST /api/agencyos/v1/dispatch/intake (AgencyOS-Key) — Auth via DISPATCH_TEAMS_WEBHOOK_SECRET / DISPATCH_WEBHOOK_SECRET bzw. Bearer |
| DispatchItem | Wie E-Mail: fromEmail/fromName aus Teams-User, sourceChannel: "teams", Body in bodyText |
| Analyze | Unverändert nach Anlage — Social-Agent-Pilot/Auto-Publish greifen wie bei E-Mail-Intake |
| Notify Ops (optional) | HTTP-Hook an AgencyOS analog agencyos-teams-notify.ts — Event dispatch-intake an konfigurierte Ops/KAM-Liste |
| Idempotenz | Dedup über teamsMessageId (neues optionales Feld auf dispatch_item) |
AgencyOS-Vertrag (neu)
Analog Social-Review Teams-Hook:
- Cockpit → AgencyOS:
POST …/notifications/dispatch-intake(optional, Env-gated) - AgencyOS → Cockpit: Teams-Webhook empfängt Nachricht, mappt auf Inbound-Body
Env-Vorschlag (Cockpit):
| Variable | Beschreibung |
|---|---|
AGENCYOS_TEAMS_DISPATCH_INTAKE_URL | Optional — Ops-Benachrichtigung bei neuem Teams-Dispatch |
DISPATCH_TEAMS_WEBHOOK_SECRET | Bearer/Header für Inbound von AgencyOS |
Nicht in Phase 6
- Antworten in Teams aus dem Cockpit (nur Intake)
- Vollautomatischer Entwurf ohne Analyze
- Ersetzung der E-Mail-Inbound-Route
Aufwand & Abhängigkeiten
- Cockpit: 4–6 Tage (Route, Dedup-Feld, Tests, Doku, optional Notify-Client)
- AgencyOS: paralleler Endpoint + Teams-Bot-Subscription
- Reihenfolge: Roadmap Agent-Ops — vor Agent-Arbeitsübersicht V1
Phase 4 — Technik
- DB:
social_learning_proposals— aus Social-Ablehnung, Statuspending→approved|dismissed. - Flow: Ablehnung erzeugt Vorschlag + Benachrichtigung an als Lern-Lead markierte Personen im Freigabe-Pool (Org/Center-UI). Env
SOCIAL_AGENT_LEARNING_LEAD_USER_IDSoptional als Override. - Inbox: Social-Freigaben → Karte Social-Lernvorschläge; Freigabe durch Org-Marketing/Super-Admin.
- Prompts: Nur freigegebene Regeln hängen an
loadBrandDnaPromptSection()(Caption, Dispatch-Refinement).
Phase 3 — Technik
- Pilot: Schalter Social-Agent Pilot auf Organisationsebene (Organisation → Tab KAM → Social-Freigabe-Pool) oder pro Center mit Abweichung. Gilt für alle Center der Organisation, sofern dort nicht abweichend konfiguriert. Env
DISPATCH_SOCIAL_AGENT_PILOT_CENTER_IDSoptional zusätzlich. Pilot-Center: Social-Entwurf aus Dispatch → automatischin_review(Freigabe-Pool Phase 2). - Vererbung: Center-Felder
null= Organisations-Wert; expliziter Center-Wert = Abweichung. API:revertAgentSettingsToOrganization: truesetzt Center wieder auf Vererbung. - Konfidenz: Analyze liefert optional
contentQualityScore+contentRiskScore— Anzeige im Dispatch-Detail, kein Auto-Publish/Routing (Phase 5).
Phase 2 — Technik
- DB:
center_social_reviewers,organization_social_reviewers(primary/substitute, Org-Vererbung wie KAM). Org-Felder:dispatch_social_agent_pilot_enabled,dispatch_auto_draft_enabled,social_agent_auto_publish_*. - Dashboard: Center → Team & Ansprechpartner → Social-Freigabe-Pool; Organisation → Einstellungen → Organisationen → [Org] → Tab KAM (Social-Freigabe-Pool + Pilot-Schalter).
- Auto-Vorbelegung: Dispatch
create-draftsetztassignedApproverIds+approvalMode: any; Freigabe-Dialog nutzt Pool vor localStorage-Favoriten. - MCP/AgencyOS:
GET/PUT …/social-reviewers(Center + Organisation); Toolscockpit_center_social_reviewers,cockpit_set_center_social_reviewers, …
Phase 0 — Technik
- DB: Additives Feld
socialPostDraftId(nullable) aufdispatch_item; Backfill ausSocialPostDraft.source = dispatch:{id}. - Sync: Bei Social-Status
in_review→ DispatchIN_REVIEW;published/scheduled→PUBLISHED;rejected→IN_PROGRESS; Dual-Kanal (Web + Social): kein Downgrade vonPUBLISHED. - API:
create-draftsetztsocialPostDraftIdbeim Anlegen.
Wo testen
- Dispatch-E-Mail → Social-Entwurf anlegen → Status „Entwurf erstellt“.
- Zur Freigabe senden → Dispatch „In Prüfung“.
- Freigeben/Veröffentlichen → Dispatch „Veröffentlicht“.
- Ablehnen → Dispatch „In Bearbeitung“.
- Phase 4: Ablehnung mit Grund → Lernvorschlag in Social-Freigaben → Freigabe → nächster Caption-/Analyze-Prompt enthält Regel.
Betrieb nach Deploy (Phasen 2–5)
| Schritt | Aktion |
|---|---|
| Migrationen (Render Shell) | … · 20261005180000_org_social_agent_pilot_SAFE.sql (Org-Pilot + Vererbung) |
| Freigabe-Pool | Organisation → KAM-Tab oder Center → Team → Social-Freigabe-Pool (Primär + Vertretung) |
| Pilot + Auto-Publish | Org KAM-Tab oder Center Team-Tab: Social-Agent Pilot + optional Auto-Publish + Schwellwert % |
| Lern-Lead | Org/Center → Freigabe-Pool → Person Lern-Lead ankreuzen |
| Smoke Phase 5 | Dispatch analysieren → Entwurf: hohe Scores = Publish, niedrige = Freigabe-Inbox |
Links
- Social-Freigaben
- Brand-DNA
- Dispatch / Developer
- Roadmap Agent-Ops — Phase 6 + Agent-Arbeitsübersicht
- Agent-Arbeitsübersicht V1 Spec
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/plattform/social-agent-modus