MCP-Beobachtbarkeit: Aufbau eines fünf-Schicht-Gesundheitsvertrags

MCP Beobachtbarkeit sollte eine schwierige Frage beantworten als hat die Anfrage zurückgegeben? Für jede Modellkontextprotokoll Sitzung, eine korrelierte Beweiskette von Autorisierung und Initialisierung durch Tool Entdeckung, Invokation, externen Effekt und den Benutzer s erwartete Ergebnis zu bewahren. Eine grüne tools/call Reaktion ist nur ein Glied in dieser Kette. Der angemessene Verzug ist ein fünf Schicht Gesundheitsvertrag: 1. Session: Haben der Client und der Server eine unterstützte Protokollversion ausgehandelt und welche Funktionen dieser Ausführung nutzen wird? 2. Catalog: hat der Client die vollständige aktuelle Toolliste gelesen und auf ein späteres Listenwechselsignal reagiert? 3. Request: Können Sie sich der JSON RPC Anfrage, Fortschrittsbenachrichtigungen, Stornierung, Antwort und Frist anschließen? 4. Effekt: Wenn das Werkzeug ein externes System ändert, gibt es Bestimmungsnachweise für das, was tatsächlich passiert ist? 5. OUUTcome: hat das Artefakt, die Änderung des Zustands oder die Entscheidung, die der Agent produzieren sollte, seinen Verifikator bestanden? Dieser Vertrag trennt absichtlich die Protokollaktivität von nützlichen Fortschritten. Es gibt dem Betreiber auch einen Betonzustand für die Routing: needs auth , incompatible session , stale catalog , working , protocol error , tool failed , effect unknown , false success oder healthy . Beginnen Sie mit einer Beweiskette, nicht mit einer Dashboard Nummer. Die neuen US Ergebnisse für mcp Observability betonen Sitzungen, Verbindungen, Tool Analysen, Transport Latenz, Durchsatz und Fehler. Das ist nützlich. Die aktuelle MCP Beobachtungsdokumentation von Grafana enthält eine Liste der Sitzungseinrichtung, der Verbindungsstabilität, der Protokollkonformität, der Werkzeugleistung und der Transportverlässlichkeit. Die Lücke besteht nicht darin, dass diese Signale falsch sind. Die Lücke besteht darin, daß keiner von ihnen allein beweist, daß die beabsichtigte Arbeit des Agenten sein Ziel erreicht hat. Eine Krankenakte kann kompakt bleiben: Die Hashes sind Identifikatoren, nicht die Erlaubnis zum Hochladen von Werkzeugschemas, Argumenten, Anfragen, Token oder zurückgegebenen Inhalten. Bewahren Sie empfindliche Werte beim Gastgeber. Aufzeichnen Sie die kleinsten Felder, die erforderlich sind, um den Zustand zu korrelieren und die Entscheidung zu beweisen. Der Vertrag sollte auch eine Vorrangsregel haben. Ein Autorisierungsfehler kommt vor der Sitzungsgesundheit; eine inkompatible Sitzung kommt vor der Katalogfrischheit; ein ungelöster Katalog kommt vor der Anforderungsinterpretation; ein Transportzeitpunkt an einer Nebenwirkungsgrenze wird zu effect unknown , nicht zu einem automatischen erneuten Versuch; und ein erfolgreicher Anruf mit einem fehlenden Lieferwert wird zu false success , nicht gesund. Erstellen Sie den Protokollzustand beobachtbar, bevor Sie die Latenz des Tools messen Der MCP Spezifikation des Lebenszyklus macht die Initialisierung zur ersten Client Server Interaktion. Die beiden Seiten vereinbaren eine Protokollversion, tauschen Kapazitäten aus und beginnen dann den normalen Betrieb. Das gleiche Dokument besagt, daß die nachfolgende Mitteilung die verhandelte Version und die Fähigkeiten respektieren muss. Das gibt die Beobachtbarkeit einen sauberen ersten Checkpoint: Speichern Sie die angeforderte Version, akzeptierte Version, Kapazitätssatz und den Moment, in dem der Client notifications/initialized gesendet hat. Versagen Sie nicht alle Fehler vor diesem Punkt in server down. Für HTTP Transporte ist die Berechtigung ein separates Tor. Die aktuelle Spezifikation der Zulassung von MCPs definiert die Entdeckung geschützter Ressourcen und verlangt von den Kunden, eine 401 Unauthorized Herausforderung zu bewältigen. Ein Server kann erreichbar und korrekt sein, während dem Client ein Token fehlt, der falsche Umfang hat oder der Autorisierungsserver nicht entdeckt werden kann. Schreiben Sie das als needs auth ; schreiben Sie es nicht als Transportunterbrechung. Die Entdeckung von Werkzeugen benötigt einen eigenen Nachweis der Vollständigkeit. Der Spezifikation der Werkzeuge sagt, dass tools/list auf Paginierung angewiesen ist und dass Server, die listChanged erklären, notifications/tools/list changed ausstrahlen können. Daher ist we received one page kein neuer Katalog. Aufzeichnung: die Initialisierungskapazität, die die Werbewerkzeuge anzeigt; jeder Paginierungskursor, bis kein nextCursor übrig ist; ein kanonischer Hash von Namen und Eingabe/Ausgabe Schemata; die letzte erfolgreiche Erfrischungszeit; jede tools/list changed Meldung und die daraus folgenden Aktualisierungen. Das ist schmaler als jedes Schema zu protokollieren. Ein Client kann den Hash lokal berechnen und nur den Hash, die Werkzeugzahl, die Seitenzahl und die Nachweise aktualisieren. Wird eine Änderung benachrichtigt und die Aktualisierung fehlschlägt, dann klassifizieren Sie die Sitzung stale catalog . Der Server kann immer noch Pings beantworten, aber das Modell könnte sich aus einem veralteten Werkzeugvertrag entscheiden. Lang anhaltende Anrufe stellen eine weitere Falle ein. MCP Fortschrittsmeldungen verwendet ein auf Anfrage bereitgestelltes Token, das unter den aktiven Anfragen einzigartig sein muss; die Fortschrittswerte müssen steigen und die Benachrichtigungen nach Abschluss gestoppt werden. Diese Beweise können working rechtfertigen, solange der Anruf innerhalb seiner maximalen Frist liegt. Es beweist nicht, daß die Arbeit nützlich ist, und es darf die Frist nie für immer verlängern. Eine wiederholte Nachricht ohne Zunahmewert, ein Token, der einer falschen Anfrage beigefügt ist, oder Fortschritte nach einer Endreaktion sind inkonsistente Beweise. Verwenden Sie zwei Uhren: ein Inaktivitätsfenster, das auf gültige monotone Fortschritte zurückgesetzt werden kann; eine absolute Höchstfrist, die nicht zurückgesetzt wird. Diese Unterscheidung verhindert zwei entgegengesetzte Fehler: das Töten einer legitimen langen Arbeit, weil sie noch nicht zurückgekehrt ist, und die Annahme eines endlosen Stroms von Fortschrittsmeldungen als Gesundheit. Ein erfolgreicher Tool Call ist nicht das Ergebnis MCP unterscheidet Protokollfehler von Fehlern bei der Ausführung von Werkzeugen. Nach den Werkzeugspezifikationen verwenden fehlerhafte Anfragen und unbekannte Werkzeuge JSON RPC Fehler, während Geschäfts oder Eingabefehle mit isError: true ein Werkzeugergebnis zurückgeben können. Halten Sie diese Zustände getrennt, weil sich die nächste Aktion unterscheidet: Befestigen Sie den Clientvertrag für protocol error ; Anpassen Sie Eingaben, Berechtigungen oder die Abhängigkeit nach unten für tool failed . Der gefährlichere Fall ist keine Reaktion, nachdem eine Nebenwirkung aufgetreten sein könnte. Nehmen wir an, publish report Zeiten sind aus. Wenn man es sofort erneut versucht, kann man einen doppelten Bericht erstellen, da die Verkehrsunsicherheit nichts über das Ziel sagt. Markieren Sie den Anruf effect unknown , vereinbaren Sie mit Hilfe einer stabilen Betriebsschlüssel oder Bestimmungsfrage und versuchen Sie erst erneut, wenn die Beweise nachweisen, dass der erste Versuch nicht begangen wurde. Selbst ein normales Ergebnis reicht nicht aus. Der Server kann isError: false zurückgeben, während die versprochene Datei nicht vorhanden ist, der Remote Aufzeichnung ist immer noch ein Entwurf oder die URL privat ist. Fügen Sie einen vor dem Anruf gewählten Ergebnisverifikator hinzu: Dateihash, Datenbankreihe plus Version, öffentlicher HTTP Status, Testergebnis oder anderer deterministischer Empfang. Verwenden Sie einen LLM Rechter nur, wenn das Ergebnis nicht direkt überprüft werden kann, und markieren Sie schwache Beweise. Dadurch entstehen drei endgültig aussehende Zustände: Protokollergebnis Bestimmungswirkung Erwartetes Ergebnis Gesundheitszustand Auszeit Unbekannt Unbekannt effect unknown Erfolg geprüft fehlgeschlagen oder fehlgeschlagen false success Erfolg geprüft geprüft healthy Die mittlere Reihe zählt am wichtigsten. Es verhindert, dass ein erfolgreicher Protokollwechsel zu einer falschen Behauptung wird, dass der Agent die Aufgabe des Benutzers erfüllt hat. Wiederholen Sie den Vertrag gegen unangenehme Fälle Das begleitende Artefakt ist eine illustrative Feste aus neun Fällen und ein deterministischer Klassifikator. Es enthält keine Telemetrie der Produktion. Führen Sie es mit: Die Feststellung umfasst einen gesunden Export und acht unangenehme Grenzen: eine Genehmigungs Herausforderung, nicht unterstützte Protokollversion, nicht vereinbarte Änderung der Toolliste, einen langfristigen Anruf mit gültigem Fortschritt, einen fehlerhaften Anruf, einen Fehler bei der Ausführung des Tools, eine Auszeit nach einer möglichen Nebenwirkung und einen Erfolg bei einem fehlenden Lieferwert. Der Klassifizierer hat in jedem erwarteten Zustand einen Fall zurückgegeben: Das ist der verfälschbare Teil der Methode: Ändern Sie die Beweise und der Zustand muss sich vorhersehbar ändern. Wenn tools/list changed durch eine vollständige Erneuerung gefolgt ist, sollte der Fall des veralteten Katalogs vorangehen. Wird der ausgelaufene Anruf eine Zielergebühr erhalten, aber der zu lieferende Verifikator fehlschlägt, sollte er von effect unknown auf false success wechseln. Es erreicht healthy nur, wenn die Sitzung, Katalog, Anfrage, Wirkung und Ergebnisbeweise alle zustimmen. Das Artefakt bestätigt nicht, ob die Geschäftssemantik eines Werkzeugs korrekt ist. Es entdeckt keine undokumentierten Nebenwirkungen, beweist nicht, dass ein OAuth Emittent vertrauenswürdig ist oder entscheidet nicht, wie lange Ihre Frist sein sollte. Das sind Einsatz spezifische Überprüfungen. Seine Aufgabe ist kleinere: Verhindern, daß fehlende Beweise schweigend grün gemacht werden. Warnung über den Zustand, der Maßnahmen benötigt Schicken Sie nicht jeden ungesunden Zustand auf den gleichen Kanal. needs auth geht dem Besitzer der Anmeldeinformationen oder der Genehmigung mit der angefochtenen Ressource und dem erforderlichen Umfang, niemals dem Tokenwert. incompatible session wird dem Integrationsbesitzer mit Clientversion, Serverversion und verhandelten Funktionen übertragen. stale catalog löst einen begrenzten Wiederentdeckungsversuch aus; wiederholtes Versagen wird zu einem Integrationsvorfall. working bleibt ruhig, solange der Fortschritt gültig ist und die absolute Frist bleibt. protocol error geht zum Client Implementator mit der Methode, Anforderungserkennung und der desinfizierten Fehlerklasse. tool failed folgt der Richtlinien des Toolss nur, wenn der Ausfall bekannt ist, dass er reversibel ist. effect unknown blockiert den automatischen erneuten Versuch an der Nebenwirkungsgrenze und startet die Versöhnung. false success eröffnet einen Ergebnisvorfall, obwohl MCP selbst abgeschlossen ist. Dieser Routing hält waiting von stuck abgesehen. Ein einer Person zugewiesener Berechtigungspost kann eine legitime Wartezeit sein; ein Fortschritts Token, der innerhalb einer begrenzten Anfrage voranschreitet, kann funktionieren; ein unveränderter Katalog nach einem Listenwechselsignal ist kein. Beginnen Sie mit einem einzigen hochwertigen Tool und einem echten Ergebnisverifikator. Fangen Sie die Kette für eine Woche ein, überprüfen Sie jeden unbekannten Zustand und fügen Sie dann die Abdeckung hinzu. Ein perfektes, flottenweites Dashboard, das auf nicht korrelierten Ereignissen basiert, ist weniger nützlich als ein Tool Aufruf, dessen Sitzung, Effekt und Ergebnis von Ende zu Ende erklärt werden können. Wenn dieser Vertrag endet Die MCP Beobachtbarkeit kann Protokoll und Betriebsbeweise festlegen, kann aber nicht alle Nutzerabsichten aus dem Draht abschließen. Ein gültiges Ausgangsschema beweist Form, nicht Wahrheit. Eine Zielseite beweist eine Wirkung, nicht, dass die Wirkung klug war. Ein monotonisches Fortschrittssignal beweist die vom Server gemeldete Bewegung, nicht einen nützlichen Fortschritt in Richtung des Ziels des Benutzers. Diese Grenzen erfordern Anwendungskontrollen und manchmal menschliches Urteilsvermögen. Sidewisp befindet sich derzeit in einer privaten Vorschauphase. Die Produktionsüberwachungsadapter und die Wiederherstellungssysteme werden im Allgemeinen nicht versandt. Der Vertrag in diesem Artikel ist eine Betriebsmethode und ein überprüfbares lokales Artefakt, nicht eine Behauptung, dass Sidewisp bereits MCP Sitzungen sammelt oder repariert. Die beabsichtigte Produktrichtung besteht darin, die Gesundheitsnachweise, die Unsicherheit und die Genehmigungsgrenzen neben den vorhandenen Laufzeiten leichter zu erkennen. Wenn Sie jetzt eine MCP Integration entwerfen, halten Sie die fünf Schicht Aufzeichnung lokal, redigieren Sie den Inhalt und weigern sich, einen Lauf gesund zu nennen, bis das erwartete Ergebnis seine eigene Anmeldung hat. Diese einzige Regel verwandelt die Telemetrie des Protokolls in eine operative Entscheidung anstelle eines anderen grünen Diagramms.