Skip to main content

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​

StufeInhaltIst in cockpitOS
1 IntakeE-Mail-Webhook (Dispatch), Teams-Hook (Phase 6)Dispatch-Inbound E-Mail + Teams produktiv (0.1.445)
2 ZuordnungCenter aus Inhalt; Bestätigung bei MehrdeutigkeitAnalyze-KI; kein Domain-Mapping
3 Content-AgentCaption/Entwurf mit Center-Persona (brandDna)Caption-API nutzt brandDna; Dispatch-Analyze noch nicht
4 KonfidenzZwei-Achsen-Score (Qualität + Risiko), min-Achse entscheidetNeubau; bestehender Analyze-Confidence nur Triage-Hinweis
5 Publish/ReviewAuto-Publish oder Review-QueueSocial-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​

PhaseLieferungStatus
0socialPostDraftId auf DispatchItem, Status-Sync Social → Dispatch, BackfillErledigt (0.1.434)
1brandDna in Analyze + Caption; Vollständigkeits-Check Pilot-CenterErledigt (0.1.435) — Analyze: Marken-Kurzhinweis; create-draft: Caption-Refinement
2CenterSocialReviewer (primary/substitute) + Auto-VorbelegungErledigt (0.1.439)
3Postfach-Pilot, alles → Review, Konfidenz nur anzeigenErledigt (0.1.440)
4Social-Lernvorschläge + Freigabe-InboxErledigt (0.1.441)
5Konfidenz-Routing + Auto-Publish pro CenterErledigt (0.1.444)
6Teams-Hook bei Dispatch-Intake (AgencyOS-Muster)Erledigt (0.1.445)
7Auto-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.

BausteinBeschreibung
TriggerPOST /api/dispatch/[id]/analyze ruft intern maybeTriggerDispatchAutoDraft auf
SchalterdispatchAutoDraftEnabled (Organisation oder Center-Abweichung) im Freigabe-Pool-Tab, unabhängig vom Social-Agent-Pilot
BedingungenAuto-Entwurf an, Center eindeutig zugeordnet, Content-Kanal erkennbar, Konfidenz-Gate ≥ Schwellwert, Freigabe-Pool vorhanden
Konfidenzmin(contentQualityScore, 1 − contentRiskScore) oder Legacy-confidence; Schwellwert: Center socialAgentAutoPublishMinGate, Env DISPATCH_AUTO_DRAFT_MIN_GATE (Default 0,65)
ErgebnisMit 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
FreigabeforceReviewOnly — Auto-Publish wird auf diesem Pfad nie ausgeführt
SteuerungDispatch-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​

BausteinBeschreibung
InboundAgencyOS (oder Teams-Workflow) leitet normalisierte Payload an Cockpit: Absender, Betreff/Text, Anhänge-URLs, optional teamsMessageId / conversationId
RoutePOST /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
DispatchItemWie E-Mail: fromEmail/fromName aus Teams-User, sourceChannel: "teams", Body in bodyText
AnalyzeUnverä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
IdempotenzDedup ü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):

VariableBeschreibung
AGENCYOS_TEAMS_DISPATCH_INTAKE_URLOptional — Ops-Benachrichtigung bei neuem Teams-Dispatch
DISPATCH_TEAMS_WEBHOOK_SECRETBearer/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​

Phase 4 — Technik​

  • DB: social_learning_proposals — aus Social-Ablehnung, Status pending → 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_IDS optional 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_IDS optional zusätzlich. Pilot-Center: Social-Entwurf aus Dispatch → automatisch in_review (Freigabe-Pool Phase 2).
  • Vererbung: Center-Felder null = Organisations-Wert; expliziter Center-Wert = Abweichung. API: revertAgentSettingsToOrganization: true setzt 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-draft setzt assignedApproverIds + approvalMode: any; Freigabe-Dialog nutzt Pool vor localStorage-Favoriten.
  • MCP/AgencyOS: GET/PUT …/social-reviewers (Center + Organisation); Tools cockpit_center_social_reviewers, cockpit_set_center_social_reviewers, …

Phase 0 — Technik​

  • DB: Additives Feld socialPostDraftId (nullable) auf dispatch_item; Backfill aus SocialPostDraft.source = dispatch:{id}.
  • Sync: Bei Social-Status in_review → Dispatch IN_REVIEW; published/scheduled → PUBLISHED; rejected → IN_PROGRESS; Dual-Kanal (Web + Social): kein Downgrade von PUBLISHED.
  • API: create-draft setzt socialPostDraftId beim Anlegen.

Wo testen​

  1. Dispatch-E-Mail → Social-Entwurf anlegen → Status „Entwurf erstellt“.
  2. Zur Freigabe senden → Dispatch „In Prüfung“.
  3. Freigeben/Veröffentlichen → Dispatch „Veröffentlicht“.
  4. Ablehnen → Dispatch „In Bearbeitung“.
  5. Phase 4: Ablehnung mit Grund → Lernvorschlag in Social-Freigaben → Freigabe → nächster Caption-/Analyze-Prompt enthält Regel.

Betrieb nach Deploy (Phasen 2–5)​

SchrittAktion
Migrationen (Render Shell)… · 20261005180000_org_social_agent_pilot_SAFE.sql (Org-Pilot + Vererbung)
Freigabe-PoolOrganisation → KAM-Tab oder Center → Team → Social-Freigabe-Pool (Primär + Vertretung)
Pilot + Auto-PublishOrg KAM-Tab oder Center Team-Tab: Social-Agent Pilot + optional Auto-Publish + Schwellwert %
Lern-LeadOrg/Center → Freigabe-Pool → Person Lern-Lead ankreuzen
Smoke Phase 5Dispatch analysieren → Entwurf: hohe Scores = Publish, niedrige = Freigabe-Inbox

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/plattform/social-agent-modus