Agent-Arbeitsübersicht — Spec V1
Stand: 2026-09-28 · Status: Implementiert (V1, Dashboard 0.1.450)
Reihenfolge: Nach Social-Agent Phase 6 (siehe Roadmap Agent-Ops)
Was
Eine System-Seite im Dashboard für Ops/Super Admin: Was passiert gerade / was passierte zuletzt über SMG Coding Agents, MCP, AgencyOS, Dispatch/Social-Agent — nicht Besucher-Chatbots.
Heute sind die Informationen verteilt (Feedback-Inbox, Dispatch, Workflow, Audit-Feeds, API-only). V1 bündelt sie in einem Feed + KPI-Zeile.
Warum
- Eine Person soll den Überblick über automatisierte Arbeit behalten, ohne zwischen fünf Menüs zu springen.
- Kein Ersatz für Redaktions-Workflows — Ergänzung für Betrieb/Entwicklung.
- Kein Live-Heartbeat in V1 — Polling über bestehende Tabellen reicht für den Start.
Wer ist betroffen
| Rolle | V1 |
|---|---|
| SUPER_ADMIN, PLATFORM_ADMIN, ORG_MARKETING_MANAGER | Ops-Board + Feed, KPIs, Deep-Links (Aggregation read-only) |
| Redaktion / KAM | Nein — nutzen Dispatch/Workflow/Social-Freigaben |
| Dev / Betrieb | Primäre Zielgruppe neben Super Admin |
Wo (Menü)
Redaktionsfluss → Steuerzentrale (/dashboard/redaktionsfluss/steuerung)
Neben Feedback-Inbox — gleiche Ops-Zielgruppe, anderer Scope (Gesamt-Feed vs. FB-Tickets).
Layout V1 (Polling 60 s)
KPI-Karten (letzte 24 h)
| Karte | Quelle |
|---|---|
| FB-Tickets „Agent in Arbeit“ | product_feedback (in_progress + claimedAt) |
| MCP/AgencyOS-Schreibaktionen | agency_os_actions |
| Dispatch in Agent-Pipeline | dispatch_item mit socialPostDraftId, Status ≠ INBOX |
Social in_review von Agenten | social_post_drafts (createdByRole agencyos / ai_assistant) |
Feed-Tabelle (gemischt, neueste zuerst)
| Spalte | Inhalt |
|---|---|
| Zeit | createdAt |
| Quelle | MCP · AgencyOS · Cursor-FB · Dispatch · Social |
| Actor | User-Name, Token-Prefix, Integrations-Name |
| Aktion | summary / Audit-action |
| Center | Name + Link |
| Status | Erfolg · Undo möglich · In Arbeit · Erledigt |
| Link | Feedback-Inbox, Dispatch-Detail, Workflow, Journal |
Filter-Chips: Quelle · Center · 1h / 24h / 7d · nur Schreibaktionen
APIs / Libs (wiederverwenden)
| Daten | Route / Lib |
|---|---|
| AgencyOS/MCP-Journal | GET /api/agencyos/v1/actions, agency-os-action-journal.ts |
| Audit (optional ergänzend) | GET /api/audit-logs, GET /api/agencyos/v1/audit-logs |
| Product Feedback | GET /api/product-feedback, Inbox-UI-Filter |
| Dispatch | dispatch_item + bestehende Dispatch-APIs |
| Social | social_post_drafts, social_post_draft_events |
| MCP last used | mcp_user_tokens.lastUsedAt |
Neu (V1): aggregierende BFF-Route, z. B. GET /api/admin/agent-activity-feed — Session, Rolle SUPER_ADMIN, parallele Reads, normalisierte Actor-Spalte.
Kein neues Datenmodell in V1.
Phasen
| Stufe | Inhalt | Aufwand (grob) |
|---|---|---|
| V1 | KPI + Feed + Filter, Polling 60 s, Super Admin | 3–5 Tage |
| V1.1 | KPI aus operational-briefing / Catch-up-Hinweise | 1–2 Tage |
| V2 | agent_runs-Tabelle + Heartbeat + SSE „läuft gerade“ | 5–8 Tage (eigenes Epic) |
Abhängigkeiten & Lücken
| Thema | V1-Verhalten |
|---|---|
| Kein Agent-Heartbeat | „Gerade aktiv“ = Proxy (claimedAt, lastUsedAt, letzte Journal-Zeile) |
| Cursor Cloud / GHA | Nur indirekt (FB-PR, API-Calls an Cockpit) |
| Lesende MCP-Läufe | In V1 unsichtbar (Journal = Schreibaktionen) |
| Actor-Normalisierung | userId vs. Integration vs. MCP-Token — Feed muss mappen |
Was V1 nicht ist
- Birds Eye PM-View — Portfolio/CRM, kein Agent-Monitor (Spec)
- Bots & Assistenten — Besucher-KI auf Center-Websites
- Integration → API-Logs — Tab noch Platzhalter
So testen (nach Implementierung)
- Als Super Admin System → Agent-Aktivität öffnen.
- MCP-Schreibaktion auslösen → Eintrag im Feed.
- FB-Ticket claimen → KPI „Agent in Arbeit“ steigt.
- Dispatch → Social-Entwurf (Pilot) → Eintrag Dispatch/Social.
- Filter Center + 24h prüfen.
Links
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/plattform/agent-arbeitsuebersicht-v1