Skip to main content

Proaktive Briefings — Roadmap

Stand: 2026-09-29

Was / Warum​

cockpitOS hat bereits umfangreiche Briefing- und Watch-Tools (operativ, Qualität, Content-Lücken, Aktivität). Sie sind heute pull-only: Agenten und Robi liefern Wert erst, wenn jemand das passende Tool aufruft.

Der größte Hebel für den Alltag ist nicht noch mehr Analyse-Tools, sondern eine proaktive Routine: bestehende APIs/MCP-Tools täglich an die richtigen Empfänger — per Teams-DM (Robi/AgencyOS) oder Dashboard-Widget — ohne manuellen MCP-Aufruf.

Wer ist betroffen: KAMs, Center-Betrieb, Plattform-Admins, Redaktion (E-Mail-Digest existiert bereits).

Wo im Code: MCP-Registrierung packages/mcp-cockpit-os/src/register-cockpit-tools.ts, AgencyOS-APIs unter apps/dashboard/src/app/api/agencyos/v1/, Aggregat-Logik in apps/dashboard/src/lib/integration/.


Was schon da ist​

Tool / APIZweck (Kurz)Alltag heute?Rolle (MCP-Policy)
cockpit_operational_briefingSocial offen, Workflow-Entwürfe, GBP-Reviews, Reporting-Erinnerungen, hints[]Pull-only (Agent/Robi)read — alle authentifizierten Rollen mit Leserecht
cockpit_kam_briefing_indexOperative Briefings gruppiert nach KAM-E-Mail (onlyWithActionItems)Pull-only; Cron-Ziel in AgencyOSread
cockpit_content_quality_watchFehlende Logos/ÖZ, Inaktivität, Inhaltslücken pro CenterPull-onlyread
cockpit_kam_quality_watch_indexQuality-Watch gruppiert nach KAM (onlyWithIssues)Pull-only; Cron-Ziel AgencyOS center-quality-watchread
cockpit_expiring_contentAngebote/Events/News in N Tagen ablaufendPull-only (Redaktionsroutine)read
cockpit_content_gapsCenter unter Mindest-Schwellen (Offers/Events/News/Jobs)Pull-onlyread
cockpit_activity_leaderboardTop-Nutzer oder Top-Center nach Audit-AktivitätPull-onlyactivity — ORG_MARKETING_MANAGER, CENTER_ADMIN, PLATFORM_ADMIN, SUPER_ADMIN (seit 0.1.449 uneingeschränkt)
cockpit_zero_activity_reportCenter ohne Audit-Aktivität im ZeitraumPull-onlyactivity (wie oben)
cockpit_work_activityLeistung/Matrix Center×Person (summaryOnly)Pull-only; Teil-Lösung für „aktiv heute?“activity
cockpit_employee_activityDetail-Aktivität einer PersonPull-onlyactivity
E-Mail-Digest (email-digest.ts)Persönliche Benachrichtigungen (Social-Freigaben etc.)Proaktiv (Cron, nutzerkonfiguriert)Dashboard-User, kein MCP

AgencyOS-only (nicht in cockpitOS-Repo)​

Tool (AgencyOS)ZweckStatus
brief_my_workPersönliche Agenda (Planner, Tasks, Ops-Signale)Geplant — siehe docs/BIRDS-EYE-PM-VIEW-SPEC.md
GET /api/me/catchup„Seit ich zuletzt da war“ (Dashboard-Session)Implementiert (0.1.419) — Audit, Notifications, operative Highlights
get_catchup / cockpit_get_catchup (AgencyOS)Planner + Ops kombiniertNoch AgencyOS — siehe Birds-Eye-Spec

Tool-Details (Parameter & Beispiel)​

cockpit_operational_briefing​

  • Datei: packages/mcp-cockpit-os/src/register-cockpit-tools.ts → GET /api/agencyos/v1/operational-briefing
  • Parameter: centerId (UUID) oder centerIds (kommagetrennt, max. 30)
  • Response: social, workflow, reviews, reporting, hints[], hasActionItems, kams[]
  • Beispiel: { "centerId": "550e8400-e29b-41d4-a716-446655440000" }

cockpit_kam_briefing_index​

  • Datei: apps/dashboard/src/app/api/agencyos/v1/kam-briefing-index/route.ts
  • Parameter: onlyWithActionItems (boolean, default false), kamEmail (optional, exakter KAM-Match)
  • Response: recipients[] mit email, centers[], je Center briefing (vollständiges Operational-Briefing)
  • Beispiel: { "onlyWithActionItems": true, "kamEmail": "nina@example.com" }

cockpit_google_reviews_monitor​

  • Datei: GET /api/agencyos/v1/centers/{centerId}/google-reviews
  • Parameter: centerId, optional limit (1–50)
  • Response: GBP-Reviews, responseNeeded, hints[]
  • Beispiel: { "centerId": "uuid", "limit": 10 }

GET /api/me/catchup​

  • Auth: Dashboard-Session
  • Parameter: since=lastLogin oder ISO-Datum
  • Response: summary, recentAudit, recentNotifications, operationalHighlights

cockpit_content_quality_watch​

  • Parameter: centerId / centerIds, onlyWithIssues, inactiveDays, minOffers, minEvents, minNews, minJobs
  • Response: qualityHints[], hasQualityIssues, Aktivitätskennzahlen
  • Beispiel: { "centerIds": "uuid1,uuid2", "onlyWithIssues": true }

cockpit_kam_quality_watch_index​

  • Parameter: wie Quality-Watch + onlyWithIssues (default true)
  • Response: recipients[] gruppiert nach KAM-E-Mail
  • Beispiel: { "onlyWithIssues": true, "inactiveDays": 21 }

cockpit_expiring_content​

  • Parameter: centerId, days (default 7), contentType, includeExpired, limit
  • Beispiel: { "days": 10, "contentType": "offer,event", "includeExpired": true }

cockpit_content_gaps​

  • Parameter: minOffers, minEvents, minNews, minJobs, organizationId
  • Beispiel: { "minOffers": 10, "minEvents": 10, "organizationId": "org-uuid" }

cockpit_activity_leaderboard / cockpit_zero_activity_report​

  • Leaderboard: scope (users|centers), since, until, limit, entityType, organizationId, centerId
  • Zero-Activity: since, until, organizationId, centerId, limit
  • Beispiel Leaderboard: { "scope": "users", "since": "2026-07-01", "limit": 10 }
  • Beispiel Zero: { "since": "2026-09-19", "until": "2026-09-26", "centerId": "uuid" }

Hinweis Rollen-Policy: Briefing-/Watch-Tools = Kategorie integration → Tier read. Activity-Tools = Tier activity (nicht für VIEWER/CONTENT_EDITOR; Super Admin seit 0.1.449 wieder voll). Developer: Activity im Code-Default gesperrt. Siehe packages/mcp-cockpit-os/src/role-mcp-tool-policy.ts.


Hebel 1: Proaktive Routine (daily Teams)​

Architektur (Ist → Soll)​

cockpitOS liefert Daten (REST + MCP). AgencyOS/Robi liefert Zustellung (Cron, User-Match über KAM-E-Mail, Teams-DM). Das ist bereits in der Doku verankert (api-agencyos-integration.md → Operational Briefing, Content Quality Watch).

Wer bekommt was?​

EmpfängerQuelleKanalFrequenz
KAM (primär/Vertretung)kam-briefing-index?onlyWithActionItems=trueTeams-DM via RobiTäglich morgens
KAM (Qualität)kam-quality-watch-index?onlyWithIssues=trueTeams-DM (separater Cron)1–2×/Woche oder täglich kurz
Plattform-Opszero-activity-report (7 Tage), globale KPITeams-Kanal oder DashboardWöchentlich
Redaktionexpiring_content, E-Mail-DigestE-Mail (existiert) / optional TeamsTäglich
Release-TeamChangelogpnpm teams:update → Kanal UpdatesBei VERSION-Bump

Global vs. KAM: KAM-Indexe aggregieren nur Center mit zugewiesenem KAM (Cockpit center_key_account_managers). Center ohne KAM erscheinen nicht in KAM-DMs — dafür braucht es Ops-Alerts (siehe Lücken #2).

Env / Cron / Infrastruktur​

KomponenteWoStatus
AgencyOS API-KeyCOCKPIT_AGENCYOS_API_KEYVorhanden
KAM-Briefing Smokescripts/smoke-agencyos-kam-briefing-index.shVorhanden
Quality-Watch Smokescripts/smoke-agencyos-content-quality-watch.shVorhanden
Teams Release-WebhookTEAMS_UPDATES_WEBHOOK_URL, pnpm teams:updateVorhanden (Kanal Updates, nicht Ops)
cockpitOS Cron KAM-BriefingPOST /api/cron/kam-daily-briefing, GHA 6:00 UTCNeu (0.1.414) — Ops-Teams-Kanal + JSON; persönliche DMs weiter AgencyOS
AgencyOS Cron center-kam-briefingSMG-AgencyOS-RepoDoku referenziert, Implementierung extern (KAM-DMs via Robi)
AgencyOS Cron center-quality-watchSMG-AgencyOS-RepoDoku referenziert, Implementierung extern
Robi MCP-PassthroughAgencyOS spiegelt cockpitOS MCPVorhanden
Ops-Briefing Scriptscripts/daily-operational-briefing.mjsEntwurf/Local — Produktion über Cron-Endpoint

Empfehlung: KAM-DMs nicht duplizieren in cockpitOS-Cron, sondern AgencyOS-Cron an kam-briefing-index anbinden (E-Mail-Match, Robi-Formatierung). cockpitOS-Skeleton nur für globalen Ops-Kanal oder lokale Smoke/Entwürfe.


Was fehlt (Prioritäten)​

#BedarfPEmpfehlungAufwand
1Personal Catch-up beim Login („seit ich zuletzt da war“)P1Teilweise (0.1.419): API GET /api/me/catchup?since=lastLogin — Audit, Notifications, operative Highlights. Offen: Dashboard-Widget, AgencyOS brief_my_work für Planner.Mittel
2Vertretung/Urlaub — Center ohne aktiven BetreuerP1Build: Report „Center ohne primary KAM“ + „nur substitute“ + optional zero_activity_report — Endpoint oder Erweiterung organization_accountability. KAM-UI hat substitute bereits.Klein–mittel
3Duplikat-Warnung vor Create (nicht Audit danach)P1Build: Pre-create Hook in Content-Push / Shop-Anlage — heuristische Titel-/Shop-Ähnlichkeit (shop-name-similarity.ts existiert). MCP-Hinweis optional.Mittel
4One-Click Call-Prep (letzte 3 Aktionen, Freigaben, Leistung)P2Integrate: BFF-Endpoint oder MCP-Macro — kombiniert operational_briefing + employee_activity (limit 3) + work_activity summary für Center. Robi-Shortcut oder Dashboard-Karte.Klein
5„War heute jemand für Center X aktiv?“ (Ja/Nein)P2Integrate: cockpit_work_activity mit centerId, since=heute 00:00 Europe/Berlin, summaryOnly=true — Antwort activityCountInPeriod > 0. Kein neues Tool nötig.Klein
6Onboarding-Checklist neue Center (Theresien Straubing, Forum Gummersbach)P2Build: Template-spezifische Checkliste (Forum Gummersbach: 23 Reiter — Hints in forum-gummersbach-mcp-tab-fields.ts). Dashboard „Go-Live-Checklist“-Widget wiederverwenden/erweitern (cockpit_center_project_init hat Checklist-Muster).Mittel

Nicht neu bauen — Wiederverwenden​

BedarfBestehendes Tool / API
Tages-To-dos KAMkam-briefing-index, operational_briefing
Qualitäts-Alertskam-quality-watch-index, content_quality_watch
Content-Lückencontent_gaps, content_quality_watch
Ablaufende Inhalteexpiring_content → bulk_archive
Inaktive Centerzero_activity_report
Wer war aktiv?activity_leaderboard, work_activity, employee_activity
Zuständigkeiten Orgorganization_accountability, center_key_account_managers
Persönliche BenachrichtigungenE-Mail-Digest (Cron)
Teams Release-Kommunikationpnpm teams:update
Agent-ZugangRobi MCP-Passthrough (bestehende Tools)

Empfohlene Reihenfolge​

  1. AgencyOS: Cron center-kam-briefing + center-quality-watch an bestehende Index-APIs — größter Hebel, kein neues cockpitOS-Feature.
  2. P1 Login Catch-up: Dashboard-Widget (sichtbarster Gewinn für Redaktion).
  3. P1 Center ohne Betreuer: Ops-Alert wöchentlich in Teams-Kanal.
  4. P2 Call-Prep + „aktiv heute?“ als Robi-Shortcuts (MCP-Ketten, kein neuer Backend-Code).
  5. P1 Duplikat vor Create beim nächsten Content-Push-Touch.

So testen​

  1. Smoke KAM-Index: COCKPIT_AGENCYOS_API_KEY=sk_… ./scripts/smoke-agencyos-kam-briefing-index.sh
  2. Smoke Quality: COCKPIT_AGENCYOS_API_KEY=sk_… CENTER_ID=uuid ./scripts/smoke-agencyos-content-quality-watch.sh
  3. MCP lokal: cockpit_kam_briefing_index mit onlyWithActionItems: true
  4. Ops-Entwurf: node scripts/daily-operational-briefing.mjs --dry-run
  5. Activity heute: cockpit_work_activity mit centerId, since = heute 00:00 UTC/Berlin

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/plattform/proactive-briefing-roadmap