AI エージェント リトリエの観察性:重複効果を捕獲する

捜査官は ツール通話を タイムアウトで 追跡が終わると 再び 呼び出すべきではない. 要求はプロバイダーに届いたり,実際の状態が変更され,応答のみを失ったりします. 2度目の試みでは メッセージを2回送信したり 2つのチケットを作成したり 2つのリソースを提供したりできます 両方の痕跡が個別に合理的に見えます 有用な健康規則はより厳格である. oneの論理操作は, の検証された効果を1つ以上発生させてはならない. 操作に安定したアイデンティティを与え,そのアイデンティティを試行中でも保持し,プロバイダー側効果の受信を記録し,効果を安全に確認できないときに自動的に再試行をブロックします. 試算数とHTTPステータスは 診断に役立つが 結果は証明できない この記事では このルールを小さな効果本に組み込み 4 つの操作に対してテストします 装置には8つの試みと4つのプロバイダの観測が含まれています. 試行のみの政策は タイムアウトと 3つの操作を繰り返す. 効果を意識した監査は 1つの健康的な再演, 1つの重複効果の事件, 1つの無力性の鍵の衝突, 1つの正直に不確実な操作を見つけます タイムアウトは 何もなかった証拠ではない 危険な窓は 遠隔執行と 地元の承認の間にあります プロバイダーが 効果を起こし 返回する途中で 反応を失う可能性があります この2つの歴史は観察的に似ています 1. 要求は提供者に届かなかった. 2. 要求が完了したが,その返事は代理人に届かなかった. 最初の歴史だけが 安全で 再確認できます 2つ目は,操作が自然に無力でない場合,複製を作成します. HTTPセマンティックは有用な境界線を提供します. RFC 9110 は無力方法を定義するは,複数の同一の要求の後,意図されたサーバー効果が1回の要求後と同じである. idempotent の方法では通信失敗後自動的に繰り返すことができますが,クライアントは,操作が効果的に idempotent であることを知らず,またはオリジナルが適用されていないことを検出できない限り, idempotent の要求を自動的に再試してはならないと規定します. その区別は 代理人の健康に属します 既知のレコードを置き換える PUT とメールを送信する POST は両方ともタイムアウトできますが,同じリトリー境界はありません. 汎用的な タイムアウト →リトライ 政策は 最も重要な意味的な事実を消します 契約は正しく読めなければならない. ストライプ文書 は idempotency キーを用いて最初の要求の状態コードとボディを保存し,その結果を同じキーを用いて後の要求に返します. また,パラメータを比較し,異なるパラメータで再利用を拒否します. 鍵は,それぞれの試みに添付されたランダムなラベルではありません. 安定した論理的な操作を表します アマゾンEC2文書は,同じトークンとパラメータで成功した再試行により,変更されたパラメータが IdempotentParameterMismatch を生成する. EC2は地域や地域レベルでもいくつかの保証を対象としています. トークンを持っているだけでは不十分.健康記録にはトークンの範囲,ペイロードアイデンティティ,保存ウィンドウ,プロバイダの行動が必要です. 合理的なデフォルトは: すべての試みにおいて,同じ操作アイデンティティを再利用する. 提供者の idempotency キーを同じカノニカル 役に立たない負荷のためにのみ再利用する. 曖昧な結果の後,そのアイデンティティで再試する前に問い合わせする. 提供者が無効性も検索も提供しない場合,結果的な影響のために人間の決定を必要とする. バックオフは失敗したサービスへの圧力を軽減します それは無力な行動を無力な行動に変えることはありません. 記録効果 試みは限らない 普通の追跡結果は 代理人が何を試みたのか? 効果レジーは異なる質問に答えます 持続的な変化を証明できるのか? 試みは有用な証拠でありながらも,その試みの終末期をビジネス結果として扱わないため,両記録を結びつけましょう. 最小のレジは,これらのフィールドを必要とします. フィールド 目的 暴露する健康障害 operationId ユーザの意図された操作のための安定したアイデンティティ 新しいIDが生成され,再試しごとに attemptId 1回の輸送試みでの身分 失敗または重複した試み idempotencyKey 提供者のデプリケーションアイデンティティがサポートされている場合 復試中の主要な変更 payloadHash カノニカル・編集された用荷のハッシュ 同じ鍵が異なる目的で再利用される effectRef 実際の効果の提供者または目的地のアイデンティティ 1つ以上の耐久性効果 result timeout や success などの輸送観測 曖昧な承認 observedAt 証拠が収集された時 現状と誤った古い証拠 秘密,メールアドレス,完全なプロンプト,または原始ツール用荷をこれらのフィールドに入れないでください. 波動値を取り除いた後,カノニカル表示をハッシュする. 調査が要求するときに,敏感な原材料を原産地に置く. 操作のアイデンティティは,再試回路の中でではなく,意図が持続可能になるときに刻まれなければならない. 例えば: このスニペットは設計的に不完全です 例外を捕まえて継続することは安全性を証明するものではありません また,呼び出し者は,返品プロバイダのオブジェクトIDを保持するか,曖昧な応答の後,同じビジネスアイデンティティでプロバイダーに問い合わせなければならない. 成功する反応ではなく ユニークな効果を数える ticket 908 という2つの成功反応は,一つの効果を記述します. delivery a と delivery b と呼ばれる成功が続くタイムアウトは,2つの効果を記述します 逆に,検索チャネルが利用できない場合,ゼロの領収はゼロの効果を証明するものではありません. その状態は Uncertain , 健康ではないし,自動的に閉じ込められていない. パイロードのアイデンティティは別途ゲートです 2 つの試みは無効性キーを共有するが,異なるカノニカル用荷ハッシュを持っている場合,効果数値を解釈する前に停止します. 呼び出し者は,要求された領域,受信者,金額,またはリソースの形状を変更した後に,偶然に鍵を再利用した可能性があります. 提供者側のパラメータ不一致エラーは,この正確なエラーの有用な証拠です. 4つの操作効果監査を実行する この記事で使用される検査可能な装置はNDJSONです. 各線は attempt または effect 観測である. 完全な本地アーテファクトには 4つの論理的な操作が含まれています op ticket 42 : 2回の試みは1つの鍵と1つの役に立たない荷物を共有する.両方の観測は, ticket 908 を指している. op webhook 77 : 2回の試みは無効性キーを持ち, delivery a + delivery b を明らかにする. op vm 5 : 2 回,異なる用荷ハッシュで1 つのキーを再利用する試み op email 3 : 2回のタイムアウト試行,効果の領収書が利用できず,プロバイダは検索パスがありません. 監査グループでは, operationId によって記録され,効果を計算する前に有用な負荷の漂移を拒絶し,効果観察行ではなく,異なる effectRef 値を計算します. リポジトリのアーテファクトを実行する: 生産する: 3つの観測により,運用決定が変更されます. まず, op ticket 42 には2つの試行記録と2つの効果観測がありますが,両方の観測は,1 つのプロバイダーオブジェクトに解決します. 効果行 1に警告すると,偽陽性になります. 安定したプロバイダの参照は 倍増を証明するものです op webhook 77 は2度目の成功の試みを含んでいます 運輸専用のダッシュボードで 事件が終わります 2つの効果参照は 復元が2回目の配送を作り出したことを証明するので 正確な状態は重複であり 次のタスクは再試ではなく和解です 第三に, op vm 5 は固定装置に重複効果はないが,依然として危険である. 再利用された鍵は 2つの異なる用荷ハッシュをカバーします 2つ目の資源が登場するまで待つことは 問題を発見するのに遅すぎます 重要な紛争は予防的な健康障害です 監査には重要な制限がある: 提供された証拠のみを分類することができる. op email 3 については,領収書や検索経路は,結果が未知です. 本書は確実性を生み出せない. 再び試みると 欠けている作業を完成させたり 完成した作業を複製させたりするので 限られた反応は 曖昧さを表し 権威を求めることです 結果を再試の境界に変換する 次のアクションを制御するために分類を使用します. ダッシュボードの色だけではありません. 分類 証拠 安全なデフォルト healthy 1つの有用な負荷のアイデンティティと,正確に1つのユニークな効果 再試を停止し,意図された配達可能なものを確認する duplicate 1つの操作で1つ以上のユニークな効果 ブロックリトライ;承認で調和または補償する key conflict 複数の用荷ハッシュに接続された1つのキー ブロック実行;意図が検討された後のみ新しい操作を決定する uncertain 効果証明も,信頼性の高い欠席証明もない 再び質問,新しい証拠を待つ,または人間に尋ねる 時間制限はまだ必要だ. 提供者の無効性の記録が期限切れになり,検索インデックスが遅れており,目的地は提供者のトランザクション境界の外にある可能性があります. 文書保存と範囲を鍵の隣に保管する. その境界が終了した後,元のコードパスが変更されていない場合でも,同じ要求はもはや安全でない可能性があります. 復旧検証は,元の結果に達しなければならない. 単一のプロバイダーオブジェクトは依然として間違っている: チケットは間違ったプロジェクトで存在し,またはリソースが作成されても決して準備ができなくなる可能性があります. 単効果不変は複製を防ぐ.別々の結果契約は,生存効果がユーザが意図したものであることを確認する. 運用健康の見方については,5つの事実をまとめます. 1. 論理的な操作と有用な荷物の指紋 2. 試行事とその輸送結果 3. 提供者の無効性の範囲と新鮮さ 4. 観察された異なる耐久性効果 5. 再試,補償,または和解のための権限の境界線. 判決ではなく 証拠として 復讐が成功しました より健全な判断は 意図された効果が存在し,確認されているか,または証拠が不完全である場合, 効果は不確実であり,自動的に再試行がブロックされます. Sidewisp は現在プライベートプレビュー段階です。 公共の記事システムとインタラクティブな製品デモはライブですが,生産代理の健康収集,ランタイムアダプター,クロン管理,トークンコスト分析,リリカバリーは一般的に送付されません. 上記の例は,Sidewispが現在生体代理人を検査または修理しているという主張ではなく,動作パターンである. Sidewispは,代替実行時間,必須ゲートウェイ,原始追跡製品,企業制御機,または自動固定装置ではありません. 効果簿の健康規則が 既存のエージェントを操作するのに役立つなら プライベートプレビューに参加することを検討してください 執行を既に実行されている場所に留め 証拠を通して再試を安全にする