AI-Agent Beobachtbarkeit für Nachversuche: Erfassen Sie doppelte Wirkungen

Ein Agenten sollte einen Tool Anruf nicht erneut versuchen, nur weil seine Spur in einer Auszeit endet. Die Anfrage kann den Anbieter erreicht haben, den tatsächlichen Zustand geändert haben und nur die Antwort verloren haben. Ein zweiter Versuch kann dann die Nachricht zweimal senden, zwei Tickets erstellen oder zwei Ressourcen bereitstellen, während beide Spuren individuell vernünftig aussehen. Die nützliche Gesundheitsregel ist strenger: Die logische Bedienung von one darf nicht mehr als eine nachgewiesene Wirkung erzeugen. Geben Sie der Operation eine stabile Identität, behalten Sie diese Identität über Versuche hinweg, registrieren Sie die Einnahmen von Anbieterseiteffekten und blockieren Sie den automatischen erneuten Versuch, wenn der Effekt nicht sicher nachgesehen werden kann. Versuche zählen und HTTP Status helfen immer noch bei der Diagnose, aber keines beweist das Ergebnis. Dieser Artikel baut diese Regel in ein kleines Effektbuch auf und testet sie gegen vier Operationen. Das Gerät enthält acht Versuche und vier Anbieterbeobachtungen. Ein Versuchs Nur Politik würde Zeiträume sehen und drei Operationen erneut ausprobieren. Die wirkungsbewusste Prüfung findet stattdessen eine gesunde Wiederholung, einen Duplikateffekt Incident, einen Konflikt und einen ehrlich unsicheren Betrieb. Eine Auszeit ist kein Beweis dafür , dass nichts passiert ist . Das gefährliche Fenster liegt zwischen der Remote Exekution und der lokalen Anerkennung. Ein Anbieter kann einen Effekt verursachen und dann auf dem Rückweg die Reaktion verlieren. Von der Seite des Agenten aus sind diese beiden Geschichten beobachtlich ähnlich: 1. die Anfrage hat den Anbieter nie erreicht; 2. die Anfrage ausgefüllt wurde, die Antwort jedoch nicht an den Agenten gelangte. Nur die erste Geschichte kann ohne weitere Sicherung wiederholt werden. Die zweite erzeugt ein Duplikat, wenn die Operation nicht natürlich idempotent ist. HTTP Semantik bietet eine nützliche Grenze. RFC 9110 definiert eine idempotente Methode als eine, deren beabsichtigte Serverwirkung nach mehreren identischen Anfragen gleich ist wie nach einer Anfrage. Es erlaubt automatische Wiederholung nach einem Kommunikationsfehler für idempotente Methoden, sagt aber, dass ein Client eine nicht idempotente Anfrage nicht automatisch erneut ausprobieren sollte, es sei denn, er weiß, dass die Operation effektiv idempotent ist oder feststellen kann, dass das Original nie angewendet wurde. Diese Unterscheidung gehört in die Gesundheit von Agenten. Ein PUT , das eine bekannte Aufzeichnung ersetzt, und ein POST , das eine E Mail sendet, können beide Zeit ausgehen, aber sie haben nicht die gleiche Wiederversuchsgrenze. Eine allgemeine timeout → retry Politik löscht die semantische Tatsache, die am wichtigsten ist. Der Anbieter hilft, aber der Vertrag muss genau gelesen werden. Strip Dokumente speichert den Statuscode und die Stelle für die erste Anfrage mit einem Idempotency Schlüssel und gibt das Ergebnis dann an spätere Anfragen mit demselben Schlüssel zurück. Es vergleicht auch Parameter und lehnt die Wiederverwendung mit verschiedenen Parametern ab. Der Schlüssel ist daher kein zufälliges Etikett, das jedem Versuch angeschlossen wird. Es stellt eine stabile logische Operation dar. Amazon EC2 Dokumente ein ähnliches Client Token Muster: Ein erfolgreicher erneuter Versuch mit demselben Token und Parametern führt keine weiteren Aktionen durch, während veränderte Parameter IdempotentParameterMismatch erzeugen können. EC2 umfasst auch einige Garantien regional oder regional. Hat ein Token ist nicht genug; die Gesundheitsakte benötigt den Umfang des Tokens, die Nutzlastidentität, das Retention Fenster und das Verhalten des Anbieters. Der angemessene Standard ist: Wiederverwendung einer Operationidentität bei allen Versuchen; die Wiederverwendung des Idempotency Schlüssels des Anbieters nur für die gleiche kanonische Nutzlast; nach einem zweideutigen Ergebnis die Anfrage durch diese Identität vor dem erneuten Versuch; wenn der Anbieter weder Abhängigkeit noch Nachfrage anbietet, eine menschliche Entscheidung für Folgewirkungen erfordern. Der Rückschlag reduziert den Druck auf einen fehlerhaften Service. Es verwandelt keine nicht idempotente Aktion in eine idempotente. Aufzeichnungswirkung, nicht nur Versuche Eine gewöhnliche Spur antwortet Was hat der Agent versucht? Ein Effektbuch beantwortet die andere Frage Welche dauerhafte Veränderung können wir beweisen? Halten Sie die beiden Aufzeichnungen miteinander verbunden, weil Versuche nützliche Beweise bleiben, aber behandeln Sie die Endzeit eines Versuchs nicht als Geschäftsergebnis. Ein Mindestbuch benötigt diese Felder: Feld Zweck Gesundheitsversagen, die sie aufdeckt operationId Stabile Identität für den beabsichtigten Betrieb des Nutzers Bei jedem erneuten Versuch wird eine neue ID erstellt . attemptId Identität für einen Transportversuch Fehlende oder überlappende Versuche idempotencyKey Identifikation des Anbieters durch Deduplikation, wenn unterstützt Schlüsseländerungen bei erneuten Versuchen payloadHash Hash einer kanonischen, redigierten Nutzlast Der gleiche Schlüssel wird für verschiedene Zwecke wiederverwendet effectRef Identität des Anbieters oder der Bestimmungsort der tatsächlichen Wirkung Mehr als eine dauerhafte Wirkung result Beobachtung des Verkehrs wie timeout oder success Zweideutige Anerkennung observedAt Zeit, in der die Beweise gesammelt wurden Verwechselbar mit dem aktuellen Zustand veraltete alte Beweise Stellen Sie in diese Felder keine Geheimnisse, E Mail Adressen, vollständige Anfragen oder Rohwerkzeuge auf. Hash eine kanonische Darstellung nach Entfernung von flüchtigen Werten. Bewahren Sie das empfindliche Rohmaterial bei der Herkunft, wenn die Untersuchung dies erfordert. Die Betriebsidentität sollte geschnitten werden, wenn die Absicht langlebig wird, nicht innerhalb der Wiederversuchsschleife. Zum Beispiel: Der Ausschnitt ist entworfen unvollständig: Eine Ausnahme zu fangen und fortzusetzen ist kein Beweis für die Sicherheit. Der Anrufer muss auch die zurückgegebene Objekt ID des Anbieters behalten oder den Anbieter nach einer zweideutigen Antwort mit derselben Geschäftsidentität abfragen. Zählen Sie einzigartige Effekte, nicht erfolgreiche Reaktionen. Zwei erfolgreiche Antworten, die beide ticket 908 bezeichnen, beschreiben einen Effekt. Ein Timeout, gefolgt von einem Erfolg mit den Namen delivery a und delivery b , beschreibt zwei Effekte. Umgekehrt beweisen keine Einnahmen null Effekte, wenn der Suchanlage nicht verfügbar ist. Dieser Zustand ist uncertain , nicht gesund und nicht automatisch stecken. Die Nutzlast Identität ist ein separates Tor. Wenn zwei Versuche einen Idempotency Schlüssel teilen, aber unterschiedliche kanonische Nutzlast Hashes haben, halten Sie vor der Interpretation der Effektzählung auf. Der Anrufer kann einen Schlüssel versehentlich nach Änderung der geforderten Region, Empfänger, Menge oder Ressourcenform wiederverwendet haben. Die Fehler der Anbieterseite im Zusammenhang mit Parameterunpassungen sind ein nützlicher Beweis für diesen genauen Fehler. Durchführung eines Vier Operations Effekt Audits Das für diesen Artikel verwendete überprüfbare Gerät ist NDJSON. Jede Linie ist entweder eine attempt Beobachtung oder eine effect Beobachtung. Das komplette lokale Artefakt enthält vier logische Operationen: op ticket 42 : Zwei Versuche teilen einen Schlüssel und eine Nutzlast; beide Beobachtungen weisen auf ticket 908 hin; op webhook 77 : Zwei Versuche haben keinen Idempotency Schlüssel und zeigen delivery a plus delivery b ; op vm 5 : zwei Versuche, einen Schlüssel mit unterschiedlichen Nutzlast Hashes zu wiederverwenden; op email 3 : Zwei Auszeitversuche, kein Effektreceit verfügbar, und der Anbieter hat keinen Suchweg. Die Prüfgruppen erfassen nach operationId , lehnen den Nutzlastdrift vor der Berechnung der Effekte ab und zählen unterschiedliche effectRef Werte anstelle von Wirkungsbeobachtungsreihen: Ausführung des Repository Artefakts: produziert: Drei Beobachtungen ändern die operative Entscheidung. Zunächst hat op ticket 42 zwei Versuchsregister und zwei Effektbeobachtungen, aber beide Beobachtungen lösen sich auf ein Anbieterobjekt. Eine Warnung auf Effektzeilen 1 wäre falsch positiv. Die stabile Anbieterreferenz ist das, was die Deduplikation beweist. Zweitens beinhaltet op webhook 77 einen erfolgreichen zweiten Versuch. Ein nur für den Transport verwendetes Dashboard könnte den Vorfall abschließen. Die beiden Effektreferenzen beweisen, dass die Wiederherstellung eine zweite Lieferung erzeugte, so dass der richtige Zustand doppelt ist und die nächste Aufgabe Versöhnung ist, nicht ein weiterer Versuch. Drittens hat op vm 5 keine doppelte Wirkung in der Anlage, ist aber immer noch unsicher. Der wiederverwendete Schlüssel deckt zwei verschiedene Nutzlast Hashes ab. Wenn man auf eine zweite Ressource wartet, wird das Problem zu spät erkannt werden; der Schlüsselkonflikt ist ein präventiver Gesundheitsversagen. Die Prüfung hat eine wichtige Begrenzung: Sie kann nur die vorgelegten Beweise klassifizieren. Für op email 3 lassen kein Quittungsantrag und kein Suchweg das Ergebnis unbekannt. Das Hauptbuch kann keine Gewissheit herstellen. Wiederversuche könnten fehlende Arbeiten oder duplizierte ausgeführte Arbeiten vollenden, so dass die begrenzte Reaktion ist, die Zweideutigkeit aufzutauchen und um Autorität zu bitten. Umsetzen Sie das Ergebnis in eine Wiederversuchsgrenze Verwenden Sie Klassifizierung, um die nächste Aktion zu steuern, nicht nur die Farbe eines Dashboards: Klassifizierung Beweise Sicherer Standard healthy Eine Nutzlast Identität und genau ein einzigartiger Effekt Beenden Sie die erneuten Versuche; überprüfen Sie die beabsichtigte Lieferleistung duplicate Mehr als ein einzigartiger Effekt für eine Operation Bündelversuche; mit Genehmigung zu vereinbaren oder zu kompensieren key conflict Ein Schlüssel, der an mehrere Nutzlast Hashes angeschlossen ist Block Ausführung; erst nach Überprüfung der Absicht eine neue Operation durchzuführen uncertain Keine Wirkungsbeweise und keine vertrauenswürdige Abwesenheitsbeweise Fragen Sie noch einmal, warten Sie auf neue Beweise oder fragen Sie einen Menschen Eine Frist ist noch nötig. Die Datensätze der Anbieter Idempotency können ablaufen, die Suchanzeigen können zurückbleiben und ein Ziel kann außerhalb der Transaktionsgrenze des Anbieters liegen. Speichern Sie die dokumentierte Aufbewahrung und den Umfang neben dem Schlüssel. Nach Ablauf dieser Grenze ist die gleiche Anfrage möglicherweise nicht mehr sicher, auch wenn sich der ursprüngliche Codeweg nicht geändert hat. Die Wiederherstellungsprüfung muss das ursprüngliche Ergebnis erreichen. Ein einziges Anbieterobjekt kann immer noch falsch sein: Ein Ticket kann mit dem falschen Projekt vorhanden sein oder eine Ressource kann erstellt werden, aber nie bereit sein. Die Einwirkungsinvariante verhindert Doppelungen; ein separater Ergebnisvertrag überprüft, ob der überlebende Effekt derjenige ist, den der Benutzer beabsichtigt. Für einen Einsatzgesundheitsbericht sollten fünf Fakten zusammengefasst werden: 1. der logische Betrieb und der Nutzlast Fingerabdruck; 2. die Versuche und deren Transportergebnisse; 3. der Umfang und die Frische der Unfähigkeit des Anbieters; 4. die beobachteten unterschiedlichen dauerhaften Wirkungen; 5. die Grenze der Behörde für erneute Versuche, Entschädigungen oder Versöhnung. Das macht den Erfolg des Rücktritts eher ein Beweis als das Urteil. Das gesündere Urteil ist eine beabsichtigte Wirkung besteht und wurde überprüft,oder wenn die Beweise unvollständig sind, die Wirkung ist unsicher; automatischer Neuerversuch wird blockiert. Sidewisp befindet sich derzeit in einer privaten Vorschauphase. Sein öffentliches Artikelsystem und die interaktive Produktdemonstration sind live, aber Produktionsagent Gesundheitssammlung, Laufzeitadapter, Cron Management, Token Kosten Analysen und Wiederherstellung werden im Allgemeinen nicht versandt. Die oben genannten Beispiele sind ein Betriebsmuster, nicht eine Behauptung, dass Sidewisp derzeit lebende Agenten kontrolliert oder repariert. Sidewisp ist keine Ersatzlaufzeit, kein obligatorisches Gateway, kein Roh Tracing Produkt, kein Unternehmenssteuerungsflugzeug oder ein autonomer Fixer. Wenn Ihnen eine Gesundheitsregel für die Wirkungsregister helfen würde, bestehende Agenten zu bedienen, sollten Sie sich der privaten Vorschau anschließen. Halten Sie die Hinrichtung dort, wo sie bereits läuft; Lassen Sie erneute Versuche ihre Sicherheit durch Beweise verdienen.