Visual für PKS Langzeitgedächtnis PKS PKS ist das Langzeitgedächtnis von Nova. Es speichert kuratiertes Wissen über Websites: welche UI-Phänomene dort auftreten, wie Nova sie erkennt und welche Handlung zuverlässig hilft. Überblick Speichert Wissensmodell Agenten-Infos Wann es gilt Agent-Beispiel MCP-Vertrag Wann es hilft Agenten-Werkzeuge

PKS

PKS steht für Phenomenological Knowledge Store. Phänomenologisch heißt hier: Nova beginnt beim sichtbaren Website-Phänomen, das Agenten und Nutzer wiedererkennen können, und verbindet diese Situation mit geprüfter Orientierung.

PKS ist Novas kuratiertes Langzeitgedächtnis für Website-Verhalten. Es speichert wiederkehrende Situationen auf Webseiten, die Signale zu ihrer Erkennung und die Handlungen, die sich als hilfreich erwiesen haben.

PKS kann während der Arbeit automatisch wachsen. Nova kann wiederholte sichere Aktionen, wiederkehrende Blocker und klare semantische Muster erkennen und daraus Lernkandidaten vorbereiten, die trotzdem Evidenz, Prüfung oder Promotion brauchen, bevor sie aktive Orientierung werden.

Das ist nützlich, wenn Agenten einem Hindernis nicht nur einmal begegnen: einem Cookie-Banner, einer Login-Schranke, einem fragilen Navigationsmuster, einem Modal oder einer plattformspezifischen Seitenstruktur. Mit PKS muss Nova bekannte Muster nicht jedes Mal neu erraten.

PKS ersetzt keine Prüfung. Ein gespeicherter Hinweis ist nur dann hilfreich, wenn er zur aktuellen Seite passt und wenn die Sicherheitseinstellungen die Handlung erlauben.

Kurz gesagt

  • PKS speichert Website-Wissen, kein allgemeines Weltwissen.
  • Nova kann aus wiederholten sicheren Aktionen und klaren Website-Mustern automatisch PKS-Kandidaten vorbereiten.
  • Einträge verbinden Erkennungssignale mit Hinweisen, Playbooks, Prüfung und Health-Informationen.
  • Wissen wird erst aktiv, wenn genug Evidenz zeigt, dass es wirklich nützlich ist.
  • Nova kann PKS als Orientierung nutzen, aber veraltete oder riskante Einträge müssen geprüft werden.
  • PKS gehört zum Lernbereich von Nova, zusammen mit Beobachtungen, Promotion und ETM-Aufgabengedächtnis.

Was PKS speichert

  1. Website-Kontext PKS ordnet Wissen einer Website oder einem Arbeitsbereich zu. Dadurch bleibt ein Hinweis an die Fläche gebunden, auf der er gelernt wurde.
  2. Phänomene Ein Phänomen ist eine wiedererkennbare sichtbare Situation, zum Beispiel ein Consent-Banner, Modal, Login-Wall, Paywall, Layout-Shift oder nativer Browserdialog.
  3. Erkennungssignale Signale beschreiben, woran Nova die Situation wiedererkennen kann: sichtbarer Text, stabile Seitenstruktur, Anbieter-Hinweise, Layout-Verhalten oder Interaktionsevidenz.
  4. Automatische Kandidaten Wenn dieselbe sichere Interaktion oder dieselbe semantische Situation wiederholt auftritt, kann Nova einen PKS-Kandidaten vorbereiten, ohne dass ein Agent jeden Eintrag von Hand schreiben muss.
  5. Playbooks und Hinweise Ein Playbook beschreibt eine vorsichtige Handlung und eine Prüfung danach. Ein Hinweis kann auch passiv bleiben, wenn er nur beim Verstehen der Seite helfen soll.
  6. Health Health-Informationen zeigen, ob ein Muster zuletzt funktioniert hat, ob es wiederholt fehlschlug und ob es als veraltet behandelt werden sollte.

Wann brauche ich PKS?

PKS gehört zu wiederholter Website-Arbeit: beim Abbilden einer unbekannten Plattform, beim Vorbereiten zuverlässiger Automationen, beim Umgang mit wiederkehrenden Blockern oder wenn ein Agent verstehen soll, warum sich dieselbe Website immer ähnlich verhält. Besonders nützlich ist PKS auf Seiten, bei denen kleine UI-Änderungen fragile Selektoren brechen oder die richtige Handlung vom Kontext abhängt.

Wissensmodell für Agenten

Für einen Agenten beantwortet das PKS-Wissensmodell drei Fragen: Wo gilt diese Orientierung, woran beweist die aktuelle Seite, dass sie noch passt, und was muss der Agent nach Nutzung oder Ablehnung der Orientierung zurückmelden?

Scope und Route
Sagt dem Agenten, zu welchem Website-Bereich die Orientierung gehört. Ein routenspezifischer Hinweis darf nicht auf eine unpassende Seite übertragen werden, nur weil die Domain gleich ist.
Phänomen
Benennt die sichtbare Situation, mit der der Agent arbeitet, zum Beispiel Consent-Banner, Login-Wall, Modal, Paywall, Layout-Shift oder nativer Dialog.
Fingerprint
Nennt die Signale, die die aktuelle Seite weiterhin zeigen muss: Selektoren, Text, Layout, Anbieter-Hinweise oder Interaktionsevidenz.
Advice
Fasst zusammen, was der Agent als Nächstes prüfen oder erwägen sollte. Advice ist Orientierung, keine Erlaubnis; aktuelle Wahrnehmung und Sicherheitsgrenzen entscheiden weiter.
Playbook
Beschreibt Handlungsschritte und Erfolgsprüfung. Ein Playbook ist nur nutzbar, wenn der Agent bestätigt, dass dasselbe Phänomen jetzt wirklich vorhanden ist.
Lernstufe
Zeigt, ob Wissen noch Kandidat, Shadow-Eintrag oder aktive Orientierung ist. Nicht aktive Einträge sind Lernmaterial, keine normalen Laufzeit-Anweisungen.
Health und Reparatur
Zeigt, ob Orientierung funktioniert hat, fehlgeschlagen ist, veraltet wirkt oder Patch, Revalidierung, Telemetrie oder Abschaltung braucht.

So nutzen Agenten PKS-Infos

Für Agenten ist PKS nicht nur ein gespeicherter Eintrag. PKS ist eine strukturierte Informationsfläche in der Werkzeugantwort: angeforderter Detailgrad, tatsächlich gelieferter Detailgrad, bekannte Muster, Advice, Health-Warnungen, semantische Lernhinweise und Reparatursignale sagen dem Agenten, wie vorsichtig er weiterarbeiten soll.

  1. Passenden Detailgrad anfordern Ein Agent kann ohne PKS-Nutzlast, mit kompakter Zusammenfassung oder mit vollständigem Detail arbeiten. Die Antwort zeigt auch den effektiven Modus, damit der Agent erkennt, ob er frische Orientierung, nur eine kleine Unchanged-Markierung oder in diesem Schritt keine PKS-Daten erhalten hat.
  2. Seitenkontext lesen PKS-Informationen hängen an Scope, Route, Sprache, Auth-Zustand, Trust und Health. Der Agent prüft, ob die aktuelle Seite zu gespeicherter Orientierung passt, bevor er einen Selektor oder ein Playbook nutzt.
  3. Advice als Orientierung behandeln Hints, Advice-Items, Vorschläge und kompakte Urteile helfen bei der nächsten Entscheidung. Sie ersetzen keine aktuelle Wahrnehmung. Wenn sichtbare Seite und gespeichertes PKS widersprechen, zählt die aktuelle Seite.
  4. Höhere Priorität zuerst lösen Wenn Nova einen semantischen Lernhinweis ausgibt, kann dieser Hinweis niedrigere Advice-Felder in derselben Antwort überstimmen. Der Agent sollte diese Lernfrage lösen oder bewusst vertagen, bevor er mit normalen Selektorhinweisen weiterarbeitet.
  5. Vor der Handlung prüfen Ein passender PKS-Eintrag sagt, was wahrscheinlich funktioniert. Vor der Aktion bestätigt der Agent sichtbare Signale, beachtet Sicherheitsgrenzen und nutzt PKS nicht, um sensible Konto-, Zahlungs-, Zugangsdaten- oder Löschabläufe unsichtbar zu machen.
  6. Ergebnis melden Nach der Nutzung eines bekannten Phänomens meldet der Agent Erfolg, Fehlschlag oder Nicht-Anwendbarkeit. Erst diese Telemetrie macht aus einem hilfreichen Hinweis messbare Health statt Bauchgefühl.
  7. Reparatursignale beachten Health-Warnungen, fragile Selektoren, Drift-Hinweise und Lern-Reparaturqueues zeigen dem Agenten, wann gespeicherte Orientierung gepatcht, revalidiert oder abgeschaltet werden sollte, bevor dieselbe Aktion wiederholt wird.
  8. Beispiel Wenn ein Consent-Hinweis zur aktuellen Route erscheint, bestätigt der Agent zuerst, dass der Banner sichtbar ist, nutzt die sicherste passende Reaktion, prüft anschließend, dass der Banner verschwunden ist, und meldet das Ergebnis. Wenn der Banner anders aussieht, nimmt der Agent die Seite neu wahr und aktualisiert oder ignoriert die veraltete Orientierung.

Wann PKS-Wissen gilt

Das ist die operative Schicht in normaler Sprache. Ein PKS-Hinweis darf einen Agenten nur führen, wenn die aktuelle Seite weiterhin zum gespeicherten Phänomen passt und der Eintrag reif genug für Laufzeit-Nutzung ist.

Kandidat L0 Candidate
Bedeutung
Eine wiederholte sichere Interaktion oder semantische Website-Situation kann PKS-Wissen werden, ist aber noch Lernmaterial.
Nötige Evidenz
Frische Seitenbeobachtung, passender Scope oder passende Route, ein wiedererkennbares Phänomen und Confidence, die den Kandidaten stützt, aber Prüfung nicht ersetzt.
Agentenverhalten
Situation prüfen und den Kandidaten schreiben, vertagen oder verwerfen.
Darf ausführen
Nein.
Shadow L1 Shadow
Bedeutung
Ein Phänomen oder Domain-Hinweis ist gespeichert, aber noch keine normale Laufzeit-Orientierung.
Nötige Evidenz
Stabiler Scope, Erkennungssignale, Playbook oder Hinweis und genug Folgetelemetrie, um Promotion sinnvoll bewerten zu können.
Agentenverhalten
Nicht als aktive Anweisung nutzen. Outcomes sammeln und die aktuelle Seite als Wahrheit behandeln.
Darf ausführen
Nein.
Active L2 Active
Bedeutung
Der Eintrag ist reif genug für normales Matching und darf den Agenten führen, wenn die aktuelle Seite weiterhin passt.
Nötige Evidenz
Aktive Lernstufe, passender Fingerprint der aktuellen Seite, keine blockierende Health-Warnung und keine Sicherheitsgrenze, die Nutzerkontrolle verlangt.
Agentenverhalten
Als Orientierung nutzen, sichtbare Seitensignale vor der Handlung bestätigen und danach Erfolg, Fehlschlag oder Nicht-Anwendbarkeit melden.
Darf ausführen
Ja, nach sichtbarer Bestätigung.
Degraded
Bedeutung
Gespeicherte Orientierung ist verdächtig, weil die Seite gedriftet ist, Health-Warnungen erscheinen oder jüngere Outcomes Vertrauen senken.
Nötige Evidenz
Wiederholte Fehlschläge, niedriger beobachteter Erfolg, veraltetes Wissen, fragile Selektoren oder Widerspruch zwischen gespeichertem Fingerprint und aktueller Seite.
Agentenverhalten
Aktuelle Wahrnehmung gewinnt. Neu wahrnehmen, patchen, revalidieren, zurückstufen oder den Eintrag nicht mehr nutzen.
Darf ausführen
Nein, bis revalidiert.
Nicht anwendbar
Bedeutung
Für die aktuelle Seite und Aufgabe wird keine passende PKS-Nutzlast angefordert, geliefert oder gebraucht.
Nötige Evidenz
PKS ist ausgeschaltet, kein Phänomen passt, die Route ist anders oder die Nutzeraufgabe liegt außerhalb des gespeicherten Scopes.
Agentenverhalten
Aus frischer Beobachtung weiterarbeiten. Keinen PKS-Erfolg melden, wenn PKS nicht wirklich genutzt wurde.
Darf ausführen
Nein.
Reparatur offen
Bedeutung
Ein Follow-up ist offen, weil die Orientierung Reparatur, Telemetrie, Revalidierung oder Agentenbehandlung braucht.
Nötige Evidenz
Offener Reparaturhinweis, Telemetrielücke, veralteter Selektor oder patchbares Playbook-Problem.
Agentenverhalten
Queue-Eintrag lösen, bevor Aktionen wiederholt werden, die von der veralteten Orientierung abhängen.
Darf ausführen
Nicht für abhängige Aktionen.

Warn- und Failure-Bedingungen

Das sind harte Warnbedingungen, bei denen Nova PKS-Orientierung nicht mehr routiniert behandeln sollte. Andere Promotion-Entscheidungen sind Evidenz-Gates; sie sollten nicht als Zahlenwert dokumentiert werden, solange das System keinen echten Schwellenwert vorgibt.

Signal Schwelle Verhalten
pksHealthWarnings 3 oder mehr aufeinanderfolgende Fehlschläge Hohe Schwere. Selektoren oder Playbooks als möglicherweise veraltet behandeln.
pksHealthWarnings 5 oder mehr Versuche und Erfolgsrate unter 0.5 Hohe Schwere. Aktuelle UI erneut prüfen, bevor gespeicherte Orientierung genutzt wird.
pksHealthWarnings Staleness-Score ab 0.7 Mittlere Schwere. Vor aktiver Nutzung revalidieren.
selectorWarning Gehashte oder redeploy-empfindliche CSS-Klassen in gespeicherten Selektoren Stabile IDs, ARIA-Labels oder frische Seitenevidenz bevorzugen.
pksNavigationWarning Bekanntes SPA-, Session- oder fragiles Auth-Navigationsrisiko Same-Document-Routing bevorzugen oder harte Navigation bewusst bestätigen.

Agenteninterpretation

Das Beispiel zeigt, wie ein Agent PKS als strukturierte Orientierung liest, nicht als blinden Handlungsbefehl.

Request

{
  "tool": "nova.perceive",
  "arguments": {
    "targetId": "active",
    "mode": "summary",
    "pksInclude": "summary"
  }
}

Relevante Antwortfelder

{
  "structuredContent": {
    "pksIncludeRequested": "summary",
    "pksInclude": "summary",
    "pks": {
      "payload": {
        "scope": "example.com",
        "routeSegment": "_root",
        "hints": [
          {
            "id": "consent_dismiss",
            "type": "consent_cmp",
            "policy": "reject_preferred",
            "verified": true,
            "hasWarning": false
          }
        ],
        "advice": ["All 1 phenomena healthy."]
      }
    }
  }
}

Agenten-Deutung

{
  "treatAs": "candidate guidance",
  "beforeAction": "sichtbare Consent-Signale erneut bestätigen",
  "afterAction": "nova.telemetry_report mit scope, phenomenonId und outcome='success' nur melden, wenn der Banner verschwunden ist",
  "onMismatch": "aktueller Wahrnehmung vertrauen, nicht dem gespeicherten Hinweis"
}

MCP-Vertrag

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

Ausführungsregel: Kein PKS-Feld darf eine Handlung auslösen, ohne dass die aktuelle Seite sichtbar bestätigt wurde.

Variable Typ / Werte Standard Wirkung
pksInclude string: auto | off | summary | full auto Request-Feld für Wahrnehmungs- und Navigationswerkzeuge. Es steuert, ob PKS in der Antwort gar nicht, kompakt oder vollständig erscheint.
pksIncludeRequested string Antwort-Echo Zeigt, was der Agent angefordert hat, damit ein Client angeforderten und tatsächlich gelieferten Detailgrad vergleichen kann.
pksMode string: off | match | telemetry match Gilt für Sequenzen und selektorbasierte Ausführungswerkzeuge. Off unterdrückt PKS-Hinweise, Match liefert kompakte Hinweise, Telemetry fordert vollständige PKS-Nutzlast und Advice an.
pksAdviceMode string: off | match | telemetry match, oder pksMode wenn nur pksMode gesetzt ist Steuert den Detailgrad von PKS-Advice. Match hält Hinweise kompakt; Telemetry behält die vollständige Advice-Fläche.
outputDetail string: summary | full full Gilt für direkte PKS-Leseaufrufe. Summary dient Existenz- und Health-Checks; Full enthält Fingerprints und Playbooks.
topK integer: 1-10 1 Steuert, wie viele gerankte Kandidaten nova.pks_match für eine Beobachtung zurückgibt. In nova.perceive ist topK eine separate CTA-Ranking-Option mit größerem Wertebereich.
confidence number: 0.0-1.0 berechnet Erscheint bei PKS-Matching und semantischen Lernhinweisen. Der Wert wird beim Matching mit minConfidence verglichen, ersetzt aber keine Seitenprüfung.
minConfidence number: 0.0-1.0 phänomenspezifisch Fingerprint-Schwelle für das Matching eines Phänomens. Kandidaten darunter können als Near Miss erscheinen, matched bleibt aber false.
learningLevel integer/state: 0 L0 Candidate, 1 L1 Shadow, 2 L2 Active manuelle PKS-Writes starten als Shadow Nur Active-Wissen erscheint im normalen Matching. Candidate und Shadow bleiben Lernmaterial, bis Promotion-Prüfungen bestanden sind.
verified boolean false bis totalAttempts > 0 Trennt nie getestete Playbooks von Playbooks mit aufgezeichneten Telemetrieversuchen.
totalAttempts integer oder null null/0 ohne Versuche Zählt aufgezeichnete Telemetrieversuche für ein Phänomen und entscheidet, ob Success-Rate-Felder aussagekräftig sind.
successRate number: 0.0-1.0 oder null null ohne Versuche Health-Signal in vollständigen PKS-Hints. Niedriger Erfolg sollte zu neuer Wahrnehmung, Patch, Revalidierung oder Abschaltung führen.
successRate30d number: 0.0-1.0 oder null null ohne Versuche Health-Signal in Summary-Reads für das jüngere Erfolgsfenster. Wird zusammen mit totalAttempts für Low-Success-Warnungen genutzt.
hasWarning boolean false Kompakter Summary-Hinweis, dass ein Phänomen wegen Fehlschlägen, niedrigem Erfolg oder Staleness verdächtig ist. Full Detail zeigt den Grund.
pksHealthWarnings object oder null null wenn gesund Warnt vor fehlschlagendem, veraltetem oder schwachem PKS-Wissen. Diese Warnungen bleiben sichtbar, weil veraltete Orientierung Agenten in die Irre führen kann.
pksSemanticLearning object: gateId, status, opportunityId, kind, origin, fingerprint, confidence, reason, whyAutoUpsertIsInsufficient, resolutionTools, evidenceJson, skeleton nur wenn Nova einen semantischen Lernprompt ausgibt Höher priorisierter Lernprompt für reichere Phänomene wie Consent-Dialoge, Login-Walls oder riskante Wiederholungen. Der Agent löst ihn durch PKS-Write oder Resolver-Tool.
pksSemanticLearningBatchSummary object: status=batch_summary, origin, reason, entries[] nur wenn offene Prompts beim Domain-Wechsel zusammengefasst werden Fasst ungelöste semantische Lernchancen zusammen, damit der Agent den Lernkontext nach Verlassen einer Domain nicht verliert.
pksSemanticLearningResolution object: status, opportunityId, verdict, reason, matchSource nur nach Auto-Auflösung durch nova.pks_upsert Zeigt, dass ein semantischer Lernprompt durch einen passenden PKS-Upsert aufgelöst wurde. Explizites Resolver-Feedback nutzt stattdessen die Antwortform von nova.learn_resolve_opportunity.
learningRepairQueue object: status, autoCompletedCount, queuedCount, failedCount, items[], message nur wenn PKS-Lern-Follow-ups existieren Berichtet sichere automatische Reparaturen, offene Reparaturarbeit oder fehlgeschlagene Follow-ups, die vor Wiederholung veralteter Orientierung behandelt werden sollten.
nova.learn_resolve_opportunity MCP-Tool; Args: opportunityId, verdict, reason opportunityId und verdict erforderlich Lässt einen Agenten einen semantischen PKS-Prompt als upsert, not_applicable, unsafe, already_known oder defer auflösen.
nova.learn_resolve_opportunity response ok, opportunityId, verdict, reason, priorState, resolvedState, resolvedAtUtc, fr1CandidatesSuperseded Antwort auf explizite Resolver-Aufrufe Berichtet explizites semantisches Prompt-Feedback getrennt vom Auto-Resolution-Feld auf PKS-Upsert-Ergebnissen.
Agenten-Werkzeuge

MCP-Tools für Agenten. Diese Variablen und Werkzeugnamen sind für Agenten und Integratoren gedacht. Sie sind keine normalen Bedienbefehle für Menschen in der Oberfläche.

Variable Bedeutung
nova.pks_get Gespeicherte Hinweise lesen
nova.pks_match Bekannte Muster finden
nova.phenomenon_apply Bekanntes Phänomen bewusst anwenden
nova.pks_upsert PKS-Eintrag speichern
nova.learn_resolve_opportunity Semantische Lernchance einordnen
nova.pks_upsert_hint Domain-Hinweis speichern
nova.pks_patch PKS-Eintrag anpassen
nova.pks_deprecate PKS-Eintrag abschalten
nova.pks_list PKS-Domains auflisten
nova.pks_platform_seed Plattform-Template speichern
nova.pks_platform_get Plattform-Template lesen
nova.pks_platform_list Plattformen auflisten
nova.telemetry_report Erfolg oder Fehler melden