SocialHub.AI
Technische Referenz · Socialhub Harness

Die Laufzeitumgebung, die jeden KI-Akteur ausführt.

Ein Modell liefert Ihnen die Sprache. Es kann sich jedoch nicht selbstständig zuverlässig auf Ihre realen Daten stützen, das richtige Tool auswählen und korrekt aufrufen, sich bei einem Aufruffehler erholen, eine mehrstufige Aufgabe erfolgreich abschließen oder einen reproduzierbaren Ablauf dokumentieren. Die Socialhub Harness ist die Enterprise-Agent-Laufzeitumgebung, die all dies ermöglicht – die Ausführungs-Engine, die ein leistungsfähiges Modell in einen zuverlässigen Agenten verwandelt.

Jeder KI-Akteur in Flash — die Marketing-, Loyalitäts- und Risikomanager, der Mitgliederbetreuer und alle im Hintergrund wirkenden Akteure — ist ein Agentendefinition: ein strukturierter Entwurf (Modellrouting, Kontextquellen, Fähigkeiten, Werkzeuge, jeweils mit einem Geltungsbereich, ein MCP Oberfläche, Arbeitsablauf, Speicher und eine Schleifenrichtlinie), die Das Die Laufzeitumgebung wird ausgeführt. Und da jeder Akteur eine einzige Laufzeitumgebung durchläuft, ist Governance kein separates Produkt – sie ist eine strukturelle Eigenschaft der einheitlichen Ausführung: Ein Modell liefert die Sprache; eine Laufzeitumgebung liefert die Aktion; eine einheitliche Laufzeitumgebung liefert die Steuerung kostenlos.

Diese Referenz ist die Sicht des Entwicklers auf diese Laufzeit – was sie zur Ausführungszeit tut, welchen Definitionstyp sie ausführt und welche Achsen sie hat, wie sich Fertigkeiten zu ausgeführten Schritten zusammensetzen, die reproduzierbare Trajektorie, die jeder Lauf in das Ereignisprotokoll ausgibt, und die Wachen, die entstehen, wenn alles an einem Ort ausgeführt wird. Den Geschäftsüberblick finden Sie auf der Socialhub Harness Produktseite.

Was die Laufzeitumgebung zur Ausführungszeit tut

Beginnen Sie hier, denn dies ist der Kern des gesamten Systems. Sobald ein Durchlauf startet, übernimmt die Harness-Laufzeitumgebung die Aufgaben, die ein Sprachmodell nicht selbst erledigen kann – die fünf unten aufgeführten Schritte in dieser Reihenfolge – und das Ergebnis ist eine vollständig abgeschlossene Aufgabe und eine nachvollziehbare Trajektorie.

1 · Context assembly

Die Laufzeitumgebung gibt dem Akteur Halt: Sie stellt für jeden Durchlauf das Briefing und die realen Geschäftsdaten – Aufgaben, Mitglieder-/Segment-Aggregationen, Marken-Kit, Kennzahlen – zusammen, wobei personenbezogene Daten minimiert werden. Das Modell rät niemals über Ihre Daten; es erhält sie direkt.

2 · Model routing

Die Laufzeitumgebung ermittelt anhand der Definition, welche Inferenz-Engine welchen Schritt ausführt, mit Fallbacks. Routing ist Aufgabe der Laufzeitumgebung, nicht der Eingabeaufforderung.

3 · Skill composition into steps

Die Laufzeitumgebung fügt die geordneten Schritte und Entscheidungshinweise der zusammengesetzten Fähigkeiten in die Eingabeaufforderung ein, sodass eine benannte, versionierte Prozedur ausgeführt wird – und nicht das, was das Modell improvisiert hat.

4 · The tool loop

Die Laufzeit steuert die Select-Call-Observe-Schleife: Sie wählt ein verwaltetes Tool aus, prüft die Berechtigung, ruft es auf, liest das Ergebnis und stellt es bei einem Fehler wieder her oder eskaliert – die Zuverlässigkeit, die einem reinen Modellaufruf fehlt.

5 · A reproducible trajectory

Jeder Schritt wird der Reihe nach im ereignisgesteuerten Protokoll protokolliert – versehen mit einer Ausführungs-ID und der genauen Blueprint-Version. So ist die Ausführung Schritt für Schritt nachvollziehbar und reproduzierbar.

Ein Modell liefert die Sprache; eine Laufzeitumgebung liefert die Aktion; eine einheitliche Laufzeitumgebung liefert die Governance kostenlos. Alles Folgende – die Definition, die die Laufzeitumgebung ausführt, wie Fähigkeiten zusammengesetzt sind, das von ihr erzeugte Ereignisprotokoll und die zugehörigen Schutzmechanismen – ergibt sich aus diesen fünf Schritten, die für jeden Akteur an einer Stelle ausgeführt werden.

Anatomie eines Agenten – Definition: Was die Laufzeitumgebung ausführt

Die Laufzeitumgebung führt eine Definition aus: eine strukturierte Vorlage – kein Code, keine Freitexteingabe –, die sich aus den unten aufgeführten Teilen zusammensetzt. Die Bearbeitung eines dieser Teile erzeugt eine neue, versionierte Vorlage, die die Laufzeitumgebung beim nächsten Durchlauf verwendet. Die Version wird jedem Ereignis hinzugefügt, das dieser Durchlauf ausgibt.

BlaupausenteilWoraus es besteht
Modell-RoutingWelche Reasoning Engine jeden Schritt ausführt – und die Fallbacks. Es benennt das Modell; Die Laufzeit löst es.
KontextquellenDie Briefing- und Geschäftsdaten, mit denen der Akteur arbeitet – Aufgaben, Mitglieder-/Segment-Aggregationen, Marken-Kit, Kennzahlen – werden pro Durchlauf zusammengestellt und personenbezogene Daten minimiert.
FähigkeitenDie strukturierten, auf den Schauspieler abgestimmten Handlungsabläufe (siehe unten). Benannte Prozeduren, keine freie Anweisung.
ToolsDie dem Akteur erlaubten Aktionen – jede mit einem festgelegten Geltungsbereich. Die Definition benennt ein Werkzeug; sie gewährt es jedoch niemals. Die Datenbank ist die maßgebliche Instanz.
MCP-OberflächeWelche Tools werden über das Model Context Protocol für einen externen Agenten bereitgestellt, der über einen bereichsbezogenen Schlüssel verfügt, und unter welchen Gängen?
WorkflowDie geordneten Schritte oder der Graph, den die Laufzeit steuert – Anspruch erheben, lesen, entscheiden, handeln, abschließen – für Arbeitslisten- und orchestrierte Akteure.
SpeicherWas der Akteur über Schritte und Durchläufe hinweg mitnimmt und was er jedes Mal neu lesen muss. Beschränkt, kein Notizblock für personenbezogene Daten.
SchleifenrichtlinieDie Stoppregel: maximale Schritte, Budgetobergrenze und die Eskalation-zu-Mensch-Bedingung. Die Laufzeit erzwingt es; der Schauspieler kann es nicht verlängern.

Eine Definition benennt eine Funktion; sie gewährt sie jedoch nie. Eine Definition kann auf ein Tool, ein Modell oder eine Datenquelle verweisen. Ob dieser Arbeitsbereich und dieser Schlüssel diese tatsächlich verwenden dürfen, wird von der Laufzeitumgebung zur Aufrufzeit anhand der Datenbank ermittelt. Die Blaupause bildet die Kompositionsoberfläche; da die Laufzeitumgebung die Berechtigung zentral auflöst, sind die darunterliegenden Schutzmechanismen automatisch wirksam.

Ein Definitionstyp, beschrieben über drei Achsen.

Es gibt einen einzigen Definition-Typ für jeden Akteur. Dieser wird nicht pro Persona aufgeteilt, sondern entlang orthogonaler Achsen beschrieben. Daher gelten dieselbe Laufzeitumgebung, dasselbe Ereignisprotokoll und dieselben Schutzmechanismen, unabhängig davon, ob es sich um einen externen Agenten, eine Flash-Schleife oder einen Einmalgenerator handelt.

AchseWerteWas es einfängt
runtimeFormmcp_external · server_orchestrator · inline_functionWIE die Definition ausgeführt wird. mcp_external = ein externer Agent mit einem Gültigkeitsbereichsschlüssel, der über MCP anruft. server_orchestrator = eine in-Flash-Schleife, die die Laufzeit Schritt für Schritt steuert. inline_function = ein Single-Shot-Generator, der im Fluss eines Bildschirms aufgerufen wird.
agentTypeemployee · chatbot · functionWAS es für das Unternehmen bedeutet: Mitarbeiter = ein namentlich genannter Mitarbeiter, den Sie verwalten (Ziele, Aufgaben, Feedback). Chatbot = eine auf realen Daten basierende Gesprächsoberfläche. Funktion = ein Generator oder Klassifikator mit einem einzigen Zweck und ohne Persönlichkeit.
Technische Artagent · generator · embedded · custom · workflowDie technische Klassifizierung des Blueprints – ein zusammengesetzter, mehrstufiger Agent, ein Inline-Generator, eine eingebettete Funktion, eine benutzerdefinierte Workspace-Definition oder ein mehrstufiger Workflow-Graph.
GeschäftsdomäneEine von 8 Domänen (rechts)WELCHEN Teil des Geschäfts bedient es: Marketing und Kampagne, Loyalität und Bindung, Risiko und Compliance, Mitgliederservice, Inhalte und Kreativität, Kundeninformationen, Analysen und Erkenntnisse, Forschung und Simulation.

Über 40 gesteuerte Akteure, ein Modell. Die Live-Liste besteht aus 5 zusammengesetzten Agenten (mehrstufig, serverseitig orchestriert: die vier Manager plus der Mitglieder-Concierge), 28 Inline-Funktionen (einmalige Generatoren und Klassifikatoren, die in das Produkt integriert sind) und 8 eingebetteten Funktionen (In-Flow-Hilfsfunktionen auf einem Bildschirm). Alle diese Elemente gehören demselben Definitionstyp an und unterscheiden sich lediglich entlang der oben genannten Achsen.

Fähigkeiten: Datenbankautorisierte Playbooks, die auf einem Agenten basieren

Eine Fähigkeit ist ein strukturiertes Handbuch, das in der Datenbank gespeichert und in das Profil eines Agenten integriert wird, ähnlich wie man einem neuen Mitarbeiter eine Standardarbeitsanweisung (SOP) aushändigt. Es handelt sich nicht um einen Absatz mit Handlungsanweisungen, sondern um einen getippten Datensatz mit folgenden Bestandteilen:

trigger

Die Bedingung, unter der diese Funktion im aktuellen Durchlauf angewendet wird.

required state

Der Mitglieds-/Unternehmensstatus, der für die verantwortungsvolle Durchführung der Tätigkeit erforderlich ist – fehlt er, ist die Einrichtung für eine Person nicht möglich.

tool allowlist

Die Auswahl an Tools, die der Agent für diese Funktion nutzen kann – eine Einschränkung, keine Erweiterung dessen, was der Plan bereits vorsieht.

ordered steps

Die Prozedur, die die Laufzeit durchläuft, der Reihe nach.

verifier rules

Die Prüfungen, die das Ergebnis weitergeben müssen, bevor der Schritt als erledigt gilt.

decision guidance

Wie man wählt – einschließlich wann HALTEN oder eskalieren soll – wird als Anleitung ausgedrückt, nicht als fest codierter Zweig.

Zur Laufzeit – was also ausgeführt wird, ist nicht „was auch immer sich das Modell ausgedacht hat“, sondern eine benannte, versionierte Prozedur, die Ihr Team lesen und genehmigen kann. Da Fertigkeiten datenbankautorisierend sind, kann die gleiche Fertigkeit auf mehr als einen Agenten verteilt werden, und durch eine Änderung ändert sich jeder Agent, der sie verwendet – eine erneute Bereitstellung ist nicht erforderlich.

Ausgabe der Laufzeitumgebung: ein reproduzierbarer Ablauf

Die Erstellung eines nachvollziehbaren Verlaufs ist Schritt 5 der Laufzeitumgebung – und dient gleichzeitig als Prüfnachweis. Unabhängig vom Akteur und dessen Ausführungsmethode erzeugt jeder Durchlauf einen Ereignisstrom in einem einzigen, nur erweiterbaren Ereignisprotokoll (). Jedes Ereignis wird mit einer Durchlauf-ID () und der exakten Blueprint-Version (Definition) () versehen, die es erzeugt hat. Dadurch ist ein Durchlauf nachvollziehbar und wiederholbar. Die von einem Durchlauf erzeugten Ereignistypen in der Reihenfolge:

01Lauf gestartet02Nutzerintention03Kontext geladen04Modell ausgewählt05Prompt zusammengestellt06Begründung07Berechtigungsprüfung08Werkzeug namens09Werkzeugergebnis10Aktion / Ergebnis11Kosten12Lauf beendet

Darüber hinaus enthält das Protokoll die gespiegelten MCP-Toolaufrufe (wenn der Akteur Flash über MCP steuert) und das abschließende Geschäftsergebnis – sodass die gesamte Entwicklung von der Absicht zum Ergebnis an einem Ort stattfindet.

// one run's trajectory (abbreviated — every event carries runId + definitionVersion)
{
  "runId": "run_a1f9…",
  "definition": "loyalty-manager",
  "definitionVersion": 4,
  "events": [
    { "type": "run_started",     "at": "2026-08-26T09:14:02Z" },
    { "type": "user_intent",     "intent": "work the win-back worklist" },
    { "type": "context_loaded",  "sources": ["task", "member_rollup", "churn_signal"] },
    { "type": "model_selected",  "model": "…" },
    { "type": "prompt_assembled","skill": "winback-worklist-execution" },
    { "type": "reasoning",       "summary": "high value, at-risk, consented" },
    { "type": "permission_check","tool": "issue_coupon", "result": "allowed" },
    { "type": "tool_called",     "tool": "issue_coupon", "args": { "value": 10 } },
    { "type": "tool_result",     "ok": true },
    { "type": "cost",            "tokens": 3120, "usd": 0.04 },
    { "type": "run_ended",       "outcome": "coupon issued · within budget" }
  ]
}

Verfolgen Sie den Verlauf eines Laufs über die Flash-App. Rufen Sie einen Lauf anhand der ID ab oder listen Sie die letzten Läufe auf:

# one run's full trajectory
GET https://flash.socialhub.ai/api/flash/agent-runs/{runId}

# list recent runs
GET https://flash.socialhub.ai/api/flash/agent-runs

Einträge werden nie bearbeitet, sondern nur angehängt – das Protokoll dokumentiert die vollständige Historie der Aktionen jedes Akteurs und deren Gründe, Schritt für Schritt rekonstruierbar anhand der gespeicherten Ausführungs-ID und der Blueprint-Version.

Kostenlose Governance: Fünf ausfallsichere Schutzmechanismen

Hier ist der Nutzen einer einheitlichen Laufzeit. Da die Ausführung jedes Akteurs eine Laufzeit durchläuft, muss die Sicherheitsuntergrenze nicht an jeden Agenten angeschraubt werden – es ist eine strukturelle Eigenschaft des einzelnen Ortes, den alle Aktionen durchlaufen. Diese fünf Wächter sind Code-eigene, werden von jedem Akteur bei jeder Aktion ausgeführt und können durch keine Einstellung ausgeschaltet werden. Die Zusammensetzung einer Definition – ihre Fähigkeiten, Werkzeuge, Modell und Kontext – können Sie in der AI Employees-Konsole konfigurieren; Die Wachen unten sind es nicht.

SchutzWas es erzwingt
Autorisierungsbereich × TarifstufeJeder Toolaufruf wird anhand des Gültigkeitsbereichs des Schlüssels UND des Planlevels des Workspace geprüft. Die Definition benennt ein Tool; die Berechtigung zur Ausführung befindet sich in der Datenbank und wird zum Zeitpunkt des Aufrufs ermittelt. Ein Tool, auf das der Schlüssel nicht zugreifen kann, wird einfach ausgeblendet.
Schreibwertobergrenzen + RateWertbestimmende Schreibvorgänge (Punkte, Gutscheine) sind durch eine Obergrenze pro Aufruf und eine Schreibratenbegrenzung pro Schlüssel beschränkt. Beide werden serverseitig bei einem Fehler durchgesetzt – unabhängig von den Angaben des Nutzers in der Eingabeaufforderung oder der clientseitigen Bestätigung.
BudgetbuchhaltungJeder Lauf wird im Rahmen eines Token- und Kostenbudgets ausgeführt, das vorab aufgeladen wird, bevor der Akteur handelt, und während der Ausführung abgezogen wird. Wenn das Hauptbuch erschöpft ist, stoppt der Lauf – ein Akteur kann niemals mit seinen Ausgaben davonlaufen.
Kill-SwitchJeder Akteur – sei es eine ganze Definition oder eine einzelne Aktion – kann sofort pausiert werden. Standardmäßig deaktiviert, im aktivierten Zustand begrenzt und jederzeit stoppbar.
AuditJeder Schritt wird mit der Ausführungs-ID und der genauen Blueprint-Version in das schreibgeschützte Ereignisprotokoll geschrieben. Nichts, was ein Akteur tut, bleibt unprotokolliert, und keine Einstellung kann einen Protokolleintrag unterdrücken.

Konfigurieren Sie die Komposition unter /flash/agents. In der AI Employees-Konsole bearbeiten Sie die Fähigkeiten, Werkzeuge, das Modell und den Kontext eines Akteurs und erstellen so einen neuen versionierten Entwurf. Was Sie dort niemals bearbeiten können, ist die Sicherheitsuntergrenze: Die fünf oben genannten Schutzmaßnahmen werden im Code und nicht in der Konfiguration durchgesetzt.

Wobei der Harness zum Rest der Plattform passt

Die Harness ist die Ausführungsumgebung für jeden KI-Akteur – und da alles darüber läuft, auch die Governance-Ebene. Zwei angrenzende Verweise beschreiben die Komponenten, auf denen sie basiert:

  • MCP Oberfläche. Ein mcp_external-Akteur besitzt einen Bereichsschlüssel und ruft die verwalteten Tools von Flash über das Model Context Protocol auf. Endpunkt, Authentifizierung, Clientkonfiguration und der vollständige Toolkatalog sind im Integrationsleitfaden MCP enthalten.
  • Autorisierungsmechanismen & Genehmigungen. Die Mechanismen pro Aktion (automatisch / Überprüfung / verboten), die Semantik des ausstehenden / abgelehnten Schreibvorgangs und der Genehmigungslebenszyklus, die über der Autorisierungssicherung liegen, sind in KI-Governance: Introspektion & Genehmigungen dokumentiert.