MCP-Tool
nova.reference_doc_read
Für Sonderfälle, Produktgrenzen und robuste Fehlerpfade nutzt ein Agent dieses öffentliche Werkzeug, um den Zustand oder die Evidenz zu "Reference Doc Read Paging & NotFound" 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
- Onboarding & Self-Service
- Wirkung
- lesend
- Status
- Erklärt
- Pfad
- 27.7
Zweck
Was dieser Eintrag erklärt
Was macht das?
nova.reference_doc_read
Ein Agent nutzt dieses Werkzeug, um den Zustand oder die Evidenz zu "Reference Doc Read Paging & NotFound" zu prüfen. Er betrifft Sonderfälle, Produktgrenzen und robuste Fehlerpfade; Agenten sollten es mit aktueller Discovery, Zielbewusstsein und sichtbarem Ergebnis zusammen lesen.
Einsetzen, wenn
- Nutze diesen Eintrag, wenn ein Agent für Sonderfälle, Produktgrenzen und robuste Fehlerpfade den Zustand oder die Evidenz zu "Reference Doc Read Paging & NotFound" 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 Sonderfälle, Produktgrenzen und robuste Fehlerpfade einen sichtbaren Zustand verändern, ohne Ziel und Ergebnis aus einer früheren Sitzung zu raten.
Der Agent beginnt bei nova.get_onboarding, 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
docId
Referenzschlüssel für aktuelles Ziel, Objekt oder Sitzung. Aus der aktuellen Antwort lesen, nicht raten.
cursor
Paging- oder Größenfeld für lange Ergebnislisten. Es hält Antworten prüfbar.
maxChars
Paging- oder Größenfeld für lange Ergebnislisten. Es hält Antworten prüfbar.
| Antwortfeld | Erklärung |
|---|---|
docId | Kennung oder Referenzwert. Nicht aus Erinnerung raten, sondern aus der aktuellen Antwort lesen. |
hasMore | Paging- oder Größensignal für lange Ergebnislisten. Es zeigt, ob weitere Daten einen Folgeschritt brauchen. |
nextCursor | Paging- oder Größensignal für lange Ergebnislisten. Es zeigt, ob weitere Daten einen Folgeschritt brauchen. |
reasonCode | Maschinenlesbarer Grund für Warnung, Block oder spezielles Verhalten. |
Sicherheit
Grenze vor der Ausführung
Liest aktuellen Zustand oder Evidenz. Das Ergebnis ist keine Erlaubnis für Folgeaktionen ohne frische Prüfung.
Die Antwort als aktuelle Evidenz verwenden und erst danach ein spezifischeres Folgetool wählen, wenn Ziel, Scope und Frische klar sind.
Für Menschen erklärt dieser Eintrag, was ein Agent in Sonderfälle, Produktgrenzen und robuste Fehlerpfade liest und welches aktuelle Signal vor Vertrauen in das Ergebnis geprüft werden sollte.
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.