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 / API | Zweck (Kurz) | Alltag heute? | Rolle (MCP-Policy) |
|---|---|---|---|
cockpit_operational_briefing | Social offen, Workflow-Entwürfe, GBP-Reviews, Reporting-Erinnerungen, hints[] | Pull-only (Agent/Robi) | read — alle authentifizierten Rollen mit Leserecht |
cockpit_kam_briefing_index | Operative Briefings gruppiert nach KAM-E-Mail (onlyWithActionItems) | Pull-only; Cron-Ziel in AgencyOS | read |
cockpit_content_quality_watch | Fehlende Logos/ÖZ, Inaktivität, Inhaltslücken pro Center | Pull-only | read |
cockpit_kam_quality_watch_index | Quality-Watch gruppiert nach KAM (onlyWithIssues) | Pull-only; Cron-Ziel AgencyOS center-quality-watch | read |
cockpit_expiring_content | Angebote/Events/News in N Tagen ablaufend | Pull-only (Redaktionsroutine) | read |
cockpit_content_gaps | Center unter Mindest-Schwellen (Offers/Events/News/Jobs) | Pull-only | read |
cockpit_activity_leaderboard | Top-Nutzer oder Top-Center nach Audit-Aktivität | Pull-only | activity — ORG_MARKETING_MANAGER, CENTER_ADMIN, PLATFORM_ADMIN, SUPER_ADMIN (seit 0.1.449 uneingeschränkt) |
cockpit_zero_activity_report | Center ohne Audit-Aktivität im Zeitraum | Pull-only | activity (wie oben) |
cockpit_work_activity | Leistung/Matrix Center×Person (summaryOnly) | Pull-only; Teil-Lösung für „aktiv heute?“ | activity |
cockpit_employee_activity | Detail-Aktivität einer Person | Pull-only | activity |
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) | Zweck | Status |
|---|---|---|
brief_my_work | Persö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 kombiniert | Noch 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) odercenterIds(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[]mitemail,centers[], je Centerbriefing(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, optionallimit(1–50) - Response: GBP-Reviews,
responseNeeded,hints[] - Beispiel:
{ "centerId": "uuid", "limit": 10 }
GET /api/me/catchup
- Auth: Dashboard-Session
- Parameter:
since=lastLoginoder 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änger | Quelle | Kanal | Frequenz |
|---|---|---|---|
| KAM (primär/Vertretung) | kam-briefing-index?onlyWithActionItems=true | Teams-DM via Robi | Täglich morgens |
| KAM (Qualität) | kam-quality-watch-index?onlyWithIssues=true | Teams-DM (separater Cron) | 1–2×/Woche oder täglich kurz |
| Plattform-Ops | zero-activity-report (7 Tage), globale KPI | Teams-Kanal oder Dashboard | Wöchentlich |
| Redaktion | expiring_content, E-Mail-Digest | E-Mail (existiert) / optional Teams | Täglich |
| Release-Team | Changelog | pnpm teams:update → Kanal Updates | Bei 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
| Komponente | Wo | Status |
|---|---|---|
| AgencyOS API-Key | COCKPIT_AGENCYOS_API_KEY | Vorhanden |
| KAM-Briefing Smoke | scripts/smoke-agencyos-kam-briefing-index.sh | Vorhanden |
| Quality-Watch Smoke | scripts/smoke-agencyos-content-quality-watch.sh | Vorhanden |
| Teams Release-Webhook | TEAMS_UPDATES_WEBHOOK_URL, pnpm teams:update | Vorhanden (Kanal Updates, nicht Ops) |
| cockpitOS Cron KAM-Briefing | POST /api/cron/kam-daily-briefing, GHA 6:00 UTC | Neu (0.1.414) — Ops-Teams-Kanal + JSON; persönliche DMs weiter AgencyOS |
AgencyOS Cron center-kam-briefing | SMG-AgencyOS-Repo | Doku referenziert, Implementierung extern (KAM-DMs via Robi) |
AgencyOS Cron center-quality-watch | SMG-AgencyOS-Repo | Doku referenziert, Implementierung extern |
| Robi MCP-Passthrough | AgencyOS spiegelt cockpitOS MCP | Vorhanden |
| Ops-Briefing Script | scripts/daily-operational-briefing.mjs | Entwurf/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)
| # | Bedarf | P | Empfehlung | Aufwand |
|---|---|---|---|---|
| 1 | Personal Catch-up beim Login („seit ich zuletzt da war“) | P1 | Teilweise (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 |
| 2 | Vertretung/Urlaub — Center ohne aktiven Betreuer | P1 | Build: Report „Center ohne primary KAM“ + „nur substitute“ + optional zero_activity_report — Endpoint oder Erweiterung organization_accountability. KAM-UI hat substitute bereits. | Klein–mittel |
| 3 | Duplikat-Warnung vor Create (nicht Audit danach) | P1 | Build: Pre-create Hook in Content-Push / Shop-Anlage — heuristische Titel-/Shop-Ähnlichkeit (shop-name-similarity.ts existiert). MCP-Hinweis optional. | Mittel |
| 4 | One-Click Call-Prep (letzte 3 Aktionen, Freigaben, Leistung) | P2 | Integrate: 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) | P2 | Integrate: cockpit_work_activity mit centerId, since=heute 00:00 Europe/Berlin, summaryOnly=true — Antwort activityCountInPeriod > 0. Kein neues Tool nötig. | Klein |
| 6 | Onboarding-Checklist neue Center (Theresien Straubing, Forum Gummersbach) | P2 | Build: 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
| Bedarf | Bestehendes Tool / API |
|---|---|
| Tages-To-dos KAM | kam-briefing-index, operational_briefing |
| Qualitäts-Alerts | kam-quality-watch-index, content_quality_watch |
| Content-Lücken | content_gaps, content_quality_watch |
| Ablaufende Inhalte | expiring_content → bulk_archive |
| Inaktive Center | zero_activity_report |
| Wer war aktiv? | activity_leaderboard, work_activity, employee_activity |
| Zuständigkeiten Org | organization_accountability, center_key_account_managers |
| Persönliche Benachrichtigungen | E-Mail-Digest (Cron) |
| Teams Release-Kommunikation | pnpm teams:update |
| Agent-Zugang | Robi MCP-Passthrough (bestehende Tools) |
Empfohlene Reihenfolge
- AgencyOS: Cron
center-kam-briefing+center-quality-watchan bestehende Index-APIs — größter Hebel, kein neues cockpitOS-Feature. - P1 Login Catch-up: Dashboard-Widget (sichtbarster Gewinn für Redaktion).
- P1 Center ohne Betreuer: Ops-Alert wöchentlich in Teams-Kanal.
- P2 Call-Prep + „aktiv heute?“ als Robi-Shortcuts (MCP-Ketten, kein neuer Backend-Code).
- P1 Duplikat vor Create beim nächsten Content-Push-Touch.
So testen
- Smoke KAM-Index:
COCKPIT_AGENCYOS_API_KEY=sk_… ./scripts/smoke-agencyos-kam-briefing-index.sh - Smoke Quality:
COCKPIT_AGENCYOS_API_KEY=sk_… CENTER_ID=uuid ./scripts/smoke-agencyos-content-quality-watch.sh - MCP lokal:
cockpit_kam_briefing_indexmitonlyWithActionItems: true - Ops-Entwurf:
node scripts/daily-operational-briefing.mjs --dry-run - Activity heute:
cockpit_work_activitymitcenterId,since= heute 00:00 UTC/Berlin
Links
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /plattform/proactive-briefing-roadmap