OK

OK steht für Operational Knowledge. Gemeint ist operatives Wissen über aktuellen Dienstzustand: zu welchem Dienst ein Tab gehört, welche sichtbaren Fakten frisch genug sind und welche Annahmen vor einer Handlung neu beobachtet werden müssen.

OK ist Novas Live-Wissensschicht für laufende Webdienste in Browser-Tabs. Es speichert Beobachtungen über sichtbaren Dienstzustand und macht aus akzeptierten Beobachtungen aktuelle Fakten mit Vertrauen, Aktualität und Konfliktbehandlung.

OK unterscheidet sich von PKS und ETM. PKS speichert wiederverwendbares Website-Verhalten. ETM speichert Aufgabenepisoden und Abschlussbedingungen. OK beantwortet die unmittelbare Frage: Was wirkt jetzt gerade in diesem Tab oder Dienstkontext wahr?

Agenten nutzen OK nicht als manuelles Notizbuch. Normale Browser-Werkzeuge können Ziel- und Dienstzustand automatisch auffrischen. Eine OK-Beobachtung nutzt ein Agent nur, wenn ein wichtiger sichtbarer Zustand sonst fehlen würde, etwa Login, aktives Modell, Tarifstufe, Seitentyp, Sprache, Darstellung oder verfügbare Dienstfunktionen.

Kurz gesagt

• OK speichert aktuellen Dienstzustand, keine dauerhaften Website-Playbooks.
• Ein Beobachtungsaufruf kann mehrere strukturierte Claims aus demselben Seitenmoment melden.
• Akzeptierte Claims werden zu aktuellen Fakten; schwache oder widersprüchliche Claims können Beobachtung bleiben oder Warnungen erzeugen.
• Aktualität zählt: Fakten außerhalb des OK-Hinweisfensters werden aufgefrischt, bevor sie zustandsabhängige Arbeit leiten.
• Unbekannte kanonische core-Signale werden abgelehnt; eigene Namensräume können die Beobachtungsfläche erweitern.
• OK kann Regelprüfungen und Aufgaben-Kontext stützen, ersetzt aber weder aktuelle Seitenbestätigung noch Nutzerfreigaben.

Was OK speichert

OK hält ein kompaktes Zustandsbild rund um das aktuelle Browser-Ziel, den erkannten Dienst und sichtbare Dienstfakten.

1. Ziel- und Dienstkontext OK kann ein Browser-Ziel einem erkannten Webdienst, aktueller URL, Origin, Route und Bindungszustand zuordnen.
2. Beobachtungen Eine Beobachtung hält fest, was ein Agent oder ein Systemsignal zu einem bestimmten Zeitpunkt gesehen hat. Agenten melden Beobachtungen als strukturierte Claims.
3. Fakten Ein Fakt ist der aktuell akzeptierte Wert eines Signals in einem Ziel- oder Dienstkontext, etwa Login-Zustand, aktives Modell, Tarifstufe, Seitentyp, Sprache oder Theme.
4. Aktualität OK vergleicht Beobachtungszeit und aktuellen Seitenkontext. Die Wahrnehmung kann Hinweise zurückgeben, wenn Fakten fehlen, älter als das Aktualitätsfenster sind oder zu einer vorherigen URL gehören.
5. Konfliktbehandlung Wenn ein neuer Wert dem aktuellen Fakt widerspricht, behält OK den bestehenden Fakt, markiert einen Konflikt oder ersetzt ihn durch stärkere Evidenz.
6. Abgeleitete Fähigkeiten Einige Dienstfakten können zu Fähigkeiten werden, zum Beispiel ob ein Dienst eingeloggt wirkt oder ob eine Funktion sichtbar verfügbar ist.

Wann brauche ich OK?

OK gehört zu Aufgaben, die vom Live-Zustand einer Website abhängen: prüfen, ob ein Nutzer eingeloggt wirkt, welches Modell oder welcher Tarif sichtbar ist, ob eine Funktion verfügbar ist, ob sich die Route nach einer Navigation geändert hat oder ob der aktuelle Zustand zu unsicher für einen zuverlässigen nächsten Schritt ist.

Wissensmodell für Agenten

Für einen Agenten beantwortet OK vier Fragen: welcher Dienstkontext ist aktiv, welche sichtbaren Claims darf ich melden, welche Fakten sind aktuell genug und welche Unsicherheit muss vor einer Handlung aufgelöst werden?

Target und Binding

Das Browser-Ziel und der erkannte Dienstkontext, zu dem eine Beobachtung gehört. Ein Fakt aus einem Target darf nicht still auf ein anderes Target übertragen werden.

Signal-Key

Ein strukturierter Schlüssel für ein Zustandssignal. Kanonische öffentliche Schlüssel nutzen den core-Namensraum; eigene dienstspezifische Schlüssel müssen weiterhin dem Format namespace.path folgen.

Claim

Eine einzelne gemeldete Beobachtung innerhalb eines OK-Aufrufs. Ein Claim enthält Signal-Key, beobachteten Wert, optionale Evidenz und Sicherheit.

Fakt

Der aktuell akzeptierte Wert eines Signals, nachdem OK Beobachtungen, Vertrauen, Supersedence und Konflikte verarbeitet hat.

Certainty

Die Sicherheitsstufe des Agenten für einen Claim. Certain ist stark, likely ist Standard, tentative ist schwache Orientierung.

Freshness

Alter und Seitenpassung eines Fakts. Die Wahrnehmung fordert eine neue Beobachtung an, wenn relevante Fakten fehlen, alt sind oder zu einer vorherigen URL gehören.

Capability

Ein nutzbarer Zustand, der aus Fakten abgeleitet wird, etwa ein eingeloggter Dienst oder sichtbare Funktionsverfügbarkeit.

So nutzen Agenten OK-Infos

Für Agenten ist OK eine Live-Zustandsfläche. Sie zeigt, wann beobachtet werden soll, wie sichtbarer Zustand gemeldet wird und wann gespeicherter Zustand zu alt, schwach oder widersprüchlich ist, um eine zustandsabhängige Handlung zu leiten.

1. Aktuelle Seite lesen Der Agent nutzt nova.perceive oder ein anderes Lesewerkzeug, um die sichtbare Seite zu prüfen. Die Wahrnehmung kann okHints enthalten, wenn operativer Zustand Aufmerksamkeit braucht.
2. OK-Hinweise prüfen Wenn okHints.shouldObserve true ist, liest der Agent missingOrStaleKeys, firstVisit und urlChanged, bevor er entscheidet, was er meldet.
3. Nur sichtbaren Zustand melden Der Agent ruft nova.ok_observe mit Claims auf, die auf der aktuellen Seite sichtbar sind. Er meldet keine Passwörter, Tokens, versteckte Kontodaten oder geratenen Zustand.
4. OK verarbeitet die Claims OK gibt accepted, rejected, superseded, facts[] und optionale warnings[] zurück, damit der Agent sieht, was passiert ist.
5. Zustand als Orientierung nutzen Frische Fakten können spätere Entscheidungen leiten, aber aktuelle Seitenwahrnehmung und Sicherheitsgrenzen entscheiden weiter, ob eine Handlung erlaubt ist.
6. Unsicheren Zustand auffrischen Wenn ein Fakt veraltet, tentative, conflicted oder an eine alte URL gebunden ist, sollte der Agent vor Login-, Account-, Modell-, Billing- oder Feature-sensitiven Schritten neu beobachten.

Wann OK-Zustand gilt

OK-Zustand ist keine Klick-Erlaubnis. Er ist verlässliche Orientierung nur dann, wenn die aktuelle Seite den Fakt weiterhin stützt und der Faktzustand stark genug für den nächsten Schritt ist.

Fehler- und Guard-Bedingungen

Diese harten Kanten sollten Agenten und Integrationen aus dem OK-Beobachtungsvertrag erwarten.

Agentenbeispiel

Das Beispiel zeigt OK als Vertrag für aktuellen Zustand: Wahrnehmung fordert frischen Zustand an, der Agent meldet sichtbare Claims, und das Ergebnis sagt, welche Fakten als Orientierung nutzbar sind.

Beobachtungsrequest

{
  "tool": "nova.ok_observe",
  "arguments": {
    "targetId": "active",
    "perceptionId": "perceive_7f3a",
    "claims": [
      {
        "signalKey": "core.login_state",
        "value": "logged_in",
        "certainty": "likely",
        "evidence": "Visible user menu is present."
      },
      {
        "signalKey": "core.plan.tier",
        "value": "pro",
        "certainty": "tentative",
        "evidence": "A Pro label is visible near the account menu."
      }
    ]
  }
}

Relevante Antwortfelder

{
  "structuredContent": {
    "ok": true,
    "accepted": 2,
    "rejected": 0,
    "superseded": 0,
    "facts": [
      {
        "key": "core.login_state",
        "value": "logged_in",
        "state": "fresh",
        "isNew": true
      }
    ],
    "warnings": null
  }
}

Agenteninterpretation

{
  "treatAs": "current service-state evidence",
  "mayUse": "fresh facts can guide model, login, page-type, or feature-sensitive choices",
  "beforeAction": "confirm the visible page still supports the fact",
  "onStaleOrConflict": "perceive again and submit a fresh OK observation"
}

MCP-Vertrag

Das ist die nüchterne Schicht unter der Erklärung. Sie beschreibt OK-Felder, die Agenten und Integratoren als Vertragssignale lesen sollen, nicht als freien Beschreibungstext.

Ausführungsregel: Kein OK-Fakt darf zustandsabhängige Handlungen leiten, ohne dass die aktuelle Seite sichtbar bestätigt wurde.