MCP-Tool
nova.pks_upsert
Für Wissenssignale, Lernkandidaten und nachvollziehbare Orientierung nutzt ein Agent dieses öffentliche Werkzeug, um den Zustand oder die Evidenz zu "Phenomenon anlegen" zu prüfen. Der Eintrag zeigt, welches aktuelle Signal als Evidenz taugt und wann ein Folgeschritt eine frische Zielprüfung braucht.
Kanonische Referenz für einen öffentlichen MCP-Toolnamen.
- Typ
- MCP-Tool
- Familie
- PKS (Knowledge Store)
- Wirkung
- lesend
- Status
- Erklärt
- Pfad
- 10.1
Zweck
Was dieser Eintrag erklärt
Was macht das?
nova.pks_upsert
Ein Agent nutzt dieses Werkzeug, um den Zustand oder die Evidenz zu "Phenomenon anlegen" zu prüfen. Er betrifft Wissenssignale, Lernkandidaten und nachvollziehbare Orientierung; Agenten sollten es mit aktueller Discovery, Zielbewusstsein und sichtbarem Ergebnis zusammen lesen.
Einsetzen, wenn
- Nutze diesen Eintrag, wenn ein Agent für Wissenssignale, Lernkandidaten und nachvollziehbare Orientierung den Zustand oder die Evidenz zu "Phenomenon anlegen" prüfen soll.
- Nutze ihn, um den öffentlichen Toolnamen, seine Wirkungsgrenze und die zu prüfenden Antwortsignale zu verstehen.
- Nutze ihn vor verketteten Folgetools, damit der nächste Schritt auf aktueller Evidenz basiert.
Referenznutzung
Wie Agenten diesen Bereich zitieren und anwenden
Beispiele werden auf Familienebene gepflegt und nutzen nur öffentliche Toolnamen oder Referenzpfade, die bereits im Katalog stehen.
Familienbeispiel
Ein Agent soll in Wissenssignale, Lernkandidaten und nachvollziehbare Orientierung einen sichtbaren Zustand verändern, ohne Ziel und Ergebnis aus einer früheren Sitzung zu raten.
Der Agent beginnt bei nova.pks_upsert, liest die aktuelle Antwort oder Referenz und wählt erst danach das konkrete nächste Werkzeug.
Nur das bestätigte Ziel verändern, danach den sichtbaren Zustand prüfen und bei Abweichung stoppen.Kontrakt
Eingaben und wichtige Antwortfelder
Diese Seite ist eine öffentliche Referenz. Agenten und Integratoren sollen vor Ausführung trotzdem die aktuelle MCP-Tool-Discovery lesen, weil Schemas von Einstellung oder Version abhängen können.
Eingaben
scope
Öffentliches Eingabefeld aus der Katalogquelle. Das genaue Schema vor Ausführung über aktuelle MCP-Discovery bestätigen.
Antwortfelder
Aus der Katalogquelle ist für diesen Pfad kein festes öffentliches Antwortfeld ableitbar. Nutze aktuelle Tool-Discovery und die tatsächliche Antwort, bevor ein Folgeschritt ausgeführt wird.
Sicherheit
Grenze vor der Ausführung
Liest aktuellen Zustand oder Evidenz. Das Ergebnis ist keine Erlaubnis für Folgeaktionen ohne frische Prüfung.
Gespeichertes Wissen nur als Orientierung behandeln. Vor jeder Aktion aktuelle Seite, Ziel, Scope und sichtbare Evidenz erneut bestätigen.
Für Menschen erklärt dieser Eintrag, was ein Agent in Wissenssignale, Lernkandidaten und nachvollziehbare Orientierung liest und welches aktuelle Signal vor Vertrauen in das Ergebnis geprüft werden sollte.
High-Impact-Review
Ausführungsgrenze und Recheck-Hinweise
Review-Kategorie: Auto-Apply/mutierende Flows
Mutierende Schritte dürfen nur mit bestätigtem Ziel, erwarteter Wirkung, Nutzerkontrolle und Ergebnisprüfung laufen.
Falsche Annahme: Ein Guard oder Auto-Apply-Signal ersetzt die aktuelle Ziel- und Ergebniskontrolle.
Der Nutzer muss Aktion, Ziel, Freigabe, Blocksignal und sichtbares Ergebnis nachvollziehen können.
Nur den beabsichtigten Schritt ausführen, danach Zustand prüfen und bei Warnung, Block oder Zielwechsel stoppen.
Neu prüfen, wenn Kandidatenbudget, Gate, sichtbarer Zustand oder erwartete Wirkung nicht zusammenpassen.
Wirkungsachsen
Wie dieser Pfad wirken kann
Achsen sind stabile Katalogsignale für Menschen, Agenten und LLM-Discovery. Ein Pfad kann mehrere Achsen tragen.
read_current_state
Liest aktuellen Zustand, Antwortsignale oder Evidenz, ohne daraus allein eine Folgeaktion abzuleiten.
Das Signal als aktuelle Evidenz nutzen und vor jeder Folgeaktion Ziel, Scope und sichtbaren Zustand erneut prüfen.persistent_change
Speichert, löscht, merkt, plant oder verändert Daten, die über den unmittelbaren Seitenzustand hinaus bestehen können.
Nur mit klarem Scope ausführen und die gespeicherte, gelöschte oder geplante Wirkung nachvollziehbar halten.user_confirmation
Braucht sichtbare Bestätigung, Zielprüfung, Freigabe oder bewusste Nutzerkontrolle.
Nicht fortfahren, bis die geforderte Bestätigung im aktuellen Kontext sichtbar oder eindeutig erteilt ist.